Bu kılavuzda, şelale entegrasyonlarını ele alan ve uyumlulaştırmayı kullanarak 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, DT Exchange'in reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve DT Exchange SDK ile bağdaştırıcısının bir uygulamaya nasıl entegre Unity edileceği açıklanmaktadır.
Desteklenen entegrasyonlar ve reklam biçimleri
DT Exchange 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
- En son Google Mobile Ads SDK'sı
- Unity 4 veya sonraki sürümler
- Android'de dağıtım yapmak için
- Android API düzeyi 21 veya üstü
- iOS'te dağıtım yapmak 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 proje. 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.
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.
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.
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.
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 ekleyin
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ısını içe aktarın
Changelog'daki indirme bağlantısını kullanarak DT Exchange için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsFyberMediation.unitypackage
öğesini çıkarın.
Unity proje düzenleyicinizde Assets > Import Package > CustomPackage'ı (Öğeler > Paketi İçe Aktar > Özel Paket) 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.
Sonra, Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici > Zorla Çöz'ü seçin. Unity Play Hizmetleri Çözümleyici 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.
4. Adım: Gizlilik ayarlarını DT Exchange SDK'sında uygulayın
AB Kullanıcı Rızası ve GDPR
Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcıların ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara belirli açıklamaların yapıldığından ve bu kullanıcılardan alınan izinlerin alındığından emin olmanız 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 toplayabilecek, alabilecek veya kullanabilecek tüm reklam ağlarını tanımlamalı ve her ağın kullanımı hakkında bilgi sağlamalısınız. 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, SetGDPRRequired()
ve SetGDPRConsentString()
yöntemleriyle Fyber
sınıfını 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östermektedir:
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ılmasını" (yasaların bu terimlerin tanımladığı şekilde) devre dışı bırakma seçeneği sunmasını gerektirir. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" bağlantısıyla sunulur. ABD eyalet gizlilik yasalarına 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 tüm reklam ağlarına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgi satışına katılabilecek her bir reklam ağını belirlemeli ve uygunluğu sağlamak için bu ağların her birinin talimatlarını takip etmelisiniz.
DT Exchange sürüm 3.1.1 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 iletmenizi sağladı. Aşağıdaki örnek kod, bu parametrelerin DT Exchange bağdaştırıcısına nasıl iletileceğini göstermektedir:
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 belgelerini uygulayın.
6. Adım: Uygulamanızı test edin
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ında temel alınan 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 gönderilen kodlar ve beraberindeki mesajlar şunlardır:
Android
Hata kodu | Neden |
---|---|
101 | Kullanıcı arayüzünde yapılandırılan 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'sı hata döndürdü. Daha fazla bilgi için koda bakın. |
iOS
Hata kodu | Neden |
---|---|
0-10 | DT Exchange SDK'sı hata döndürdü. Daha fazla ayrıntı için belgeleri inceleyin. |
101 | Kullanıcı arayüzünde yapılandırılan 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ı başlatma hatası döndürdü. |
DT Exchange Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü
Sürüm 3.2.0
- DT Exchange Android bağdaştırıcısı 8.2.7.0 sürümünü destekler.
- DT Exchange iOS bağdaştırıcısı 8.3.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.12
- DT Exchange Android bağdaştırıcısı 8.2.7.0 sürümünü destekler.
- DT Exchange iOS bağdaştırıcısı 8.2.8.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.11
- DT Exchange Android bağdaştırıcısı 8.2.7.0 sürümünü destekler.
- DT Exchange iOS bağdaştırıcısı 8.2.7.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.10
- DT Exchange Android bağdaştırıcısı 8.2.6.1 sürümünü destekler.
- DT Exchange iOS bağdaştırıcısı 8.2.7.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.8
- DT Exchange Android bağdaştırıcısı 8.2.5.0 sürümünü destekler.
- DT Exchange iOS bağdaştırıcısı 8.2.6.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 8.6.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.7
- DT Exchange Android bağdaştırıcısı 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 8.5.2 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.6
- DT Exchange Android bağdaştırıcısı 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 8.4.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.5
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/DTExchange/
hedefine taşındı. - Bağdaştırıcı ad alanı,
GoogleMobileAds.Mediation.DTExchange
kullanılacak şekilde yeniden düzenlendi. - DT Exchange Android bağdaştırıcısı 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 8.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.4
- DT Exchange Android bağdaştırıcısı 8.2.2.0 sürümünü destekler.
- DT Exchange iOS bağdaştırıcısı 8.1.9.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.4.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.3
- DT Exchange Android bağdaştırıcısı 8.2.1.0 sürümünü destekler.
- DT Exchange iOS bağdaştırıcısı 8.1.9.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.4.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.2
- Unity uyumlulaştırma eklentisi adı "DT Exchange" olarak değiştirildi.
GoogleMobileAds.Api.Mediation.Fyber.Fyber
sınıfıGoogleMobileAds.Api.Mediation.DTExchange.DTExchange
olarak yeniden adlandırıldı.- DT Exchange Android bağdaştırıcısı 8.2.1.0 sürümünü destekler.
- DT Exchange iOS bağdaştırıcısı 8.1.7.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 7.3.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.1
Fyber
sınıfına aşağıdaki yöntemler eklendi:SetCCPAString(string)
ClearCCPAString()
- Fyber Android bağdaştırıcısının 8.2.0.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 8.1.6.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.3.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.1.0
- Fyber Android bağdaştırıcısının 8.2.0.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 8.1.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.2.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.0.2
- Fyber Android bağdaştırıcısının 8.1.3.1 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 8.1.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.2 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.0.1
- Fyber Android bağdaştırıcısının 8.1.3.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 8.1.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.0.0
- Fyber Android bağdaştırıcısının 8.1.2.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 8.1.2.0 sürümünü destekler.
Sürüm 2.0.0
- Fyber Android bağdaştırıcısının 7.8.4.1 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 8.0.0.0 sürümünü destekler.
Sürüm 1.6.1
- Fyber Android bağdaştırıcısının 7.8.3.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.8.6.0 sürümünü destekler.
Sürüm 1.6.0
- Fyber Android bağdaştırıcısının 7.8.2.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.8.5.0 sürümünü destekler.
Sürüm 1.5.2
- Fyber Android bağdaştırıcısının 7.7.4.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.7.3.0 sürümünü destekler.
Sürüm 1.5.1
- Fyber Android bağdaştırıcısının 7.7.2.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.7.2.0 sürümünü destekler.
Sürüm 1.5.0
- Fyber Android bağdaştırıcısının 7.7.1.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.7.1.0 sürümünü destekler.
Sürüm 1.4.0
- Fyber Android bağdaştırıcısının 7.7.0.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.6.4.0 sürümünü destekler.
Sürüm 1.3.0
- Fyber Android bağdaştırıcısının 7.6.0.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.6.0.0 sürümünü destekler.
Sürüm 1.2.3
- Fyber Android bağdaştırıcısının 7.5.4.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.5.6.0 sürümünü destekler.
Sürüm 1.2.2
- Fyber Android bağdaştırıcısının 7.5.3.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.5.4.0 sürümünü destekler.
Sürüm 1.2.1
- Fyber Android bağdaştırıcısının 7.5.2.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.5.3.0 sürümünü destekler.
Sürüm 1.2.0
- Fyber Android bağdaştırıcısının 7.5.0.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.5.1.0 sürümünü destekler.
Sürüm 1.1.0
- GDPR koşullarını desteklemek için
Fyber
sınıfına aşağıdaki yöntemler eklendi:SetGDPRConsent()
SetGDPRConsentString()
ClearGDPRConsentData()
- Fyber Android bağdaştırıcısının 7.3.4.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.5.0.0 sürümünü destekler.
Sürüm 1.0.0
- İlk çıkış tarihi!
- Fyber Android bağdaştırıcısının 7.3.4.0 sürümünü destekler.
- Fyber iOS bağdaştırıcısının 7.4.0.0 sürümünü destekler.