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 Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

DT Exchange için Unity uyumlulaştırıcı bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif verme
Şelale
Formatlar
Banner
Geçiş reklamı
Ödüllü

Şartlar

  • En son Google Mobile Ads SDK'sı
  • Unity 4 veya üzeri
  • Android'de dağıtmak için
    • Android API düzeyi 21 veya sonraki sürümler
  • iOS'te dağıtmak için
    • 12.0 veya sonraki bir iOS dağıtım hedefi
  • Google Mobile Ads SDK'sı ile yapılandırılmış çalışan bir Unity projesi. Ayrıntılar için Başlayın bölümüne bakın.
  • 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.

Yapay Zeka

iOS

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.

Menü

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.

Kullanıcı Profili Menüsü

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.

Kullanıcı Profili

2. adım: AdMob kullanıcı arayüzünde DT Exchange talebini ayarlayın

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

Yapay Zeka

Talimatlar için Android kılavuzundaki 2. adıma bakın.

iOS

Talimatlar için iOS kılavuzunun 2. adımına bakın.

DT Exchange'i GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

DT Exchange (Fyber Monetization)'i AdMob kullanıcı arayüzündeki 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

OpenUPM-CLI

OpenUPM-CLI yüklüyse Unity için Google Mobil Reklamlar DT Exchange Uyumlulaştırma Eklentisi'ni projenizin kök dizininden aşağıdaki komutu çalıştırarak projenize yükleyebilirsiniz:

openupm add com.google.ads.mobile.mediation.dtexchange

OpenUPM

Unity Paket Yöneticisi Ayarlarını açmak için Unity proje düzenleyicinizde Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçin.

Kapsamlı Kayıt Daireleri sekmesinde, OpenUPM'yi aşağıdaki ayrıntılarla kapsamlı bir kayıt dairesi olarak ekleyin:

  • Ad: OpenUPM
  • URL: https://package.openupm.com
  • Kapsamlar: com.google

OpenUPM Ayrıntıları

Ardından, Unity Paket Yöneticisi'ni açmak için pencere > Paket Yöneticisi'ne gidin ve açılır menüden Kayıt Dairelerim'i seçin.

Unity Kayıt Daireleri

Google Mobile Ads DT Exchange Mediation paketini seçin ve Yükle'yi tıklayın.

OpenUPM'den yükleme

Unity Paketi

DT Exchange için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü değişiklik günlüğündeki indirme bağlantısından indirin ve GoogleMobileAdsDTExchangeMediation.unitypackage dosyasını zip dosyasından çıkarın.

Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsDTExchangeMediation.unitypackage dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

Unity'den içe aktarma

Ardından Öğeler > Harici Bağımlılık Yöneticisi > Android Çözücü > Çözümü Zorla'yı seçin. Harici Bağımlılık Yöneticisi kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

Çözümü Zorla Uygula

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

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.

Bu bölümde, DT Exchange için kişiselleştirilmiş reklamların nasıl etkinleştirileceği veya devre dışı bırakılacağı gösterilmektedir.

DT Exchange 1.1.0 sürümü için Google Mobile Ads uyumlulaştırma eklentisi, SetGDPRRequired() ve SetGDPRConsentString() yöntemlerini içeren Fyber sınıfını ekleyerek izin bilgilerini DT Exchange'e manuel olarak iletmenize olanak tanıdı. Aşağıdaki örnek kodda, bu parametrelerin DT Exchange bağdaştırıcısı'na nasıl iletileceği gösterilmektedir:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");

Daha fazla bilgi ve yöntemde sağlanabilecek değerler için DT Exchange'in GDPR makalesini ziyaret edin.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, kişisel bilgilerinin "satışının" (bu terimlerin yasalardaki tanımına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılar. Bu 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.

DT Exchange 3.1.1 sürümü için Google Mobile Ads uyumlulaştırma eklentisi, SetCCPAString() yöntemiyle Fyber sınıfını ekleyerek izin bilgilerini DT Exchange'e manuel olarak iletmenize olanak tanıdı. Aşağıdaki örnek kodda, bu parametrelerin DT Exchange bağdaştırıcısı'na nasıl iletileceği gösterilmektedir:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetCCPAString("myCCPAConsentString");

// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();

Daha fazla bilgi ve yöntemde sağlanabilecek değerler için DT Exchange'in CCPA Açık Kaynağı makalesini ziyaret edin.

5. adım: Gerekli kodu ekleyin

Yapay Zeka

DT Exchange entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için DT Exchange'in dokümanlarını inceleyin.

6. adım: Uygulamanızı test edin

Test reklamlarını etkinleştirme

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

Hata kodları

Adaptör DT Exchange'ten reklam alamıyorsa yayıncılar aşağıdaki sınıf altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Yapay Zeka

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

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:

Yapay Zeka

Hata kodu Neden
101 AdMob kullanıcı arayüzünde yapılandırılan DT Exchange sunucusu 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.

iOS

Hata kodu Neden
0-10 DT Exchange SDK'sı hata döndürdü. Daha fazla ayrıntı için dokümanları inceleyin.
101 AdMob kullanıcı arayüzünde yapılandırılan DT Exchange sunucusu parametreleri eksik/geçersiz.
102 İstenen reklam boyutu, DT Exchange tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103 Reklam nesnesi zaten kullanıldığı için reklam gösterilemedi.
104 Reklam hazır olmadığından DT Exchange reklamları gösterilemedi.
105 DT Exchange SDK'sı bir ilk başlatma hatası döndürmüştür.

DT Exchange Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

3.3.4 sürümü

3.3.3 sürümü

3.3.2 sürümü

3.3.1 sürümü

3.3.0 sürümü

3.2.1 sürümü

3.2.0 sürümü

3.1.12 sürümü

3.1.11 sürümü

3.1.10 sürümü

3.1.8 sürümü

3.1.7 sürümü

3.1.6 sürümü

3.1.5 sürümü

3.1.4 sürümü

3.1.3 sürümü

3.1.2 sürümü

3.1.1 sürümü

3.1.0 sürümü

3.0.2 sürümü

Sürüm 3.0.1

3.0.0 sürümü

2.0.0 sürümü

Sürüm 1.6.1

Sürüm 1.6.0

1.5.2 sürümü

1.5.1 sürümü

Sürüm 1.5.0

Sürüm 1.4.0

Sürüm 1.3.0

1.2.3 sürümü

1.2.2 sürümü

Sürüm 1.2.1

Sürüm 1.2.0

Sürüm 1.1.0

Sürüm 1.0.0