DT Exchange'i Uyumlulaştırma ile entegre etme

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:

Ş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

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

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

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.

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

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:

Aşağıda, bu reklam isteği parametrelerinin nasıl ayarlanacağına dair bir kod örneği verilmiştir:

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();

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:

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 ve targetSdkVersion, 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.