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

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

Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma özelliğinden yararlanarak DT Exchange'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu kılavuzda, reklam biriminin uyumlulaştırma yapılandırmasına DT Exchange'in nasıl ekleneceği ve DT Exchange SDK'sı ile bağdaştırıcısı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 AdMob uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif
Şelale
Formatlar
Banner
Geçişli
Ödül olarak verildi

Koşullar

Unity 4 veya üzeri
En son Google Mobile Ads SDK'sı
Android'de dağıtmak için
- Android API düzeyi 19 veya üstü
iOS'te dağıtmak için
- 12.0 veya üstü 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şlarken bölümüne bakın.
Uyumlulaştırmayı tamamlayın 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.

Android

iOS

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 AdMob ayarlayın

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

Android

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

iOS

Talimatlar için iOS rehberinin 2. adımına göz atın.

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Fyber ekle

GDPR ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayarak AdMob 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ıyı içe aktarın

Changelog'daki indirme bağlantısından DT Exchange için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsFyberMediation.unitypackage dosyasını çıkarın.

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

Ardından, Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici > Çözmeye Zorla'yı seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemeyi sıfırdan gerçekleştirecek ve beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalayacaktır.

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

AB İzni ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken, uyumlulaştırma zincirinizde kişisel verileri toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

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 sürüm 1.1.0 için Google Mobile Ads uyumlulaştırma eklentisi, Fyber sınıfını SetGDPRRequired() ve SetGDPRConsentString() yöntemleriyle ekleyerek izin bilgilerini DT Exchange'e manuel olarak iletebilmenizi sağladı. Aşağıdaki örnek kod, bu parametrelerin DT Exchange adaptörüne nasıl iletileceğini gösterir:

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

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

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

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını 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 bilgi satışına dahil olabilecek tüm reklam ağlarını belirlemeniz ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

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

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 Kaynak makalesini ziyaret edin.

5. Adım: Gerekli kodu ekleyin

Android

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ındaki talimatları uygulayın.

6. Adım: Uygulamanızı test etme

Test reklamlarını etkinleştir

AdMob.

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.

Hata kodları

Bağdaştırıcı, DT Exchange'den reklam alamazsa yayıncılar aşağıdaki sınıf altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

Bir reklam yüklenemediğinde DT Exchange bağdaştırıcısı tarafından atılan kodlar ve ilgili mesajları burada bulabilirsiniz:

Android

Hata kodu	Neden
101	Kullanıcı arayüzünde yapılandırılmış DT Exchange sunucusu parametreleri AdMob 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 bir hata döndürdü. Daha fazla bilgi için kodu inceleyin.

iOS

Hata kodu	Neden
0-10	DT Exchange SDK bir hata döndürdü. Daha fazla ayrıntı için belgelere bakın.
101	Kullanıcı arayüzünde yapılandırılmış DT Exchange sunucusu parametreleri AdMob 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ığı için DT Exchange reklamları gösterilemedi.
105	DT Exchange SDK'sı bir başlatma hatası döndürdü.

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

Sürüm 3.1.8

DT Exchange Android adaptörü sürüm 8.2.5.0'ı destekler.
DT Exchange iOS bağdaştırıcısı 8.2.6.0 sürümünü destekler.
Google Mobil Reklamlar Unity Eklentisi sürüm 8.6.0 ile geliştirilip test edilmiştir.

Sürüm 3.1.7

DT Exchange Android adaptörü 8.2.4.0 sürümünü destekler.
DT Exchange iOS bağdaştırıcısı 8.2.4.0 sürümünü destekler.
Google Mobil Reklamlar Unity Eklentisi sürüm 8.5.2 ile geliştirilip test edilmiştir.

Sürüm 3.1.6

DT Exchange Android adaptörü 8.2.3.0 sürümünü destekler.
DT Exchange iOS bağdaştırıcısı 8.2.3.0 sürümünü destekler.
Google Mobil Reklamlar Unity Eklentisi sürüm 8.4.1 ile geliştirilip test edilmiştir.

