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.

Unity Ads kurulumu

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

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

GAME ID

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

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

Veri paylaşımını etkinleştir

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

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

Unity Ads ile veri paylaşımını etkinleştirdiğinizde Adjust, varsayılan olarak aşağıdaki verileri Unity Ads 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 Unity Ads ile paylaştığı aktiviteleri kontrol edebilirsiniz:

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

Ek veriler göndermek

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

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

Ad revenue (reklam gösterimlerinden)

Ad revenue paylaşımı, Unity Ads tarafından kullanıcı ad revenue verilerini almasını sağlar. Bu sayede Unity Ads, 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 Unity Ads 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 Unity Ads uygulamanızın session aktivitesini alacaktır.

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

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

Event'leri tekil eşleştirin

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

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

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

Tüm event'leri eşleştir

Unity Ads, 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.

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

Parametreleri eşleştirmek

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

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

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

Unity Ads platformundan game_id'leri içeren ajans hesaplarına dair kullanım senaryolarını desteklemek için bu adımları takip edin:

Bir ajansın game_id'si abcde ise, Adjust tracker URL'ine &unityads_game_id=abcde eklediğinizde Adjust, Unity Ads'e abcde game_id'sine sahip bir attributed callback gönderecektir.

Unity Ads partnerine yönlendirilen tüm parametrelerin listesi

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

PlaceholderBilgi
{android_id_md5}Küçük harflerle Android ID hex MD5 hash
{android_id}Android ID (sadece Android)
{api_level}API seviyesi (sadece Android)
{country}Cihazın iki karakterlik ülke kodu
{currency}Adjust SDK'dan gönderilen Orijinal ISO 4217 para birimi kodu
{device_name}Cihaz modeli numarası
{device_type}Cihaz Tipi
{idfa||gps_adid}IDFA ya da IDFA boşsa GPS ADID
{ip_address}Cihazın IP adresi
{is_reattributed}Kullanıcı daha önceki bir kaynaktan en az bir kere reattribute edildiyse 1. Kullanıcı daha önce hiç reattribute edilmediyse 0.
{language}Cihazın iki karakterlik dil kodu
{match_type}attribution metodu
{os_name}Cihazın işletim sistemi
{os_version}İşletim sistemi versiyonu numarası
{revenue_float}Revenue, Adjust SDK'dan gönderildiği gibi tam para birimlerinde
{revenue_usd}Revenue, ABD doları cinsinden
{tracking_enabled}Takip etkinse 1, değilse 0
{user_agent}Gelen ham user agent
{app_id}Store App ID ya da Google Play Store
{app_name_dashboard}Uygulamanın Adjust dashboard'undaki adı
{app_name}Uygulamanın adı
{app_version_raw}Uygulama versiyon numarası (Android), bundle için build versiyonu numarası (iOS)
{app_version}Uygulama versiyon numarası (Android), bundle için build versiyonu numarası (iOS)
{click_time}Attribute edilmiş tıklama timestamp'i
{connection_type}Internet bağlantı türü
{created_at}Aktivite timestamp'i
{fingerprint_attribution_window}Cihaz fingerprinting'i için attribution penceresi ayarı (saat cinsinden)
{impression_based}Gösterim bazlı etkileşim ise 1, değilse 0
{is_organic}Organikse 1, organik değilse 0
{rejection_reason}Attribution'ın reddedilme nedeni
{ad_impressions_count}Son kullanıcılara servis edilen mobil reklam sayısı
{ad_revenue_network}Reklamı görüntüleyen reklam ağı
{ad_revenue_unit}Revenue oluşturan reklam birimi
{ad_revenue_placement}Platformda tanımlandığı gibi kullanıcı placement'ı
{ad_mediation_platform}Aracı platform adı
{ad_revenue_payload}JSON olarak gösterim seviyesi revenue verileri (ILRD)