Tapjoy'u uyumlulaştırma ile entegre etme

Bu kılavuzda, uyumlulaştırma özelliğini kullanarak Tapjoy'dan reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu konu, hem teklifli sistem hem de şelale entegrasyonlarını kapsar. Bu kılavuzda, Tapjoy'un reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Tapjoy SDK ile bağdaştırıcının bir Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Tapjoy'un AdMob uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif
Şelale
Formatlar
Banner
Geçişli
Ödül olarak verildi

Koşullar

  • Unity 4 veya üzeri
  • En son Google Mobile Ads SDK'sı
  • [Teklifli sistem için]: Tapjoy 2.3.0 veya sonraki sürümler için Google Mobil Reklamlar uyumlulaştırma eklentisi (en son sürüm önerilir)
  • Android'de dağıtmak için
    • Android API düzeyi 19 veya üstü
  • iOS'te dağıtmak için
    • 12.0 veya üstü iOS dağıtım hedefi
  • Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Unity projesi. Ayrıntılar için Başlarken bölümüne bakın.
  • Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu

1. Adım: Tapjoy kullanıcı arayüzünde yapılandırmaları ayarlayın

Tapjoy kontrol panelinize kaydolun veya giriş yapın.

Uygulama ekle

Sağ üstteki uygulama listesine gidip Uygulama Ekle düğmesini tıklayarak uygulamanızı Tapjoy kontrol paneline ekleyin. Ardından, uygulamanızla ilgili ayrıntıları girmeniz istenir.

Formu doldurun ve uygulamanızı Tapjoy kontrol paneline eklemek için Şimdi Oluştur düğmesini tıklayın.

Tapjoy'un sunduğu entegrasyon adımlarını atlayıp AdMob uyumlulaştırma ile kullanılacak yerleşimler oluşturmaya geçebilirsiniz.

Uygulamanız her iki platformu da destekliyorsa platform olarak Her ikisi'ni seçin.

Android

iOS

Yerleşim, sanal para birimi ve içerik

Yerleşim

Para Kazanma > Yerleşimler'e gidin ve sağ üst köşedeki Yerleşim Oluştur düğmesini tıklayın. Mevcut bir yerleşiminiz olsa bile, ayrı olarak izlenebilmesi ve raporlanabilmesi için AdMob için yeni bir yerleşim oluşturmak en iyisidir.

Yerleşiminiz için bir Ad girin, Uyumlulaştırma onay kutusunu işaretleyin ve açılır listeden AdMob'u seçin. İşiniz bittiğinde Oluştur'u tıklayın.

Buraya girilen Yerleşim Adı bir sonraki bölümde uyumlulaştırma için AdMob Reklam Biriminizi ayarlamak amacıyla kullanılır. Bu örnekte "AdMob Uyumlulaştırma" kullanılmıştır, ancak yerleşiminizi istediğiniz gibi çağırabilirsiniz.

Sanal para birimi

Para Kazanma > Sanal Para Birimi'ne gidin ve sağ üst köşedeki Sanal Para Birimi Oluştur düğmesini tıklayın.

Formu doldurun ve Şimdi oluştur'u tıklayın. Geri çağırma URL'si olarak NO_CALLBACK işlevini kullanın. Bu, Tapjoy SDK'nın sunucunuza gereksiz bir çağrı yapılmasını önlemesini sağlar.

Para birimi değeri ve adı Tapjoy adaptörü tarafından yönlendirilmez. Bu nedenle, para birimi adınız ve tutarınız için genel değerler seçilebilir.

Android

iOS

İçerik

Yerleşimlerle birlikte gösterilecek içerik oluşturmak için Para Kazanma > İçerik Oluştur'a gidin.

İçerik oluşturmayla ilgili ek talimatlar için, tercih ettiğiniz reklam biçimine karşılık gelen sekmeyi seçin:

Teklif

Geçişli

Programatik Geçiş Video içeriği için Oluştur düğmesini tıklayın. İçerik için bir Ad girin ve Platformunuzu seçin. * {Android} * {iOS} Daha önce oluşturduğunuz sanal para birimini Sanal Para Birimi olarak seçin. Daha önce oluşturulan geçiş reklamı yerleşimini seçin. İçeriğinizi oluşturmayı bitirdiğinizde alttaki Kaydet düğmesini tıklayın.

