Dokümantasyonumuzu sürekli güncel tutuyoruz, ancak bazı güncellemeler henüz tüm dillerde yayınlanmamış olabilir. En güncel bilgiler için lütfen İngilizce versiyonuna göz atın.

Adjust geçiş rehberi

Başka bir mobil ölçümleme partnerinden Adjust'a geçiş kolay bir süreçtir. Adjust, bu geçişin her adımında destek, rehberlik ve zengin bir dokümantasyon sunar.

Adjust'a başka bir MMP'den geçerken takip etmeniz adımları gösteren bir infografik.

Aşağıdaki geçiş süreçlerini tamamlamak için bu rehberdeki adımları takip edin:

Not:
Planınıza özel destek dahilse SDK entegrasyonu, UA yapılandırması, verilerin dışa aktarımı/BI, Datascape/veri analizi ve iOS kampanya yapılandırmasına dair workshop'larımıza katılabilirsiniz.

1. Uygulamanızı Adjust'ta yapılandırın

Geçmiş verilerinizi aktarmadan önce uygulamanızı AppView'da yapılandırmanız gerekir. Tüm geçmiş verileriniz Adjust app token 'ınıza göre aktarılır.

  1. Uygulama yapılandırması rehberimizdeki yönergeleri takip edin.
  2. Uygulamanızı yapılandırdıktan sonra app token 'ınızı kopyalayın.

2. Adjust SDK'yı entegre edin ve testlerini yapın

Dikkat:
Uygulamanızı bir app store'a göndermeden önce Adjust'ın veri aktarımınızı tamamlamasını bekleyin. Uygulamanızı aktarım tamamlanmadan gönderirseniz Adjust, mevcut kullanıcıları yeni kullanıcılar olarak kaydedecektir.

SDK dokümantasyonunu yardım merkezimizin Geliştirici bölümünde bulabilirsiniz. Adjust SDK'yı uygulamanıza entegre ederken, SDK'nın sandbox modunda olduğundan ve en yüksek seviyede bilgi sağlaması için log'ların verbose modunda olduğundan emin olun. SDK entegrasyonuna dair herhangi bir sorunuz olursa lütfen Adjust temsilciniz ile ya da support@adjust.com adresi ile iletişime geçin.

Adjust, testlerin en kolay şekilde yapılması için bir test konsolu ve Device API sunar. Bu araçlar ile SDK'nın Adjust sunucularına gönderdiği verileri analiz edebilirsiniz.

3. Geçmiş verilerinizi dışa aktarın

Uygulamanızı ve AppView'da yapılandırdıktan sonra geçmiş verilerinizi içeren bir aktarım dosyası oluşturmanız gerekir. Bilgileri önceki Mobil Ölçümleme Partnerinizden veya BI sisteminizden dışa aktarın ve dosyanızın formatını aşağıdaki şekilde yapın.

Dosya formatı

Dosyanız bu gereksinimleri karşılayan bir CSV (Comma Separated Values) dosyası olmalıdır:

  • UTF-8 kodlu.
  • Virgüller ile ayrılmış şekilde
  • Qualifier'lar. Çift tırnak ile (") ayrılmış şekilde.

Dosya ismi

CSV dosyanızın adı, aşağıdaki bilgileri küçük harflerle içermelidir:

  1. 1. adımda kaydettiğiniz app token
  2. Hedef işletim sisteminin adı (örneğin ios ya da android).
  3. Dosyanızdaki cihaz ID'si türü.

Her cihaz ID'si türü için bir dosya sağlamalısınız.

<app_token>_<os_name>_<device_id_type>.csv

Cihaz ID'si türleri

Bu cihaz ID'si türlerini kullanabilirsiniz:

iOS için:

  • IDFA
  • IDFV

Google Play Store 'u hedefleyen Android cihazlar için:

  • gps_adid
  • android_id

Amazon Appstore 'u hedefleyen Android cihazlar için:

  • fire_adid
  • android_id

Örnek

Aşağıdaki özelliklere sahip veriler için kullanmanız gereken dosya adına dair bir örnek:

  1. Adjust app tokenabc123 olan bir uygulama.
  2. Android cihazlar için.
  3. gps_adid cihaz ID'si türü ile tanımlanır.
abc123_android_gps_adid.csv

Alanlar

