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

DT Exchange'i Uyumlulaştırma ile Entegre Etme

Bu kılavuzda, şelale entegrasyonlarını kapsayan arabuluculuk kullanarak DT Exchange'ten reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, DT Exchange'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve DT Exchange SDK'sının ve bağdaştırıcının bir Android uygulamasına nasıl entegre edileceği açıklanmaktadır.

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 sonraki sürümler

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı 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 ekleme

DT Exchange Console'a 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şimin adını 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ği'ni not edin.

Uygulama Kimliği

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

Yerleşim Kimliği

Yayıncı kimliği, tüketici anahtarı ve tüketici gizli anahtarı

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

Bir sonraki adımda yayıncı kimliği, tüketici anahtarı ve tüketici gizli anahtarı'na ihtiyacınız olacağından bunları not edin.

2. Adım: DT Exchange talebini Ad Manager kullanıcı arayüzünde 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ünde, Envanter ve Mobil uygulama altında uyumlulaştırmayı eklemek istediğiniz reklam birimini seçin.

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

DT Exchange için zaten bir getiri iş ortağınız varsa bu iş ortağını seçebilirsiniz. Aksi takdirde Yeni bir gelir 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ı etkinleştirin ve önceki bölümde elde edilen yayıncı kimliğini, tüketici gizli anahtarını ve tüketici anahtarını girin.

Getiri iş ortağı seçildikten sonra Entegrasyon türü olarak Mobil SDK Uyumlulaştırması'nı, Platform olarak Android'i ve Durum olarak Etkin'i seçin. Önceki bölümde elde edilen uygulama kimliğini ve yerleşim kimliğini girin. Ardından, bir Varsayılan BGBM değeri girin.

İşleminiz bittiğinde sayfanın alt kısmındaki Kaydet'i tıklayın.

DT Exchange'i (Fyber Para Kazanma) GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

Ad Manager kullanıcı arayüzünde DT Exchange (Fyber Monetization)'i GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için GDPR ayarlarındaki ve ABD eyalet düzenlemeleri ayarlarındaki adımları uygulayın.

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

Android Studio entegrasyonu (önerilen)

Uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıkları ve yapılandırmaları ekleyin. DT Exchange SDK'sının ve bağdaştırıcının en son sürümlerini kullanın:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:fyber:8.3.3.0")
}

Manuel entegrasyon

Android için DT Exchange SDK'sının en son sürümünü indirin ve aşağıdaki dosyaları 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
Google'ın Maven deposunda DT Exchange bağdaştırıcısı yapılarına gidin. En son sürümü seçin, DT Exchange bağdaştırıcının .aar dosyasını indirin ve projenize ekleyin.

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

AB kullanıcı rızası ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.

DT Exchange, kullanıcı rızasını SDK'larına iletmenize olanak tanıyan bir API içerir. Aşağıdaki örnek kodda, izin bilgilerinin DT Exchange SDK'sına manuel olarak nasıl iletileceği gösterilmektedir. İ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.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

Kotlin

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

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

Daha fazla bilgi ve yöntemde sağlanabilecek değerler için DT Exchange'in GDPR Kaynak Sayfası'nı ve GDPR uygulama kılavuzunu ziyaret edin.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları, kullanıcılara "kişisel bilgilerinin" "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma hakkı sunmayı zorunlu kılar. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantıyla sunulur. ABD eyalet gizlilik yasaları uygunluk kılavuzu, Google reklam sunumu 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 bilgilerin satışına katılabilir her reklam ağını tanımlamanız ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

Java

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

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

Kotlin

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

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

Daha fazla bilgi ve yöntemde sağlanabilecek değerler için DT Exchange'in CCPA Kaynak Sayfası'nı ve CCPA uygulama kılavuzunu ziyaret edin.

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ştirme

Ad Manager için test cihazınızı kaydettiğinizden emin olun.

Test reklamlarını doğrulama

DT Exchange'ten test reklamları aldığınızı doğrulamak için DT Exchange (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özgü parametreler

DT Exchange bağdaştırıcısı, Android paketi olarak bağdaştırıcının aktarabileceği ek istek parametrelerini destekler. Adaptör, pakette aşağıdaki anahtarları arar:

İstek parametreleri ve değerleri
`InneractiveMediationDefs.KEY_AGE`	Tam sayı. Kullanıcının yaşı
`FyberMediationAdapter.KEY_MUTE_VIDEO`	Boole. Videonun sesini kapatma veya açma

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

AdManagerAdRequest request = new AdManagerAdRequest.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 = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
   .build()

Hata kodları

Adaptör DT Exchange'ten reklam alamıyorsa aşağıdaki sınıf altında ResponseInfo.getAdapterResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

com.google.ads.mediation.fyber.FyberMediationAdapter

Bir reklam yüklenemezse DT Exchange bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

Hata kodu	Neden
101	Ad Manager kullanıcı arayüzünde yapılandırılan DT Exchange sunucu parametreleri 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österilmeye hazır değil.
200-399	DT Exchange SDK'sı hata döndürdü. Daha fazla bilgi için kod bölümüne bakın.