Ödül olarak verildi

Programatik Ödüllü Video içeriği için Oluştur düğmesini tıklayın. * {Android} * {iOS} Daha önce oluşturduğunuz sanal para birimini Sanal Para Birimi olarak seçin. Daha önce oluşturulan Ödüllü yerleşimi seçin. İçeriğinizi oluşturmayı bitirdiğinizde alttaki Kaydet düğmesini tıklayın.

Şelale

Geçişli

Geçiş Reklamı Video içeriği için Oluştur düğmesini tıklayın. İçerik için bir Ad girin ve Platformunuzu seçin. * {Android} * {iOS} Daha önce oluşturduğunuz sanal para birimini Sanal Para Birimi olarak seçin. Daha önce oluşturulan geçiş reklamı yerleşimini seçin. İçeriğinizi oluşturmayı bitirdiğinizde alttaki Kaydet düğmesini tıklayın.

Ödül olarak verildi

Ödüllü Video içeriği için Oluştur düğmesini tıklayın. İçerik için bir Ad girin ve Platformunuzu seçin. * {Android} * {iOS} Daha önce oluşturduğunuz sanal para birimini Sanal Para Birimi olarak seçin. Daha önce oluşturulan Ödüllü yerleşimi seçin. İçeriğinizi oluşturmayı bitirdiğinizde alttaki Kaydet düğmesini tıklayın.

SDK Anahtarını Bulma

Reklam biriminizi oluşturmak için Yerleşim Adına ek olarak SDK Anahtarı da gerekir. AdMob

Ayarlar > Uygulama Ayarları'na gidin. SDK Anahtarınızı Uygulama Platformları sekmesinin altındaki Uygulama Bilgilerinizden edinebilirsiniz.

Android

iOS

Raporlama anahtarlarını bulma

Teklif

Bu adım, teklif entegrasyonları için gerekli değildir.

Şelale

Devam etmek için Yayıncı OAuth Anahtarınız ve Uyumlulaştırma Anahtarınız gereklidir. Yayıncı OAuth Anahtarınıza API Anahtarları sekmesi altından aynı sayfadan ulaşabilirsiniz.

Uyumlulaştırma Anahtarınıza, aynı sayfada Raporlama API'sı Anahtarı sütunundaki Uyumlulaştırma Anahtarları sekmesinden ulaşabilirsiniz. Anahtar "AdMob" olarak etiketlenmiştir.

Test modunu aç

Test reklamları, Ayarlar > Uygulama Ayarları > Test Cihazları altındaki Tapjoy kontrol panelinde etkinleştirilebilir. Cihazın Reklam Kimliği'ni kullanarak yeni bir test cihazı oluşturun:

Android

Cihazınızın Reklam Kimliği'ni, cihazınızın Ayarlar bölümünde Google > Reklamlar'a giderek bulabilirsiniz.

iOS

Cihazınızın reklam kimliğini almak için aşağıdaki kodu uygulamanıza ekleyin. Aşağıdaki kodu kullanmadan önce AdSupport çerçevesini uygulamanıza aktardığınızdan emin olun.

Swift

let advertisingId: String = ASIdentifierManager.shared().advertisingIdentifier.uuidString
print("Advertising ID: \(advertisingId)")

Objective-C

NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"Advertising ID: %@", advertisingId);

Ardından, daha önce oluşturduğunuz içeriği değiştirin.

İçeriğinizi değiştirmek için önce Para Kazanma > Yerleşimler'e gidin ve Kullanıcı Tarafından Başlatılan sekmesini tıklayın. Daha sonra, düzenlemek istediğiniz içeriğin açılır menüsünü seçin ve Düzenle'yi tıklayın.

İçeriğin Temel bölümünde, Yalnızca Test Cihazları için onay kutusunu işaretleyin. Ardından, sayfanın alt kısmındaki Kaydet'i tıklayın. İşte bu kadar. Artık Tapjoy ile çalışan bir uyumlulaştırma entegrasyonunuz var.

