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.

Tapjoy kurulumu

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

Bu makalede, Tapjoy ö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 Tapjoy 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 Tapjoy 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

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

Campaign Lab'de Tapjoy 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 > Tapjoy 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 Tapjoy ile veri paylaşımı için entegrasyonu etkinleştirin.
  4. İleri 'yi seçin.

Veri paylaşımını etkinleştir

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

  1. APP ID 'ınızı girin.

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

  • install
  • session
  • event
  • rejectedInstall
  • ad revenue

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 Tapjoy ile paylaştığı aktiviteleri kontrol edebilirsiniz:

  • install
  • session
  • event
  • rejectedInstall
  • ad revenue

Ek veriler göndermek

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

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

Ad revenue (reklam gösterimlerinden)

Ad revenue paylaşımı, Tapjoy tarafından kullanıcı ad revenue verilerini almasını sağlar. Bu sayede Tapjoy, ad revenue verilerini kullanıcı hedeflemesini ve kampanyaları optimize etmek için kullanabilir.

Büyüme Çözümü:

Bu özellik, Adjust'ın Ad Revenue paketi ile kullanılabilir. Ad Revenue paketimizi satın almak için satış temsilcimiz ile iletişime geçin.

Ad revenue bilgisini Tapjoy ile paylaşmak için bir ya da birden fazla Ad Revenue Kaynağı seçin.

  • Bu alan boş bırakıldığında, tüm entegre aracı kaynaklardan gelen Ad Revenue verileri gönderilir.

Session'lar

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

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

Uygulama-içi revenue paylaşımı ile Tapjoy 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 Tapjoy ürünlerinin alabileceği değerler ile eşleştirin. Eşleştirilmemiş event'lere dair veriler Tapjoy ile paylaşılmaz.

Event'leri tekil eşleştirin

Multi-platform Uygulamanız varsa, Tapjoy 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 Tapjoy 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 Tapjoy ile paylaşmak istediğiniz Adjust event'ini seçin.

  3. Partner event'i altında Adjust event'ine karşılık gelen Tapjoy 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.

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

Tüm event'leri eşleştir

Tapjoy, 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.

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

Parametreleri eşleştirmek

Özel verileri Tapjoy 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 Tapjoy'e göndermesini sağlar. Bu, Tapjoy 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 Tapjoy 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 Tapjoy 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 Tapjoy ile entegrasyon da sağlar.

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

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

Tapjoy'a sadece attribution'ı yapılmış trafiği göndermek istiyorsanız, ilgili anahtarı kullanabilirsiniz. Bunun sadece Tapjoy'a gönderilen aktiviteler için geçerli olduğunu unutmayın.

Lütfen event isimlerindeki Tapjoy App ID'nin ve Engagement ID'nin aşağıdaki formatta olması gerektiğini unutmayın:

  1. 8 karakterin ardından bir çizgi, ardından bir çizgi ile ayrılmış 4 karakterlik üç set ve ardından son 12 karakter gelir.
  2. Bütün karakterler hexadecimal olmalıdır. Örnek bir değer: c8196876-64ef-4fab-bed6-c9306fe35b05

Buna ek olarak, IDFA boş olduğunda Adjust'ın Tapjoy'a callback göndermeyeceğini unutmayın. Bu genel olarak IDFA'lerinin sıfırlardan oluştuğu iOS LAT kullanıcıları ile ilgilidir.

Tapjoy partnerine yönlendirilen tüm parametrelerin listesi

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

PlaceholderInformation
{adid}Adjust device ID (all platforms)
{android_id}Android ID (Android only)
{click_attribution_window}Attribution window settings for device matching (hours)
{country}Device two-character country code
{currency}Original ISO 4217 currency code sent from Adjust SDK
{device_name}Device model number
{device_type}Device type
{idfa||gps_adid}IDFA, or GPS ADID if IDFA is empty
{impression_attribution_window}Attribution window settings for impression matching (hours)
{ip_address}Device IP address
{label}Value of the Adjust "label" parameter sent on click
{language}Device two-character language code
{mac_sha1}Uppercase MAC SHA-1 hash
{match_type}Attribution method
{mcc}Mobile country code: three-digit code identifying a device's country. Use with the mobile network code to identify a device's carrier.
{mnc}Mobile network code: two-digit code. Use with the mobile country code to identify a device's carrier.
{os_name}Device operating system
{os_version}Operating system version number
{partner_parameters}Custom partner parameters collected by the Adjust SDK or S2S request and transmitted to third party providers via postbacks
{revenue}Revenue, as sent from Adjust SDK in cents
{sdk_version}Adjust SDK version (per app)
{timezone}Device time zone
{tracking_limited}1 if tracking is limited, 0 if not
{user_agent}Incoming raw user agent
{activity_kind}Type of user activity
{app_id}Store App ID or Google Play Store
{app_name}Name of the app
{app_version_short}App version number (Android), release-version-number for the bundle (iOS)
{app_version}App version number (Android), build-version-number for the bundle (iOS)
{click_time}Attributed click timestamp
{connection_type}Internet connection type
{cpu_type}CPU type
{created_at}Activity timestamp
{hardware_name}Hardware name
{impression_based}1 if impression-based engagement, 0 if not
{install_begin_time}App download began timestamp (Android and Google Play Store only)
{install_finish_time}App download completion timestamp
{referral_time}User landed on app Play Store page timestamp (Android and Google Play Store only)
{rejection_reason}Reason for a rejected attribution
{ad_revenue_network}Ad network that displayed the ad
{ad_revenue_unit}Ad unit that generated the revenue
{ad_revenue_payload}Impression-level revenue data (ILRD) as a JSON