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 bölümde, 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 uygulamaya nasıl Flutter 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
- En yeni Google Mobile Ads SDK'sı
- Flutter 3.7.0 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 üstü iOS dağıtım hedefi
- Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Flutter 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 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
pub.dev üzerinden entegrasyon
Aşağıdaki bağımlılığı paketinizin pubspec.yaml dosyasınaDT Exchange SDK ve bağdaştırıcının en son sürümleriyle ekleyin:
dependencies:
gma_mediation_dtexchange: ^1.0.0
Manuel Entegrasyon
DT Exchange için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü (ve içeriğini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızdaki eklentiye başvurun:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
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.
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 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 için Google Mobile Ads uyumlulaştırma eklentisi, izin bilgilerinin DT Exchange SDK'sına iletilmesini desteklemez.
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ü. |
1.0.0
- İlk sürüm.
- DT Exchange Android adaptörü sürüm 8.2.6.1 ile doğrulanmış uyumluluk
- DT Exchange iOS adaptörü 8.2.7.0 sürümü ile doğrulanmış uyumluluk