Android

iOS

2. Adım: Kullanıcı arayüzünde Tapjoy talebini AdMob ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

Android

Talimatlar için Android kılavuzunun 2. adımına bakın.

iOS

Talimatlar için iOS rehberinin 2. adımına göz atın.

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Tapjoy ekle

GDPR ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayarak AdMob kullanıcı arayüzünde GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Tapjoy ekleyin.

3. Adım: Tapjoy SDK'sını ve bağdaştırıcıyı içe aktarın

Tapjoy için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü, Changelog'daki indirme bağlantısından indirin ve zip dosyasından GoogleMobileAdsTapjoyMediation.unitypackage dosyasını çıkarın.

Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel Paket'i ve indirdiğiniz GoogleMobileAdsTapjoyMediation.unitypackage dosyasını seçin. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

Ardından, Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici > Çözmeye Zorla'yı seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemeyi sıfırdan gerçekleştirecek ve beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalayacaktır.

4. Adım: Tapjoy SDK'sında gizlilik ayarlarını uygulayın

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken, uyumlulaştırma zincirinizde kişisel verileri toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

Tapjoy sürüm 1.1.1 için Google Mobil Reklamlar uyumlulaştırma eklentisi, SetUserConsent() ve SubjectToGDPR() yöntemlerini içerir. Aşağıdaki örnek kod, izin bilgilerinin Tapjoy SDK'ya nasıl iletileceğini gösterir. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce yapmanız önerilir.

using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...

Tapjoy.SetUserConsent("myUserConsent");

Buna ek olarak, kullanıcının GDPR'ye tabi olup olmadığını belirtmek için ayarlanabilecek isteğe bağlı bir işaret vardır.

Tapjoy.SubjectToGDPR(true);

Daha fazla ayrıntı ve yöntemde sağlanabilecek değerler için Tapjoy'un Kullanıcı Gizliliği kılavuzuna bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar ancak Google, bu ayarı uyumlulaştırma zincirinizdeki her reklam ağına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgi satışına dahil olabilecek tüm reklam ağlarını belirlemeniz ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

Tapjoy 2.9.1 sürümü için Google Mobil Reklamlar uyumlulaştırma eklentisi, SetUSPrivacy() yöntemini içerir. Aşağıdaki örnek kod, izin bilgilerinin Tapjoy SDK'ya nasıl iletileceğini göstermektedir. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce yapmanız önerilir.

using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...

Tapjoy.SetUSPrivacy("myUSPrivacyString");

Daha fazla ayrıntı ve yöntemde sağlanabilecek değerler için Tapjoy'un Kullanıcı Gizliliği kılavuzuna bakın.

5. Adım: Gerekli kodu ekleyin:

Android

Tapjoy entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için Tapjoy'un belgelerindeki adımları uygulayın.

6. Adım: Uygulamanızı test etme

Test reklamlarını etkinleştir

AdMob için test cihazınızı kaydettiğinizden ve Tapjoy kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.

Test reklamlarını doğrulama

