Bu kılavuz, uyumlaştırma kullanarak myTarget'tan reklam yüklemek ve göstermek için Google Mobile Ads SDK'sının nasıl kullanılacağını şelale entegrasyonlarını kapsayarak açıklar. Bu açıklamalar, myTarget'ın bir reklam biriminin uyumlaştırma yapılandırmasına nasıl ekleneceğini ve myTarget SDK'sının ve bağdaştırıcısının bir Flutter uygulamasına nasıl entegre edileceğini kapsar.
Desteklenen entegrasyonlar ve reklam biçimleri
Entegrasyon | |
---|---|
Teklifli sistem | |
Şelale | |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü | |
Ödüllü geçiş reklamı | |
Doğal |
Ş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 23 veya üstü
- iOS'te dağıtmak için
- iOS 12.0 veya üzeri sürüm 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şlangıç başlıklı makaleyi inceleyin.
- Uyumlulaştırma Başlangıç Kılavuzu'nu tamamlama
1. adım: myTarget kullanıcı arayüzünde yapılandırmaları ayarlayın
myTarget hesabınıza giriş yapın. Başlıktaki UYGULAMALAR'ı tıklayarak Uygulamalar sayfasına gidin. UYGULAMA EKLE'yi tıklayarak uygulamanızı ekleyin.
Uygulamanız hem Android hem de iOS platformlarını destekliyorsa her birini ayrı ayrı ayarlamanız gerekir.
Android
Ardından, uygulamanızın Google Play URL'sini girin.
iOS
Ardından, uygulamanızın iTunes URL'sini** girin.
myTarget, uygulama eklerken işlemi tamamlayabilmeniz için önce bir reklam birimi oluşturmanızı gerektirir.
Banner
Kullanılabilir reklam biçimleri arasından BANNER'ı seçin ve REKLAM BİRİMİ EKLE düğmesini tıklayın.
Geçiş reklamı
Kullanılabilir reklam biçimleri arasından GEÇİŞ REKLAMI'nı seçin ve REKLAM BİRİMİ EKLE düğmesini tıklayın.
Ödüllü
Kullanılabilir reklam biçimleri arasından ÖDÜLLÜ VİDEO'yu seçin ve REKLAM BİRİMİ EKLE düğmesini tıklayın.
Yerel biçim
Kullanılabilir reklam biçimleri arasından DOĞAL'ı seçin ve REKLAM BİRİMİ EKLE'yi tıklayın.
Reklam biriminizin ayrıntılar sayfasında, reklam birimi ayarlarının altında slot_id olarak bulunan alan kimliğinizi not edin. Bu yuva kimliği, sonraki bölümde AdMob reklam biriminizi ayarlamak için kullanılacaktır.
AdMob reklam birimi kimliğinizi ayarlamak için slot_id'ye ek olarak myTarget Permanent Access Token'ınız da gerekir. Profil sekmesine gidip Erişim jetonları'nı seçin. myTarget kalıcı erişim jetonunuzu görüntülemek için Jeton Oluştur veya Jetonu Göster'i tıklayın.
app-ads.txt dosyanızı güncelleme
Uygulamalar İçin Yetkili Satıcılar app-ads.txt, uygulama reklamı envanterinizin yalnızca yetkili olarak tanımladığınız kanallar üzerinden satılmasını sağlamaya yardımcı olan bir IAB Tech Lab girişimidir. Reklam gelirinde önemli ölçüde kayıp yaşanmasını önlemek için bir app-ads.txt
dosyası uygulamanız gerekir.
Bunu henüz yapmadıysanız
uygulamanız için bir app-ads.txt dosyası oluşturun.
myTarget için app-ads.txt
uygulamak istiyorsanız Dosya oluşturma ve yayınlama başlıklı makaleye bakın.
Test modunu etkinleştirme
myTarget kullanıcı arayüzünde bir test cihazı eklemek ve yapılandırmak için myTarget'ın dokümanlarındaki talimatları uygulayın.
2. adım: AdMob kullanıcı arayüzünde myTarget talebini ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Android
Talimatlar için Android kılavuzundaki 2. adıma bakın.
iOS
Talimatlar için iOS kılavuzundaki 2. adıma bakın.
Mail.ru'yu GDPR ve ABD eyalet yönetmelikleri reklam iş ortakları listesine ekleme
AdMob kullanıcı arayüzünde Mail.ru'yu AB ve ABD eyalet düzenlemeleri reklam iş ortakları listesine eklemek için AB tüzükleri ayarları ve ABD eyalet düzenlemeleri ayarları bölümlerindeki adımları uygulayın.
3. adım: myTarget SDK'sını ve bağdaştırıcısını içe aktarın
pub.dev üzerinden entegrasyon
Paketinizin pubspec.yaml
dosyasına myTarget SDK'sının ve bağdaştırıcısının en yeni sürümleriyle birlikte aşağıdaki bağımlılığı ekleyin:
dependencies:
gma_mediation_mytarget: ^
Manuel Entegrasyon
myTarget için Google Mobil Reklamlar aracılık eklentisinin en son sürümünü indirin,
indirilen dosyayı çıkarın ve çıkarılan eklenti klasörünü
(ve içeriğini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml
dosyanızda eklentiye referans verin:
dependencies:
gma_mediation_mytarget:
path: path/to/local/package
4. adım: myTarget SDK'sındaki gizlilik ayarlarını uygulayın
Talimatlar için Android ve iOS kılavuzundaki 4. adıma bakın.
5. adım: Gerekli kodu ekleyin
Android
myTarget entegrasyonu için ek kod gerekmez.
iOS
SKAdNetwork entegrasyonu
SKAdNetwork tanımlayıcılarını projenizin Info.plist
dosyasına eklemek için myTarget'ın 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 ve myTarget kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.
Test reklamlarını doğrulama
myTarget'tan test reklamları aldığınızı doğrulamak için myTarget (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
Hata kodları
Adaptör myTarget'tan reklam alamıyorsa yayıncılar aşağıdaki sınıflarda ResponseInfo
kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:
Android
com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter
iOS
GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded
Bir reklam yüklenemediğinde myTarget bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:
Android
Hata kodu | Neden |
---|---|
100 | myTarget SDK'sı hata döndürdü. |
101 | AdMob kullanıcı arayüzünde yapılandırılan myTarget sunucu parametreleri eksik veya geçersiz. |
102 | İstenen reklam boyutu, myTarget tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
103 | Reklam isteği, birleştirilmiş yerel reklam isteği değil. |
104 | myTarget'tan yüklenen yerel reklam, istenen yerel reklamdan farklı. |
105 | myTarget'tan yüklenen yerel reklamda bazı zorunlu öğeler (ör. resim veya simge) eksik. |
iOS
Hata kodu | Neden |
---|---|
100 | myTarget SDK'sında henüz bir reklam bulunmuyor. |
101 | AdMob kullanıcı arayüzünde yapılandırılan myTarget sunucu parametreleri eksik veya geçersiz. |
102 | myTarget bağdaştırıcısı, istenen reklam biçimini desteklemiyor. |
103 | Yüklenmemiş bir myTarget reklamı göstermeye çalışıldı. |
104 | İstenen reklam boyutu, myTarget tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
105 | Gerekli yerel reklam öğeleri eksik. |
myTarget Flutter Uyumlulaştırma Adaptörü Değişiklik Günlüğü
Sürüm 1.4.0
- myTarget Android bağdaştırıcı sürümü 5.27.2.0'ı destekler.
- myTarget iOS bağdaştırıcı sürümü 5.33.0.0 desteklenir.
- Google Mobile Ads Flutter eklentisi 6.0.0 sürümüyle oluşturulmuş ve test edilmiştir.
Sürüm 1.3.0
- myTarget Android bağdaştırıcı sürümü 5.27.1.1 desteklenir.
- myTarget iOS bağdaştırıcı sürümü 5.31.1.0'ı destekler.
- Google Mobile Ads Flutter eklentisi 6.0.0 sürümüyle oluşturulmuş ve test edilmiştir.
Sürüm 1.2.0
- myTarget Android bağdaştırıcı sürümü 5.27.1.1 desteklenir.
- myTarget iOS bağdaştırıcısı 5.29.1.0 sürümünü destekler.
- Google Mobile Ads Flutter eklentisi 6.0.0 sürümüyle oluşturulmuş ve test edilmiştir.
Sürüm 1.1.0
- myTarget Android bağdaştırıcı sürümü 5.27.1.1 desteklenir.
- myTarget iOS adaptörünün 5.28.0.0 sürümünü destekler.
- Google Mobile Ads Flutter eklentisi 6.0.0 sürümüyle oluşturulmuş ve test edilmiştir.
Sürüm 1.0.0
- İlk sürüm.
- myTarget Android bağdaştırıcı sürümü 5.27.1.0 desteklenir.
- myTarget iOS bağdaştırıcısı 5.24.1.0 sürümünü destekler.
- Google Mobile Ads Flutter eklentisi 5.3.1 sürümüyle oluşturulmuş ve test edilmiştir.