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 Flutter edileceği açıklanmaktadı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 verme | |
| Şelale | |
| Formatlar | |
| Banner | |
| Geçiş reklamı | |
| Ödüllü | |
Şartlar
- En son Google Mobile Ads SDK'sı
- Flutter 3.7.0 veya üzeri
- 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 Mobile Ads SDK'sı ile yapılandırılmış Flutter çalışan bir proje. Ayrıntılar için Başlayın 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 ekleme
DT Exchange Console'a 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.
Yapay Zeka
iOS
Yerleşiminizi Adlandırın alanına 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ği'ne dikkat edin.
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.
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 AdMob kullanıcı arayüzünde 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
DT Exchange'i (Fyber Monetization) AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için GDPR ayarları ve ABD eyalet düzenlemeleri ayarlarında belirtilen adımları uygulayın.
3. Adım: DT Exchange SDK'sını ve bağdaştırıcısını içe aktarın
pub.dev aracılığıyla entegrasyon
Aşağıdaki bağımlılığı
DT Exchange Paketinizdeki SDK ve bağdaştırıcı
pubspec.yaml dosyası:
dependencies:
gma_mediation_dtexchange: ^1.0.0
Manuel Entegrasyon
Şu hesap için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin:
DT Exchange,
indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü ekleyin.
(ve içeriklerini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızdaki eklentiye referans verin:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
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, cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı (AEA)'daki kullanıcılara 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) 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 bir 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.
DT Exchange için Google Mobile Ads uyumlulaştırma eklentisi, izin bilgilerinin DT Exchange SDK'sına iletilmesini desteklemez.
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 seçeneği sunmayı zorunlu kılıyor. 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ı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 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 için Google Mobile Ads uyumlulaştırma eklentisi, izin bilgilerinin DT Exchange SDK'sına iletilmesini desteklemez.
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ş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ı
Adaptör DT Exchange'ten reklam alamıyorsa yayıncılar aşağıdaki sınıfın altındaki ResponseInfo öğesini 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ılmış 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ö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 belgelere bakın. |
| 101 | AdMob kullanıcı arayüzünde yapılandırılmış 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ığı için DT Exchange reklamları gösterilemedi. |
| 105 | DT Exchange SDK'sı başlatma hatası döndürdü. |
DT Exchange Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü
Sonraki Sürüm
- Google Mobile Ads Flutter eklentisi 5.2.0 sürümü ile oluşturulup test edilmiştir.
1.1.0
- DT Exchange Android bağdaştırıcısının 8.3.0.0 sürümü ile uyumlu olduğu doğrulandı.
- DT Exchange iOS bağdaştırıcısı sürüm 8.3.1.0 ile uyumluluk doğrulandı.
- Google Mobile Ads Flutter eklentisi 5.1.0 sürümü ile oluşturulup test edilmiştir.
1.0.0
- İlk sürüm.
- DT Exchange Android bağdaştırıcısının 8.2.7.0 sürümü ile uyumlu olduğu doğrulandı.
- DT Exchange iOS adaptörü 8.2.8.0 sürümü ile uyumluluğu doğrulandı.
- Google Mobile Ads Flutter eklentisi 5.1.0 sürümüyle geliştirilip test edilmiştir.