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.

Chartboost kurulumu

Chartboost, Adjust ile entegre bir reklam ağıdır. Entegrasyonumuz ile Chartboost, attribution ve uygulama içi event verilerini otomatik callback'ler ile alabilir.

Bu makalede, Chartboost ölçümlemesini uygulamanız için nasıl yapılandırabileceğinizi bulabilirsiniz. Buna entegrasyonu etkinleştirmek, bir kampanya linki oluşturmak ve Adjust'ın Chartboost ile hangi verileri paylaşabileceğini seçmek de dahildir.

Başlamadan önce

Gereklilikler

  • Adjust'ta Admin, Editör ya da Özel Editör izinlerine sahip olmak.
  • SDK parametrelerini Chartboost parametreleri ile eşleştirmek için Adjust SDK v4.0.0 ve üstü. Bu özelliği kullanmak için aşağıdaki rehberleri takip edebilirsiniz.

iOS | Android | Pencereler | Unity | React Native | Flutter | Adobe Air | Kordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Giriş bilgileri

APP ID ve APP SIGNATURE

  • Giriş bilgilerinizi bulmakta yardıma ihtiyacınız varsa Chartboost temsilcinizle iletişime geçin.

Campaign Lab'de Chartboost seçeneğini seçin ve uygulamanızı seçin

  1. Campaign Lab kısmında Partnerler seçeneğini seçin.
  2. Yeni partner > Chartboost seçeneğini seçin. İleri 'yi seçerek sonraki ekrana geçin.
  3. Uygulama seçimi ekranında linkini oluşturmak istediğiniz uygulamayı seçin ve Chartboost ile veri paylaşımı için entegrasyonu etkinleştirin.
  4. İleri 'yi seçin.

Veri paylaşımını etkinleştir

Chartboost entegrasyonu için veri paylaşımını etkinleştirin. Veri paylaşımını etkinleştirmek için:

  1. APP ID ve APP SIGNATURE 'larınızı girin.

Chartboost ile veri paylaşımını etkinleştirdiğinizde Adjust, varsayılan olarak aşağıdaki verileri Chartboost partnerine otomatik olarak gönderecektir:

  • Kurulum
  • session (oturum)
  • Reattribution
  • event
  • reddedilen kurulum

Veri paylaşımı seçeneklerinizi belirleyin

Veri paylaşımı birden fazla platformda etkin olan bir multi-platform uygulama ile çalışıyorsanız aşağıdakileri yapabilirsiniz:

  1. Platforma özgü ayarları kullan seçeneğini seçerek veri paylaşımı seçeneklerini platform seviyesinde ayırabilirsiniz.
  2. Birden fazla platformda aynı veri paylaşımı seçeneklerini kullanmak için Global ayarları kullan seçeneğini seçin.

Varsayılan olarak neler paylaşılır? kısmında Adjust'ın varsayılan olarak Chartboost ile paylaştığı aktiviteleri kontrol edebilirsiniz:

  • Kurulum
  • session (oturum)
  • Reattribution
  • event
  • reddedilen kurulum

Ek veriler göndermek

Chartboost ile callback'ler aracılığıyla paylaşmak istediğiniz veri miktarını ve türünü seçin. Chartboost, bu bilgileri performansı optimize etmek için kullanabilir.

  1. Hangi veri kaynaklarını paylaşmak istiyorsunuz? kısmında Chartboost ile paylaştığınız verilerin attribution kaynağını seçin:
  • Tüm attribution kaynaklarından gelen veriler
  • Sadece Chartboost ile attribute edilen veriler

Session'lar

Adjust, yüksek hacimli oturumlardan dolayı session callback'lerini otomatik olarak göndermez. Session'ları paylaştığınızda Chartboost uygulamanızın session aktivitesini alacaktır.

Uygulama-içi revenue (uygulama-içi alışverişlerden)

Uygulama-içi revenue paylaşımı ile Chartboost partnerinin revenue miktarlarını revenue event verileriniz ile birlikte almasını sağlayabilirsiniz. Bu verileri paylaşmak için revenue yaratan event'leri eşleştirmeniz gerekir.

