myTarget'ı uyumlulaştırmayla entegre etme

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.

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

Sürüm 1.3.0

Sürüm 1.2.0

Sürüm 1.1.0

Sürüm 1.0.0