Önemli:
CSV dosyanızdaki tüm çift tırnaklar ( ") escape'li (kaçış karakteri) olmalıdır. Bunun için çift tırnaklı alanları bir çift tırnak çifti içerisine daha almalısınız: örneğin ""High spenders""

CSV dosyanız aşağıdaki alanları bu sırayla içermelidir:

AlanGerekli ya da opsiyonelÖrnek değerNotlar
device_idGerekliB1CDA5FE-BEBA-48ED-AD0F-27AE62BF82D8Çizgiler opsiyoneldir. Kabul edilen device_id türleri:
  • android_id (case-insensitive)
  • external_device_id (case-sensitive)
  • gps_adid (Google Advertising ID, büyük/küçük harflere duyarsız)
  • fire_adid (case-insensitive)
  • idfa (case-insensitive)
  • idfv (case-insensitive)
created_atOpsiyonel1586391845Bir tam sayı olarak Unix install timestamp'i, saniye olarak belirtilir. Aktarım dosyasında bu alan doldurulmazsa, değer otomatik olarak aktarımın timestamp'i ile doldurulur.
Gerekliİçe Aktarılan Cihazlarİçe aktarılan veriler, canlı Adjust veri setleriyle karışmaması için ayrı bir ağa yerleştirilmelidir. Bu bilgilerin yapısına dair daha fazla bilgi için ağ eşleştirmesi tablosu makalemize göz atabilirsiniz.
KampanyaOpsiyonelironSource
AdgroupOpsiyonelironsource_ios_us
KreatifOpsiyonelAdgroup 1

Bir ya da daha fazla opsiyonel alan için bilginiz yoksa, boş bir alan girin. Her satırdaki alan sayısı, header satırıyla aynı sayıda olmalıdır.

Ağ eşleştirmesi

Adjust, uygulamanız ilk kez açılır açılmaz install'ları takip etmeye başlar. Mevcut bir kullanıcı, uygulamanızı Adjust SDK entegre edildikten sonra açarsa bu bir install olarak sayılır ve install tarihi kaydedilir. Yani, içe aktarım dosyanızda bir ağın gerçek adını kullanırsanız, install event'leri aslında mevcut kullanıcılardan gelse bile bu ağ ile ilişkili yeni install'larda ani bir artış görebilirsiniz.

Bu sorunun önüne geçmek için geçmiş verilerinizi "Aktarılan cihazlar" adlı bir placeholder ağa aktarın. Bu sayede geçmiş verilerinizi canlı Adjust verilerinizden ayrı tutabilir ve her ağın performansını doğru bir şekilde görebilirsiniz. Ayrıntı seviyesini korumak için her ağ alanını bu şekilde eşleştirmelisiniz:

Önceki sistem değeriAdjust aktarım CSV değeriNotlar
Bu değeri "Aktarılan cihazlar" placeholder ağına hardcode'layın.
Ağ adıKampanya
Kampanya adıAdgroup
Adgroup adıKreatif

Bu yapı ile, mevcut kampanya verilerinizde üç alt seviyeye kadar detaya inebilirsiniz.

Örnek

Başlık satırı ve değer şablonu:

device_id,created_at,network,campaign,adgroup,creative
<device_id>,<created_at>,Imported Devices,<network>,<campaign>,<adgroup>

<device_id>, <created_at>, <network>, <campaign>, ve <adgroup> alanlarını önceki sisteminizdeki değerler ile doldurun. Örneğin:

device_id,created_at,network,campaign,adgroup,creative
B1CDA5FE-BEBA-48ED-AD0F-27AE62BF82D8,1586391845,Imported Devices,ironsource,ironsource_ios_us,Ad Group 1

4. Verilerinizi Adjust'a taşıyın

Verilerinizi dışa aktardıktan ve dosyaların yukarıdaki kriterleri karşıladığını doğruladıktan sonra, dosyaları güvenli bir yere yükleyin ve Adjust temsilcinize gönderin. Adjust'ın teknik ekibi, CSV dosyalarınızın içe aktarımını yapar ve her şeyin doğru olduğundan emin olmak için verileri kontrol eder. Aktarım süreci tamamlandığında Adjust temsilciniz sizi bilgilendirecektir.

Not:
İçe aktarılan kullanıcılar Datascape raporlamasında otomatik olarak görüntülenmezler. Adjust SDK'yı içeren bir güncelleme yayınlandıktan sonra uygulamanızda bir session başlattıklarında görüntülenirler.

5. Uygulamanızı yayınlayın

Geliştiricileriniz SDK'yı entegre ettiklerini doğruladığında ve Adjust temsilciniz verilerinizin içe aktarımını onayladığında, uygulamanızın yeni bir versiyonunu app store'a gönderebilirsiniz. Mevcut kullanıcıların ve yeni install'ların olması gerektiği gibi kaydedildiğinden emin olmak için uygulama istatistiklerinizi kontrol edin.

6. Kampanyalarınızı oluşturun

Kampanyalarınızı ağ partnerleri ve kendi attribution'ını yapan ağlar ile oluşturmak için kampanya yapılandırması rehberlerimizi kullanabilirsiniz. Kampanyalarınızı oluştururken desteğe ihtiyacınız olursa partnerlerinizin bir listesini Adjust temsilcinize verin.

Planınıza özel destek dahilse, Adjust temsilciniz size aşağıdakilere dair bir workshop sunacaktır:

  • Kaydedebileceğiniz kampanya türleri
  • Alabileceğiniz bilgi seviyeleri
  • Kampanya link'lerinin oluşturulması
  • Adjust'ın attribution metodolojisi
  • iOS 14+ kampanyalarının yapılandırması

Bu workshop'ın ardından, kampanya konfigürasyonu için ağ partnerlerinizle iletişime geçebilirsiniz.

7. Kampanya link'lerinizi güncelleyin

Not:
Uygulamanızın Adjust SDK'nın entegre versiyonu App store'da yayınlanana kadar, ağlar teste başlamamalıdır.

Kampanyalarınızı yapılandırdıktan sonra Adjust kampanya linklerinizi ağ partnerlerinize yeni link'leri test etmeleri ve ayarlarını güncellemeleri için gönderebilirsiniz.

8. Yeni Adjust Suite'i keşfedin

Bu kadar! Artık yeni Adjust Suite'i kullanmaya başlayabilirsiniz. Yardım merkezimizde bu makalelere göz atmadan geçmeyin:

Herhangi bir desteğe ya da tavsiyeye ihtiyacınız olduğunda hesap yöneticinizle ya da support@adjust.com adresi ile iletişime geçmekten çekinmeyin.