Bu sayfa, Cloud Translation API ile çevrilmiştir.

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:

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

Yeni uygulama ve reklam yerleşimi ekle

DT Exchange Konsolu'na kaydolun veya giriş yapın.

Uygulamanızı eklemek için Uygulama Ekle düğmesini tıklayın.

Uygulamaları Yönet

Platformunuzu seçin, formun geri kalanını doldurun ve Yerleşim Ekle'yi tıklayın.

Yerleşiminizi Adlandırın etiketli alana yeni yerleşim için bir ad girin ve açılır listeden istediğiniz Yerleşim Türü'nü seçin. Son olarak, Yerleşimi Kaydet'i tıklayın.

Kurulum

Uygulama Kimliği ve Yerleşim Kimliği

Farenizi üzerine getirerek sol gezinme çubuğunu açın. Ardından soldaki menüden Uygulamalar'ı tıklayın.

Uygulama Yönetimi sayfasında, uygulamanızın yanındaki Uygulama Kimliğini not edin.

Uygulama Kimliği

Uygulamanızı seçin, Yerleşimler sekmesine gidin ve Yerleşim Adı'nın yanındaki kopyala simgesini tıklayın. Yerleşim Kimliğini not edin.

Yerleşim Kimliği

Yayıncı Kimliği, Tüketici Anahtarı ve Tüketici Sırrı

Soldaki menüden kullanıcı adınızı tıklayın ve Kullanıcı Profili'ni seçin.

Sonraki adımda gerekli olan Yayıncı Kimliği, Tüketici Anahtarı ve Tüketici Sırrı değerlerini not edin.

2. Adım: Kullanıcı arayüzünde DT Exchange talebini Ad Manager ayarlayın

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

Ad Manager hesabınızda oturum açın.

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın.

Getiri grubunuz için benzersiz bir Ad girin, Durum'u Etkin olarak ayarlayın, Reklam Biçimi'ni seçin ve Envanter türü'nü Mobil Uygulama olarak ayarlayın. Hedefleme > Envanter bölümünün altında Envanter ve Mobil uygulama altında uyumlulaştırma eklemek istediğiniz reklam birimini seçin.

Ardından, Getiri iş ortağı ekle düğmesini tıklayın.

DT Exchangeiçin zaten bir Getiri iş ortağınız varsa bunu seçebilirsiniz. Aksi takdirde, Yeni bir getiri iş ortağı oluştur'u seçin.

Reklam ağı olarak DT Exchange'i seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin.

Otomatik veri toplama'yı açın ve önceki bölümde belirtilen Publisher ID, Consumer Secret and Consumer Key değerini girin.

Getiri iş ortağı seçildikten sonra Entegrasyon türü olarak Mobil SDK Uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin. Bir önceki bölümde verilenApplication ID and Placement ID kodunu girin. Ardından, Varsayılan BGBM değerini girin.

olduğu gibi, hedeflenen uygulamayla ilişkilendirilmelidir.

İşiniz bittiğinde sayfanın alt kısmındaki Kaydet'i tıklayı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.0.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.

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 ilişkin 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.