Bu kılavuzda, şelale entegrasyonlarını kapsayan arabuluculuk kullanarak DT Exchange'ten reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, DT Exchange'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve DT Exchange SDK'sının ve bağdaştırıcının bir Flutter uygulamasına nasıl entegre edileceği ele alınmaktadır.
Desteklenen entegrasyonlar ve reklam biçimleri
DT Exchange için Flutter 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 sonraki sürümler
- Android'de dağıtmak için
- Android API düzeyi 21 veya sonraki sürümler
- 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ış çalışan bir Flutter projesi. Ayrıntılar için Başlayın bölümüne bakın.
- Uyumlulaştırmayı 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 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 etiketli alana yeni yerleşimin adını 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'ni not 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: AdMob kullanıcı arayüzünde DT Exchange talebini ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Yapay Zeka
Talimatlar için Android kılavuzundaki 2. adıma bakın.
iOS
Talimatlar için iOS kılavuzunun 2. adımına bakın.
DT Exchange'i GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme
DT Exchange (Fyber Monetization)'i AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için GDPR ayarlarındaki ve ABD eyalet düzenlemeleri ayarlarındaki 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 üzerinden entegrasyon
Paketinizin pubspec.yaml dosyasına DT Exchange SDK'sının ve bağdaştırıcının en son sürümleriyle aşağıdaki bağımlılığı ekleyin:
dependencies:
gma_mediation_dtexchange: ^1.0.0
Manuel Entegrasyon
DT Exchange için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı ayıklayı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 referans verin:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
4. Adım: DT Exchange SDK'sına gizlilik ayarlarını uygulayın
AB Kullanıcı Rızası ve GDPR
Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili 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) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.
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ımına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılar. Bu 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ı 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 her reklam ağı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ştirme
AdMob için test cihazınızı kaydettiğinizden emin olun.
Test reklamlarını doğrulama
DT Exchange'ten test reklamları aldığınızı doğrulamak için DT Exchange (Şelale) 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 altında ResponseInfo 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ılan 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österilmeye hazır değil. |
| 200-399 | DT Exchange SDK'sı hata döndürdü. Daha fazla bilgi için kod bölümüne bakın. |
iOS
| Hata kodu | Neden |
|---|---|
| 0-10 | DT Exchange SDK'sı hata döndürdü. Daha fazla ayrıntı için dokümanları inceleyin. |
| 101 | AdMob kullanıcı arayüzünde yapılandırılan 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ığından DT Exchange reklamları gösterilemedi. |
| 105 | DT Exchange SDK'sı bir ilk başlatma hatası döndürmüştür. |
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 adaptörü 8.3.0.0 sürümüyle uyumluluğu doğrulanmıştır.
- DT Exchange iOS adaptörü 8.3.1.0 sürümüyle uyumluluğu 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 adaptörü 8.2.7.0 sürümü ile uyumluluğ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ü ile oluşturulup test edilmiştir.