Tapjoyreklam kaynağından test reklamları aldığınızı doğrulamak için Tapjoy (Bidding) and Tapjoy (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Android

İzinler

En iyi performans için Tapjoy, uygulamanızın AndroidManifest.xml dosyasına aşağıdaki isteğe bağlı izinleri eklemenizi öneriyor. Assets/Plugins/Android/GoogleMobileAdsTapjoyMediation klasörü altında bulunan AndroidManifest.xml dosyasını değiştirin ve aşağıdaki isteğe bağlı izinleri ekleyin:

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

iOS

iOS entegrasyonu için ek adım gerekmez.

Hata kodları

Bağdaştırıcı Tapjoy'dan reklam alamazsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Android

Biçim Sınıf adı
Geçişli TapjoyAdapter
Ödül olarak verildi TapjoyMediationAdapter

iOS

Biçim Sınıf adı
Geçişli GADMAdapterTapjoy
Ödül olarak verildi GADMAdapterTapjoy

Bir reklam yüklenemediğinde Tapjoy bağdaştırıcısı tarafından atılan kodlar ve ilgili mesajları burada bulabilirsiniz:

Android

Hata kodu Neden
101 Kullanıcı arayüzünde yapılandırılan Tapjoy sunucu parametreleri AdMob eksik/geçersiz.
103 Yayıncı, Activity bağlamına sahip reklamlar istemelidir.
104 Tapjoy SDK'sı başlatılamadı.
105 Video oynatılırken Tapjoy sunum hatası oluştu.
106 Tapjoy SDK'sı, aynı yerleşim kimliği için aynı anda iki reklam yükleyemez.
107 Uygulama, yerel reklam istemedi.
108 Tapjoy SDK'sında kullanılabilir reklam içeriği yok.

iOS

Hata kodu Neden
101 Kullanıcı arayüzünde yapılandırılan Tapjoy sunucu parametreleri AdMob eksik/geçersiz.
102 Tapjoy SDK'sı başlatılamadı.
103 Tapjoy bağdaştırıcısı, istenen reklam biçimini desteklemiyor.
104 Tapjoy başarılı bir yükleme geri çağırması gönderdi, ancak içerik yoktu.
105 Bu ağ yapılandırması için zaten bir reklam yüklendi.
106 Tapjoy SDK'sı bir video hatası geri çağırması döndürdü.

Tapjoy Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

Sürüm 3.2.0

Sürüm 3.1.1

Sürüm 3.1.0

Sürüm 3.0.0

Sürüm 2.10.1

Sürüm 2.10.0

Sürüm 2.9.1

Sürüm 2.9.0

Sürüm 2.8.2

Sürüm 2.8.1

Sürüm 2.8.0

Sürüm 2.7.1

Sürüm 2.7.0

Sürüm 2.6.1

Sürüm 2.6.0

Sürüm 2.5.1

Sürüm 2.5.0

Sürüm 2.4.2

Sürüm 2.4.1

Sürüm 2.4.0

Sürüm 2.3.1

Sürüm 2.3.0

  • Tapjoy Android adaptörü sürüm 12.3.1.0'ı destekler.
  • Tapjoy iOS adaptörü 12.3.1.0 sürümünü destekler.

Sürüm 2.2.0

  • Eklenti, yeni Ödüllü API'yi destekleyecek şekilde güncellendi.
  • Tapjoy Android adaptörü sürüm 12.2.1.0'ı destekler.
  • Tapjoy iOS adaptörü sürüm 12.2.1.0'ı destekler.

Sürüm 2.1.0

  • Tapjoy Android adaptörü sürüm 12.2.0.0'ı destekler.
  • Tapjoy iOS adaptörü sürüm 12.1.0.0'ı destekler.

Sürüm 2.0.1

  • Tapjoy Android adaptörü sürüm 12.0.0.1'i destekler.
  • Tapjoy iOS adaptörü sürüm 12.0.0.0'ı destekler.

Sürüm 2.0.0

  • Tapjoy Android adaptörü sürüm 12.0.0.0'ı destekler.
  • Tapjoy iOS adaptörü sürüm 12.0.0.0'ı destekler.

Sürüm 1.1.1

  • Tapjoy Android SDK'sının 11.12.2 sürümünü destekler.
  • Tapjoy iOS SDK'sının 11.12.2 sürümünü destekler.
  • Kullanıcının izin durumunu Tapjoy SDK'sına rıza dizesi biçiminde yönlendirmek için Tapjoy.SetUserConsent() yöntemi eklendi.
  • GDPR'nin kullanıcı için geçerli olup olmadığını belirtmek üzere Tapjoy.SubjectToGDPR() yöntemi eklendi.

Sürüm 1.1.0

  • Tapjoy Android SDK'sının 11.12.1 sürümünü destekler.
  • Tapjoy iOS SDK'sının 11.12.1 sürümünü destekler.

Sürüm 1.0.0

  • İlk sürüm!
  • Tapjoy Android SDK'sının 11.11.1 sürümünü destekler.
  • Tapjoy iOS SDK'sının 11.11.1 sürümünü destekler.