Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl uyumlulaştırma, ele alacağız. DT Exchange'in bir reklama nasıl ekleneceğini ele almaktadır birimin uyumlulaştırma yapılandırması ve DT Exchange SDK'sı ile entegrasyon bir uygulamaya entegre Android edebilirsiniz.
Desteklenen entegrasyonlar ve reklam biçimleri
DT Exchange için uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:
Entegrasyon | |
---|---|
Teklif verme | |
Şelale | |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü | |
Yerel biçim |
Şartlar
- Android API düzeyi 21 veya üstü
En son Google Mobile Ads SDK'sı
Arabuluculuğu tamamlama Başlangıç kılavuzu
1. Adım: DT Exchange kullanıcı arayüzünde yapılandırmaları ayarlayın
2. Adım: Kullanıcı arayüzünde DT Exchange talebini Ad Manager ayarlayın
GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Fyber ekleyin
3. Adım: DT Exchange SDK'sını ve bağdaştırıcısını içe aktarın
Android Studio entegrasyonu (önerilir)
Uygulama düzeyindeki build.gradle.kts
dosyanıza aşağıdaki uygulamayı ekleyin
ve yapılandırmaları içerir. DT Exchange SDK'sının en son sürümlerini kullanın
ve adaptör:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:fyber:8.3.1.0")
}
Manuel entegrasyon
- Son sürümünü indirin
Android için DT Exchange SDK'sı seçeneğine gidin ve
projenize ekleyin:
ia-mraid-kit-release-x.y.z.aar
ia-sdk-core-release-x.y.z.aar
ia-video-kit-release-x.y.z.aar
- Şuraya gidin:
DT Exchange bağdaştırıcısı yapıları
Google'ın Maven deposunda. En son sürümü seçin ve DT'yi indirin.
Exchange bağdaştırıcısının
.aar
dosyasını seçin ve bu dosyayı projenize ekleyin.
4. Adım: Gizlilik ayarlarını DT Exchange SDK'sında uygulayın
AB kullanıcı rızası ve GDPR
Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.
DT Exchange, kullanıcı rızasını SDK'sına yönlendirmenize olanak tanıyan bir API içerir. İlgili içeriği oluşturmak için kullanılan aşağıdaki örnek kod, izin bilgilerinin DT Exchange'e nasıl iletileceğini gösterir SDK'yı manuel olarak ekleyin. İzin bilgilerini DT Exchange'e aktarmayı seçerseniz SDK manuel olarak gösteriliyorsa, reklam isteğinde bulunmadan önce bu kodun çağrılması önerilir Google Mobile Ads SDK'sı aracılığıyla yükleyebilirsiniz.
Java
import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...
InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");
Kotlin
import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...
InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")
DT Exchange'in GDPR Kaynak Sayfasını ve GDPR uygulama kılavuzu 'na bakın.
ABD eyalet gizlilik yasaları
ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.
DT Exchange, kullanıcı rızasını SDK'sına yönlendirmenize olanak tanıyan bir API içerir. İlgili içeriği oluşturmak için kullanılan aşağıdaki örnek kod, izin bilgilerinin DT Exchange'e nasıl iletileceğini gösterir SDK'yı manuel olarak ekleyin. İzin bilgilerini DT Exchange SDK'sına manuel olarak iletmeyi seçerseniz bu kodun Google Mobile Ads SDK'sı üzerinden reklam isteğinde bulunmadan önce çağrılması önerilir.
Java
import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...
InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");
Kotlin
import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...
InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")
DT Exchange'in CCPA Kaynak Sayfası'nı ve CCPA uygulama kılavuzu 'na bakın.
5. Adım: Gerekli kodu ekleyin
DT Exchange entegrasyonu için ek kod gerekmez.
6. Adım: Uygulamanızı test edin
Test reklamlarını etkinleştir
Ad Manager.
Test reklamlarını doğrulama
DT Exchangereklam kaynağından test reklamları aldığınızı doğrulamak için DT Exchange (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
İsteğe bağlı adımlar
Ağa özel parametreler
DT Exchange bağdaştırıcısı, aşağıdaki ek istek parametrelerini destekler: Android Bundle olarak adaptöre aktarılır. Adaptör şunları arar anahtar:
İstek parametreleri ve değerler | |
---|---|
InneractiveMediationDefs.KEY_AGE
|
Tam sayı. Kullanıcının yaşı |
FyberMediationAdapter.KEY_MUTE_VIDEO
|
Boole. Videonun sesini kapat veya aç |
Aşağıda, bu reklam isteği parametrelerinin nasıl ayarlanacağına dair bir kod örneği verilmiştir:
Java
Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);
AdRequest request = new AdRequest.Builder()
.addNetworkExtrasBundle(FyberMediationAdapter.class, extras)
.build();
Kotlin
var extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)
val request = AdRequest.Builder()
.addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
.build()
Hata kodları
Bağdaştırıcı, DT Exchange'den reklam alamazsa
kullanarak reklam yanıtından gelen temel hata
ResponseInfo.getAdapterResponses()
altında:
com.google.ads.mediation.fyber.FyberMediationAdapter
DT Exchange bağdaştırıcısı tarafından gönderilen kodlar ve gelen iletiler aşağıda verilmiştir Reklam yüklenemedi:
Hata kodu | Neden |
---|---|
101 | Kullanıcı arayüzünde yapılandırılan DT Exchange sunucusu parametreleri Ad Manager eksik/geçersiz. |
103 | İstenen reklam boyutu, DT Exchange tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
105 | DT Exchange SDK'sı bir reklam yükledi ancak beklenmeyen bir denetleyici döndürdü. |
106 | Reklam görüntülenmeye hazır değil. |
200-399 | DT Exchange SDK'sı hata döndürdü. Kodu inceleyin inceleyebilirsiniz. |
DT Exchange Android Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü
Sürüm 8.3.1.0
- DT Exchange SDK 8.3.1 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.3.0.
- DT Exchange SDK sürümü 8.3.1.
Sürüm 8.3.0.0
- Google Mobile Ads SDK'sı sürümünü DT Exchange SDK'sına iletme desteği eklendi.
- DT Exchange SDK 8.3.0 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.2.0.
- DT Exchange SDK'sı sürüm 8.3.0.
Sürüm 8.2.7.0
- DT Exchange SDK 8.2.7 ile uyumluluğu doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı 23.0.0 sürümü.
- DT Exchange SDK'sı sürüm 8.2.7.
Sürüm 8.2.6.1
- Zorunlu minimum Google Mobile Ads SDK sürümü 23.0.0 olarak güncellendi.
- DT Exchange SDK 8.2.6 ile uyumlu olduğu doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 23.0.0.
- DT Exchange SDK'sı sürüm 8.2.6.
Sürüm 8.2.6.0
- DT Exchange SDK 8.2.6 ile uyumluluğu doğrulanmıştır.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.6.0.
- DT Exchange SDK'sı sürüm 8.2.6.
Sürüm 8.2.5.0
- DT Exchange SDK 8.2.5 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.5.0.
- DT Exchange SDK'sı sürüm 8.2.5.
Sürüm 8.2.4.0
- DT Exchange SDK 8.2.4 ile uyumluluk doğrulandı.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 22.3.0.
- DT Exchange SDK sürümü 8.2.4.
Sürüm 8.2.3.0
- Bağdaştırıcı, yeni
VersionInfo
sınıfını kullanacak şekilde güncellendi. - Google Mobile Ads SDK'sı için gereken minimum sürüm 22.0.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 22.0.0.
- DT Exchange SDK'sı sürüm 8.2.3.
Sürüm 8.2.2.1
- Geçiş reklamlarını bir daha göstermemek için uyumlulaştırma ekstrasında
muteVideo
tuşunu iletme desteği eklendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.5.0.
- DT Exchange SDK'sı sürüm 8.2.2.
Sürüm 8.2.2.0
- DT Exchange SDK 8.2.2 ile uyumluluk doğrulandı.
- Zorunlu minimum Google Mobile Ads SDK sürümü 21.5.0 olarak güncellendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 21.5.0.
- DT Exchange SDK'sı sürüm 8.2.2.
Sürüm 8.2.1.0
- Bağdaştırıcının adı "DT Exchange" olarak değiştirildi.
- DT Exchange SDK 8.2.1 ile uyumluluk doğrulandı.
- Zorunlu minimum Google Mobile Ads SDK sürümü 21.3.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.3.0.
- DT Exchange SDK'sı sürüm 8.2.1.
Sürüm 8.2.0.0
- Fyber SDK'sı 8.2.0 ile uyumluluk doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 21.1.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.1.0.
- Fyber SDK'sı sürüm 8.2.0.
Sürüm 8.1.5.0
- Fyber SDK 8.1.5 ile uyumlu olduğu doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.0.0.
- Fyber SDK'sı sürüm 8.1.5.
Sürüm 8.1.4.0
- Fyber SDK 8.1.4 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 21.0.0.
- Fyber SDK sürümü 8.1.4.
Sürüm 8.1.3.1
compileSdkVersion
vetargetSdkVersion
, API 31 olarak güncellendi.- Zorunlu olan minimum Google Mobile Ads SDK sürümü 21.0.0 olarak güncellendi.
- Gerekli minimum Android API düzeyi 19 olarak güncellendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 21.0.0.
- Fyber SDK'sı sürüm 8.1.3.
Sürüm 8.1.3.0
- Fyber SDK'sı 8.1.3 ile uyumluluk doğrulandı.
- Gereken minimum Google Mobile Ads SDK'sı sürümü 20.6.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı 20.6.0 sürümü.
- Fyber SDK'sı sürüm 8.1.3.
Sürüm 8.1.2.0
- Fyber SDK 8.1.2 ile uyumlu olduğu doğrulandı.
- Zorunlu minimum Google Mobile Ads SDK sürümü 20.5.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 20.5.0.
- Fyber SDK'sı sürüm 8.1.2.
Sürüm 8.1.0.0
- Fyber SDK 8.1.0 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 20.4.0.
- Fyber SDK sürümü 8.1.0.
Sürüm 7.8.4.1
- Uyumlulaştırma yapılandırmalarında yinelenen veya birden fazla benzersiz uygulama kimliği varsa bağdaştırıcının başlatılmamasına neden olan sorun düzeltildi.
- Zorunlu minimum Google Mobile Ads SDK sürümü 20.4.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 20.4.0.
- Fyber SDK'sı sürüm 7.8.4.
Sürüm 7.8.4.0
- Fyber SDK'sı 7.8.4 ile uyumluluk doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 20.3.0 olarak güncellendi.
- Ödüllü görüntülü reklamlarla ilgili olarak
onVideoComplete()
çağrılmayan bir sorun düzeltildi. - Fyber'in reklam göstermesi için artık etkinlik bağlamı gerekir.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 20.3.0.
- Fyber SDK'sı sürüm 7.8.4.
Sürüm 7.8.3.0
- Fyber SDK 7.8.3 ile uyumluluk doğrulandı.
- Standartlaştırılmış bağdaştırıcı hata kodları ve mesajları eklendi.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 20.1.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 20.1.0.
- Fyber SDK'sı sürüm 7.8.3.
Sürüm 7.8.2.0
- Fyber SDK'sı 7.8.2 ile uyumluluk doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 20.0.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı 20.0.0 sürümü.
- Fyber SDK'sı sürüm 7.8.2.
Sürüm 7.8.1.0
- Fyber SDK'sı 7.8.1 ile uyumluluk doğrulandı.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 19.7.0.
- Fyber SDK sürümü 7.8.1.
Sürüm 7.8.0.0
- Fyber SDK 7.8.0 ile uyumluluğu doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 19.7.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 19.7.0.
- Fyber SDK sürümü 7.8.0.
Sürüm 7.7.4.0
- Fyber SDK'sı 7.7.4 ile uyumluluk doğrulandı.
onUserEarnedReward()
değerinin ödüllü reklamlar için iki kez yönlendirilmesine neden olan sorun düzeltildi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 19.5.0.
- Fyber SDK'sı sürüm 7.7.4.
Sürüm 7.7.3.0
- Fyber SDK 7.7.3 ile uyumluluğu doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 19.5.0.
- Fyber SDK'sı sürüm 7.7.3.
Sürüm 7.7.2.0
- Fyber SDK 7.7.2 ile uyumlu olduğu doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 19.5.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 19.5.0.
- Fyber SDK'sı sürüm 7.7.2.
Sürüm 7.7.1.0
- Fyber SDK'sı 7.7.1 ile uyumluluk doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 19.4.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 19.4.0.
- Fyber SDK'sı sürüm 7.7.1.
Sürüm 7.7.0.0
- Fyber SDK'sı 7.7.0 ile uyumluluk doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 19.3.0.
- Fyber SDK'sı sürüm 7.7.0.
Sürüm 7.6.1.0
- Fyber SDK 7.6.1 ile uyumluluğu doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 19.3.0.
- Fyber SDK'sı sürüm 7.6.1.
Sürüm 7.6.0.0
- Fyber SDK 7.6.0 ile uyumluluğu doğrulandı.
- Adaptör, satır içi uyarlanabilir banner isteklerini destekleyecek şekilde güncellendi.
- Zorunlu olan minimum Google Mobile Ads SDK sürümü 19.3.0 olarak güncellendi.
- Banner reklamlar için onAdOpened()/onAdClosed() yöntemlerinin çağrılmamasına yol açan hata düzeltildi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 19.3.0.
- Fyber SDK'sı sürüm 7.6.0.
Sürüm 7.5.4.0
- Fyber SDK'sı 7.5.4 ile uyumluluk doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 19.1.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 19.1.0.
- Fyber SDK'sı sürüm 7.5.4.
Sürüm 7.5.3.0
- Fyber SDK 7.5.3 ile uyumluluğu doğrulandı.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı 19.0.1 sürümü.
- Fyber SDK'sı sürüm 7.5.3.
Sürüm 7.5.2.0
- Fyber SDK 7.5.2 ile uyumluluğu doğrulandı.
- Google Mobile Ads SDK'sı için gereken minimum sürüm 19.0.1 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 19.0.1.
- Fyber SDK'sı sürüm 7.5.2.
Sürüm 7.5.0.0
- Fyber SDK 7.5.0 ile uyumluluk doğrulandı.
- Fyber reklam yükleme sırasındaki NullPointerException kilitlenmesi düzeltildi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 18.3.0 sürümü.
- Fyber SDK'sı sürüm 7.5.0.
7.4.1.0 sürümü
- Fyber SDK 7.4.1 ile uyumluluğu doğrulandı.
- Zorunlu minimum Google Mobile Ads SDK sürümü 18.3.0 olarak güncellendi.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 18.3.0.
- Fyber SDK'sı sürüm 7.4.1.
Sürüm 7.3.4.0
- İlk sürüm!
- Banner, geçiş reklamı ve ödüllü reklamları destekler.
Aşağıdakilerle derlenip test edildi:
- Google Mobile Ads SDK'sı sürüm 18.2.0.
- Fyber SDK'sı sürüm 7.3.4.