Sürüm 3.1.5

Bağdaştırıcı içeriği GoogleMobileAds/Mediation/DTExchange/ klasörüne taşındı.
Bağdaştırıcı ad alanı, GoogleMobileAds.Mediation.DTExchange kullanılacak şekilde yeniden düzenlendi.
DT Exchange Android adaptörü 8.2.3.0 sürümünü destekler.
DT Exchange iOS bağdaştırıcısı 8.2.1.0 sürümünü destekler.
Google Mobil Reklamlar Unity Eklentisi sürüm 8.1.0 ile geliştirilip test edilmiştir.

Sürüm 3.1.4

DT Exchange Android adaptörü sürüm 8.2.2.0'ı destekler.
DT Exchange iOS bağdaştırıcısı 8.1.9.1 sürümünü destekler.
Google Mobil Reklamlar Unity Eklentisi sürüm 7.4.1 ile geliştirilip test edilmiştir.

Sürüm 3.1.3

DT Exchange Android adaptörü sürüm 8.2.1.0'ı destekler.
DT Exchange iOS bağdaştırıcısı 8.1.9.0 sürümünü destekler.
Google Mobil Reklamlar Unity Eklentisi sürüm 7.4.0 ile geliştirilip test edilmiştir.

Sürüm 3.1.2

Unity uyumlulaştırma eklentisinin adı "DT Exchange" olarak yeniden adlandırıldı.
GoogleMobileAds.Api.Mediation.Fyber.Fyber sınıfı GoogleMobileAds.Api.Mediation.DTExchange.DTExchange olarak yeniden adlandırıldı.
DT Exchange Android adaptörü sürüm 8.2.1.0'ı destekler.
DT Exchange iOS bağdaştırıcısı 8.1.7.0 sürümünü destekler.
Google Mobil Reklamlar Unity Eklentisi sürüm 7.3.1 ile geliştirildi ve test edildi.

Sürüm 3.1.1

Aşağıdaki yöntemler Fyber sınıfına eklendi:
- SetCCPAString(string)
- ClearCCPAString()
Fyber Android adaptörü sürüm 8.2.0.0'ı destekler.
Fyber iOS bağdaştırıcısı 8.1.6.0 sürümünü destekler.
Google Mobil Reklamlar Unity Eklentisi sürüm 7.3.0 ile geliştirilip test edilmiştir.

Sürüm 3.1.0

Fyber Android adaptörü sürüm 8.2.0.0'ı destekler.
Fyber iOS bağdaştırıcısı 8.1.5.0 sürümünü destekler.
Google Mobil Reklamlar Unity Eklentisi sürüm 7.2.0 ile geliştirilip test edilmiştir.

Sürüm 3.0.2

Fyber Android adaptörü sürüm 8.1.3.1'i destekler.
Fyber iOS bağdaştırıcısı 8.1.5.0 sürümünü destekler.
Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.2 ile geliştirilip test edilmiştir.

Sürüm 3.0.1

Fyber Android adaptörü sürüm 8.1.3.0'ı destekler.
Fyber iOS bağdaştırıcısı 8.1.4.0 sürümünü destekler.
Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.0 ile geliştirilip test edilmiştir.

Sürüm 1.1.0

GDPR şartlarını desteklemek için Fyber sınıfına aşağıdaki yöntemler eklendi:
- SetGDPRConsent()
- SetGDPRConsentString()
- ClearGDPRConsentData()
Fyber Android adaptörü sürüm 7.3.4.0'ı destekler.
Fyber iOS bağdaştırıcısı 7.5.0.0 sürümünü destekler.

Sürüm 1.0.0

İlk sürüm!
Fyber Android adaptörü sürüm 7.3.4.0'ı destekler.
Fyber iOS bağdaştırıcısı 7.4.0.0 sürümünü destekler.