Event eşleştirmesi

Paylaşmak istediğiniz event'leri Chartboost ürünlerinin alabileceği değerler ile eşleştirin. Eşleştirilmemiş event'lere dair veriler Chartboost ile paylaşılmaz.

Event'leri tekil eşleştirin

Multi-platform Uygulamanız varsa, Chartboost ile her platformda farklı event'leri paylaşmayı seçebilirsiniz. Bu size aşağıdaki imkanları sunar:

  • Her platformun kampanya stratejilerini yönetmek için tekil event'ler belirleyin.
  • Veri paylaşımını her platform için özelleştirin.

Event eşleştirmesi kısmında bu adımları takip ederek Chartboost partnerine doğrudan göndermek istediğiniz uygulama-içi event'leri seçin.

  1. Event eşleştirmesi 'ni seçin.

  2. Adjust event'i listesinde Chartboost ile paylaşmak istediğiniz Adjust event'ini seçin.

  3. Partner event'i altında Adjust event'ine karşılık gelen Chartboost event'ini seçmeniz gerekir.

    1. Veri paylaşımının tek bir platformda etkinleştirildiği tek platformlu uygulamalar ve multi-platform uygulamalar için, sadece o platforma dair veri paylaşım seçeneklerini belirleyebilirsiniz. Veri paylaşımı birden fazla platformda etkin olan multi-platform uygulamalar için aşağıdakileri yapabilirsiniz:

      • Ayrı event'leri platform seviyesinde eşleştirmek için ya da event'leri belli platformların eşleştirmesini yapmamak için Platforma özgü eşleştirmeyi kullan seçeneğini seçin.
      • Tüm platformlar için aynı event'leri eşleştirmek için Global eşleştirmeyi kullan seçeneğini seçin.

    2. Partner event'i listesinde Adjust event'i ile eşleştirmek istediğiniz özel event adını girin ya da bir özel event seçin.

  4. Uygula 'yı seçin.

Chartboost artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.

Tüm event'leri eşleştir

Chartboost, tüm event'lerin otomatik olarak eşleştirilmesini destekliyorsa, Event'leri eşleştir kısmında Tüm event'leri eşleştir seçeneğini seçin. Bu, event'leri tekil eşleştirirken zamandan tasarruf etmenizi sağlar.

Chartboost artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.

Parametreleri eşleştirmek

Özel verileri Chartboost ile paylaşmak için genellikle parametreleri eşleştirmeniz gerekir.

Partner parametreleri (Adjust SDK sürüm 4.0 ve üstü), Adjust'ın özelleştirilmiş veri noktalarını uygulamanızdan alıp Chartboost'e göndermesini sağlar. Bu, Chartboost partnerinin bağlı event'lerinizin her biri için özel event detaylarını almasını sağlar.

Yeni partner parametrelerini Adjust SDK'ya eklemeden önce gereksinimlerinizi karşılayan mevcut partner parametrelerinin olmadığını kontrol edin.

Partner parametrelerini Chartboost ile paylaşmak için bu adımları takip edin.

  1. Adjust SDK içindeki partner parametrelerini ayarlayın.

  2. Veri paylaşımı seçeneklerinizi belirleyin altından Parametreler seçimini yapın.

  3. Parametre eşleştirmesi 'nin altında, SDK'da tanımlanan partner parametrelerini ağa nasıl göndermek istediğinizi belirleyebilirsiniz:

    1. Parametre eşleştirmesi 'ni seçin.
    2. SDK parametresi alanına ağ ile paylaşmak istediğiniz SDK parametresinin adını girin.
    3. Partner parametresi alanına SDK parametresine karşılık gelen ağ parametresini girin.
Not:

Partner parametrelerini Adjust SDK'da dashboard'daki parametre paylaşımını yapılandırmadan yapılandırırsanız Adjust, parametreleri Adjust SDK'daki isimleri ile gönderir.

Linkinizi ve ayarlarınızı yapılandırın

Ayar yapabilecekleriniz:

