Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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 makalede, reklam biriminin uyumlulaştırma yapılandırmasına Tapjoy reklamlarının nasıl ekleneceği ve Tapjoy SDK ile bağdaştırıcının bir uygulamaya nasıl Android entegre edileceği ele alınmaktadır.
Desteklenen entegrasyonlar ve reklam biçimleri
Tapjoy'un Ad Manager 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
Yerel biçim
Koşullar
Android API düzeyi 19 veya üstü
[Teklifli sistem için]: Tapjoy adaptörü 12.2.1.1 veya sonraki sürümler
(en son sürüm önerilir)
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 Ad Manager uyumlulaştırma ile kullanılacak yerleşimler oluşturmaya geçebilirsiniz.
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 Ad Manager 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
Ad Manager Reklam Biriminizi ayarlamak amacıyla kullanılır.
Bu örnekte "Ad Manager 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.
İç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:
Reklam biriminizi oluşturmak için Yerleşim Adına ek olarak SDK Anahtarı da gerekir. Ad Manager
Ayarlar > Uygulama Ayarları'na gidin. SDK AnahtarınızıUygulama Platformları sekmesinin altındaki Uygulama Bilgilerinizden edinebilirsiniz.
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ızaAPI 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.
Ad uyuşmazlığına rağmen Google Ad Manager yayıncıları bu değeri kullanmalıdır.
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:
Your device's **Advertising ID** can be located by navigating to **Google >
Ads** in your device **Settings**.
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.
2. Adım: Kullanıcı arayüzünde Tapjoy talebini Ad Manager ayarlayın
Bu adım, teklif entegrasyonları için gerekli değildir.
Şelale
Yönetici > Şirketler'e gidin ve ardından Tüm şirketler sekmesinde Yeni şirket düğmesini tıklayın. Reklam ağı'nı seçin.
Reklam ağı olarak Tapjoy'i seçin,
benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin.
Kullanıcı adı veya şifre girmenize gerek yoktur. İşlem tamamlandığında Kaydet'i tıklayın.
Güvenli sinyal paylaşımını etkinleştirin
Teklif
Yönetici > Genel ayarlar'a gidin. Ad Exchange hesap ayarları sekmesine gidip Güvenli sinyal paylaşımı'nı inceleyip etkinleştirin. Save'i (Kaydet) tıklayın.
Şelale
Bu adım, şelale entegrasyonları için gerekli değildir.
Teklifli sistemi Tapjoy yapılandırın
Teklif
Yayınlama > Teklif Verenler'e gidin ve SDK Teklifi sekmesinin altında Yeni teklif veren'i tıklayın.
Teklif veren olarak Tapjoy simgesini seçin.
Bu teklif verenin sinyal kitaplığını izin verilen sinyaller listesine ekle ve Sinyallerin bu teklif verenle paylaşılmasına izin ver seçeneklerini açık duruma getirin. Ardından Devam'ı tıklayın.
Devam'ı tıklayın.
Done'ı (Bitti) tıklayın.
Şelale
Bu adım, şelale entegrasyonları için gerekli değildir.
Reklam birimi eşlemesini yapılandır
Teklif
Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Verme sekmesi altındaTapjoy şirketini seçin.
Reklam birimi eşleme sekmesine gidin ve Yeni reklam birimi eşleme'yi tıklayın.
Belirli reklam birimi'ni seçin. Bir reklam birimi ve biçim seçin, Envanter türü olarak Mobil uygulamayı ve Mobil uygulamanızı seçin. Ardından, bir önceki bölümde aldığınızSDK Key and Placement Name kodunu girin. Son olarak Kaydet'i tıklayın.
Şelale
Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın. Mobil uygulamanızı seçin.
Aşağı kaydırın ve Getiri iş ortağı ekle'yi tıklayın.
Önceki bölümde Tapjoy
şirket için oluşturduğunuzu seçin. Entegrasyon türü olarak Mobil SDK uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin.
Önceki bölümde belirtilen SDK Key and Placement Name
değerini ve Varsayılan BGBM değerini girin. Kaydet'i tıklayın.
GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Tapjoy ekle
GDPR ayarları
ve
ABD eyalet yönetmelikleri ayarları
bölümündeki adımları uygulayarak Ad Manager 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
Android Studio entegrasyonu (önerilir)
Aşağıdaki uygulama bağımlılığını, uygulama düzeyindeki build.gradle dosyasına Tapjoy SDK'sının ve bağdaştırıcının en son sürümüyle ekleyin:
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 SDK'sının 12.6.0 sürümünde, gizlilik ayarlarını desteklemek için bir kullanıcı rızası API'si eklendi. Aşağıdaki örnek kod, bu izin bilgilerinin Tapjoy SDK'sına 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.
import com.tapjoy.Tapjoy
...
val privacyPolicy = Tapjoy.getPrivacyPolicy()
privacyPolicy.setSubjectToGDPR(true)
privacyPolicy.setUserConsent("0")
Daha ayrıntılı bilgi ve her bir yöntemle sağlanabilecek değerler için Tapjoy'un
Kullanıcı Gizlilik Rehberi
sayfasını ziyaret edin.
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 SDK'sının 12.6.0 sürümünde, gizlilik ayarlarını desteklemek için bir kullanıcı rızası API'si eklendi. Aşağıdaki örnek kod, bu izin bilgilerinin Tapjoy SDK'sına 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.
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
Tapjoy'u CCPA reklam iş ortakları listesine ekleyin
Şu sayfadaki adımları uygulayın:
CCPA ayarları
Ad Manager kullanıcı arayüzünde CCPA reklam iş ortakları listesine Tapjoy'u ekleyin.
İzinler
En iyi performans için Tapjoy, uygulamanızın AndroidManifest.xml dosyasına aşağıdaki isteğe bağlı izinleri eklemenizi önerir:
Tapjoy bağdaştırıcısı, TapjoyExtrasBundleBuilder sınıfını kullanarak bağdaştırıcıya iletilebilecek ek bir istek parametresini destekler. TapjoyExtrasBundleBuilder aşağıdaki yöntemi içerir:
setDebug(bool)
Tapjoy SDK'sında hata ayıklama modunu etkinleştirmek, Tapjoy Developer Console'da çeşitli Tapjoy işlemlerini görebilmenizi sağlar. Bu parametre, tüm reklam biçimleri için desteklenir.
Aşağıda, bu reklam isteği parametrelerini nasıl ayarlayacağınıza ilişkin bir kod örneği verilmiştir:
Java
Bundle extras = new TapjoyAdapter.TapjoyExtrasBundleBuilder()
.setDebug(true)
.build();
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(TapjoyAdapter.class, extras)
.build());
Kotlin
val extras = TapjoyExtrasBundleBuilder()
.setDebug(true)
.build()
val adRequest = AdManagerAdRequest
.addNetworkExtrasBundle(TapjoyAdapter::class.java, extras)
.build()
Bağdaştırıcınızı ve SDK sürümlerinizi doğrulama
Bağdaştırıcı ve SDK sürümlerini günlüğe kaydetmek için aşağıdaki kod snippet'ini kullanın:
TapjoyMediationAdapter adapter = new TapjoyMediationAdapter();
VersionInfo adapterVersion = adapter.getVersionInfo();
VersionInfo sdkVersion = adapter.getSDKVersionInfo();
// Log the adapter patch version to 3 digits to represent the x.x.x.x versioning
// used by adapters.
Log.d("TAG", String.format(
"Adapter version: %d.%d.%03d",
adapterVersion.getMajorVersion(),
adapterVersion.getMinorVersion(),
adapterVersion.getMicroVersion()));
Log.d("TAG", String.format(
"SDK version: %d.%d.%d",
sdkVersion.getMajorVersion(),
sdkVersion.getMinorVersion(),
sdkVersion.getMicroVersion()));
Hata kodları
Bağdaştırıcı Tapjoy'dan reklam alamazsa aşağıdaki sınıfların altında
ResponseInfo.getAdapterResponse() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:
Biçim
Sınıf adı
Geçişli
TapjoyAdapter
Ödül olarak verildi
TapjoyMediationAdapter
Bir reklam yüklenemediğinde Tapjoy bağdaştırıcısı tarafından atılan kodlar ve ilgili mesajları burada bulabilirsiniz:
Hata kodu
Neden
101
Kullanıcı arayüzünde yapılandırılan Tapjoy sunucu parametreleri Ad Manager 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.
101
Kullanıcı arayüzünde yapılandırılan Tapjoy sunucu parametreleri Ad Manager 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 Android Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü
Sürüm 13.2.1.0
Gereken minimum Google Mobile Ads SDK'sı sürümü, 22.3.0 olarak güncellendi.
Tapjoy SDK'sı 13.2.1 sürümü ile doğrulanmış uyumluluk.
Tapjoy SDK'sı 12.9.1 sürümü ile doğrulanmış uyumluluk.
Gereken minimum Google Mobile Ads SDK'sı sürümü, 20.6.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
Google Mobile Ads SDK'sı sürüm 20.6.0.
Tapjoy SDK'sı 12.9.1 sürümü.
Sürüm 12.9.0.0
Tapjoy SDK'sı 12.9.0 sürümü ile doğrulanmış uyumluluk.
Gereken minimum Google Mobile Ads SDK'sı sürümü, 20.5.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
Google Mobile Ads SDK'sı sürüm 20.5.0.
Tapjoy SDK'sı 12.9.0 sürümü.
Sürüm 12.8.1.1
Tapjoy SDK'sının 12.8.1 sürümüyle uyumlu olduğu doğrulandı.
Gereken minimum Google Mobile Ads SDK'sı sürümü, 20.4.0 olarak güncellendi.
Tapjoy'un TJError.message alanı null olduğunda kilitlenme meydana gelmesi sorunu giderildi.
Aşağıdakilerle geliştirildi ve test edildi:
Google Mobile Ads SDK'sı sürüm 20.4.0.
Tapjoy SDK'sı 12.8.1 sürümü.
Sürüm 12.8.1.0
Tapjoy SDK'sının 12.8.1 sürümüyle uyumlu olduğu doğrulandı.
Bağdaştırıcı tarafından bir hata kaydedildiğinde NullPointerException öğesinin günlüğe kaydedilmesine neden olan sorun düzeltildi.
Gereken minimum Google Mobile Ads SDK'sı sürümü, 20.2.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
Google Mobile Ads SDK'sı sürüm 20.2.0.
Tapjoy SDK'sı 12.8.1 sürümü.
Sürüm 12.8.0.1
Gereken minimum Google Mobile Ads SDK'sı sürümü, 20.0.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
Google Mobile Ads SDK'sı sürüm 20.0.0.
Tapjoy SDK'sı 12.8.0 sürümü.
Sürüm 12.8.0.0
Yanlış hata mesajları düzeltildi.
Gereken minimum Google Mobile Ads SDK'sı sürümü, 19.7.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
Google Mobile Ads SDK'sı sürüm 19.7.0.
Tapjoy SDK'sı 12.8.0 sürümü.
Sürüm 12.7.1.0
Tapjoy SDK'sı 12.7.1 sürümü ile doğrulanmış uyumluluk.
Gereken minimum Google Mobile Ads SDK'sı sürümü, 19.5.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
Google Mobile Ads SDK'sı sürüm 19.5.0.
Tapjoy SDK'sı 12.7.1 sürümü.
Sürüm 12.7.0.0
Bağdaştırıcının yanlış bir sürüm dizesi döndürmesine neden olan sorun düzeltildi.
Gereken minimum Google Mobile Ads SDK'sı sürümü, 19.4.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
Google Mobile Ads SDK'sı sürüm 19.4.0.
Tapjoy SDK'sı 12.7.0 sürümü.
Sürüm 12.6.1.0
Tapjoy SDK'sı 12.6.1 sürümü ile doğrulanmış uyumluluk.
Artık aynı Tapjoy yerleşim adına sahip birden fazla geçiş reklamı, tek seferde ikinci istek için yükleme hatasına neden oluyor. Bu davranış artık ödüllü reklamlar için mevcut davranışla eşleşmektedir.