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 kullanan, DT Exchange'den gelen şelale entegrasyonları. DT Exchange'in bir reklam birimine nasıl ekleneceği uyumlulaştırma yapılandırması ve DT Exchange SDK ile bağdaştırıcısının nasıl entegre edileceği bir uygulamaya Unity dönüştürün.
Desteklenen entegrasyonlar ve reklam biçimleri
DT Exchange AdMob uyumlulaştırma bağdaştırıcısında şu özelliklerden yararlanabilirsiniz:
Entegrasyon | |
---|---|
Teklif verme | |
Şelale | |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü |
Şartlar
- En son Google Mobile Ads SDK'sı .
- Unity 4 veya sonraki sürümler .
- Android'de dağıtmak için
- Android API düzeyi 21 veya üstü
- iOS'te dağıtmak için
- 12.0 veya sonraki bir iOS dağıtım hedefi
- Google ile yapılandırılmış, çalışan bir Unity proje Mobile Ads SDK'sı. Görüntüleyin Ayrıntılı bilgi için Başlarken.
- 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.
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
DT için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin
Şuradaki indirme bağlantısından değiştirin:
Changelog (Değişiklik günlüğü) ve ayıklama
GoogleMobileAdsFyberMediation.unitypackage
.
Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel
Paketleyin ve GoogleMobileAdsFyberMediation.unitypackage
dosyasını bulun.
indirildi. 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 > Kuvvet
Çöz'e dokunun. Unity Play Hizmetleri Çözümleyici kitaplığı bağımlılık gerçekleştirir
ve beyan edilen bağımlılıkları
Unity uygulamanızın Assets/Plugins/Android
dizini.
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.
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 eklentisine
SetGDPRRequired()
ve SetGDPRConsentString()
yöntemleriyle Fyber
sınıfı,
DT Exchange'e manuel olarak iletmenizi sağlar. Aşağıdakiler
bu parametrelerin DT Exchange'e nasıl iletileceğini gösteren örnek kod
adaptör:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");
DT Exchange'in GDPR bölümüne bakın ve yöntemde sağlanabilecek değerleri öğrenin.
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.
DT Exchange sürüm 3.1.1 için Google Mobile Ads uyumlulaştırma eklentisine
SetCCPAString()
yöntemiyle Fyber
sınıf üzerinden izinleri iletin
DT Exchange'e manuel olarak gönderebilirsiniz. Aşağıdaki örnek kod,
aşağıdaki kodu DT Exchange bağdaştırıcısına iletin:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetCCPAString("myCCPAConsentString");
// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();
DT Exchange'in CCPA Açılış sayfasını ziyaret edin Kaynak bölümüne bakın ve yöntemde sağlanabilecek değerleri öğrenin.
5. Adım: Gerekli kodu ekleyin
Android
DT Exchange entegrasyonu için ek kod gerekmez.
iOS
SKAdNetwork entegrasyonu
DT Exchange'in
belgeleri
kullanarak projenizin Info.plist
dosyasına SKAdNetwork tanımlayıcılarını ekleyin.
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
kullanarak reklam yanıtından gelen temel hata
ResponseInfo
takip etmek için:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
DT Exchange bağdaştırıcısı tarafından gönderilen kodlar ve gelen iletiler aşağıda verilmiştir Reklam yüklenemedi:
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ü. Kodu inceleyin inceleyebilirsiniz. |
iOS
Hata kodu | Neden |
---|---|
0-10 | DT Exchange SDK'sı hata döndürdü. Belgelere göz atın inceleyebilirsiniz. |
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.3.0
DummyClient
adlı dosyaPlaceholderClient
olarak yeniden adlandırıldı.- DT Exchange Android bağdaştırıcısı 8.3.0.0 sürümünü destekler.
- DT Exchange iOS bağdaştırıcısı 8.3.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.2.1
- 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.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.1 sürümüyle geliştirilip test edilmiştir.
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 şartları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.