Linkinizi oluşturun ve Chartboost ile paylaşın

Yaptığınız seçimleri Yapılandırma kontrolü ekranında kontrol edin. Bu noktada geri dönebilir ve aşağıdakilerde değişiklik yapabilirsiniz:

  • Seçtiğiniz uygulama
  • Veri paylaşımı seçenekleri
  • Link yapısı parametreleri
  • Kullanıcı hedefleri
  • Attribution ayarları

Tıklama URL'ini, gösterim URL'ini, QR kodunu ve link token'ınızı oluşturmak için Link oluştur 'u seçin. Bir link oluşturmak aynı zamanda veri paylaşımını ve Chartboost ile entegrasyon da sağlar.

Linkinizi oluşturduktan sonra kampanyalarınızda kullanmaları için Chartboost ile paylaşın.

Partnerlere özgü yapılandırma yönergeleri

Chartboost, oyun odaklı bir performans ağıdır. Adjust, Chartboost entegrasyonunu iki şekilde yapar:

  • Session, install, reattribution and reddedilen install callback'leri: Adjust tüm kullanıcı session'larının yanında install'ların, reddedilen install'ları ve attribution'ı yapılmış reattribution'ları Chartboost'a raporlar. Bu callback'ler, Chartboost ağında S2S takibinde kullanılır.
  • Event (ya da post-install ) callback'leri: Adjust, uygulama içi alışverişleri Chartboost'a raporlar ve böylece geliştiriciler verileri görselleştirerek Chartboost kampanyalarını optimize edebilirler.

Chartboost modülünü etkinleştirmek için, oyununuzun Chartboost app ID'sini ve uygulama imzasını eklemeniz gerekir. Bunları burada bulabilirsiniz. Session callback'lerini göndermeye başlamak için, Session Yönlendirmesi anahtarını AÇIK konuma getirin. Chartboost ağında optimum kampanya performansı için Session Yönlendirmesinin nin AÇIK olması gerektiğini lütfen unutmayın. Event callback'lerini etkinleştirmek için Chartboost'un almasını istediğiniz her Purchase event'i için bir Event label'ı girin. Modül anahtarını açarak Revenue Yönlendirmesini etkinleştirin.

Ön tanımlı parametreler

Chartboost ile bir ön tanımlı parametre seti gönderebilirsiniz. Bu parametrelerden herhangi birini Adjust SDK'nızdaki bir event'e eklediğinizde, bunlar Chartboost'a gönderilir. Partner parametreleri eklemek hakkında daha fazla bilgi için, kullandığınız SDK için spesifik SDK readme dosyasına göz atın. Chartboost'un kabul ettiği tanımlanmış parametrelerin listesini aşağıda bulabilirsiniz:

Parameter key> Value

purchase> Bu, event adıdır. "purchase" girin ve diğer TÜM alanları boş bırakın.

Chartboost tıklamalarının senkronizasyonu

Chartboost UI'ındaki tıklama callback'leri yapılandırması makro kullanmaz, bunun yerine Chartboost dashboard'unuzda bir parametre listesi oluşturmanız gerekir. Aşağıdaki ekran görüntüsü iOS içindir. Tıklama callback'leri kurulumunu Chartboost dokümantasyonunda görebilirsiniz.

Chartboost partnerine yönlendirilen tüm parametrelerin listesi

Chartboost, Adjust'ın bu parametreleri (veri noktaları) callback'ler ile birlikte göndermesini gerektirir:

PlaceholderBilgi
{android_id}Android ID (sadece Android)
{fire_adid}Fire OS reklam tanımlayıcısı
{gps_adid_md5}Google Play Store reklam ID'sinin küçük harflerle hex MD5 hash'i
{idfa}ID for advertisers (sadece iOS)
{app_id}Store App ID ya da Google Play Store
{app_version}Uygulama versiyon numarası (Android), bundle için build versiyonu numarası (iOS)
{network_name}Ağ adı, tracker'dan alındığı gibi
{rejection_reason}Attribution'ın reddedilme nedeni