maio'yu uyumlulaştırma ile entegre etme

Bu kılavuz, uyumlaştırma kullanarak maio'dan 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, maio'nun bir reklam biriminin uyumlaştırma yapılandırmasına nasıl ekleneceğini ve maio SDK'sının ve bağdaştırıcısının bir Flutter uygulamasına nasıl entegre edileceğini kapsar.

maio'nun kontrol paneli arayüzünde etiketler, düğmeler ve açıklamalar için Japonca metinler kullanılıyor. Bu kılavuzdaki ekran görüntüleri çevrilmedi. Ancak buradaki açıklamalarda ve talimatlarda etiketler ve düğmeler, İngilizce dilindeki karşılıklarıyla ifade edilir. Örneğin, "URL スキーム" ifadesi "URL Scheme" (URL Şeması) anlamına gelir.

Desteklenen entegrasyonlar ve reklam biçimleri

maio için uyumlaştırma adaptörünün özellikleri şöyledir:

Entegrasyon
Teklifli sistem
Şelale
Formatlar
Banner
Geçiş Reklamları
Ödüllü
Yerel biçim

Ş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: maio kullanıcı arayüzünde yapılandırmaları ayarlayın

Öncelikle maio hesabınıza kaydolun veya giriş yapın. Sol kenar çubuğunda Uygulama yönetimi düğmesini ve Yeni uygulama'yı tıklayın.

Tercih ettiğiniz reklam türüne karşılık gelen sekmeyi seçin.

Geçiş reklamı

Uygulamanızın Adı'nı girin, platformu seçin ve Uygulama URL'nizi sağlayın. Reklam Türü olarak Video geçiş reklamı'nı seçin ve Güncelle'yi tıklayın.

Android

iOS

Ödüllü

Uygulamanızın Adı'nı girin, platformu seçin ve Uygulama URL'nizi sağlayın. Reklam Türü olarak Ödüllü Video'yu seçin ve Güncelle'yi tıklayın.

Android

iOS

Uygulama Yönetimi sayfasında Medya Kimliği'ni not edin. Bir sonraki bölümde AdMob reklam biriminizi ayarlamak için gereklidir.

Android

iOS

Zone Management (Bölge Yönetimi) sayfasında Zone ID'yi (Bölge Kimliği) not edin. Ayrıca, bir sonraki bölümde AdMob reklam biriminizi ayarlamak için de gereklidir.

Android

iOS

(Yalnızca şelale) Uyumlulaştırma için reklam birimi kimliğinizi ayarlamak üzere Medya Kimliği ve Bölge Kimliği'ne ek olarak API Kimliği ve API ANAHTARI'na da ihtiyacınız olacaktır. Reporting API sayfasında API ID ve API KEY değerlerini not edin.

2. adım: AdMob kullanıcı arayüzünde maio 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.

3. adım: maio SDK'sını ve bağdaştırıcısını içe aktarın

pub.dev üzerinden entegrasyon

Paketinizin pubspec.yaml dosyasına, maio SDK'sının ve bağdaştırıcısının en son sürümleriyle birlikte aşağıdaki bağımlılığı ekleyin:

dependencies:
  gma_mediation_maio: ^

Manuel Entegrasyon

maio 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_maio:
    path: path/to/local/package

4. adım: Gerekli kodu ekleyin

Android

maio entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için maio'nun dokümanlarını inceleyin.

5. adım: Uygulamanızı test edin

Test reklamlarını etkinleştirme

AdMob için test cihazınızı kaydettiğinizden emin olun.

Google Mobile Ads SDK'sının 7.26.0 veya daha sonraki bir sürümünü kullanan yayıncılar, istekte bulunduklarında test cihazları olarak kaydedilen telefon ve tabletlerde maio'dan otomatik olarak test reklamları alır.

Test reklamlarını doğrulama

maio'dan test reklamları aldığınızı doğrulamak için maio (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

Hata kodları

Adaptör maio'dan reklam alamıyorsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Android

Biçim Sınıf adı
Geçiş reklamı jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Ödüllü jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

Biçim Sınıf adı
Geçiş reklamı GADMMaioInterstitialAdapter
Ödüllü GADMMaioRewardedAdapter

Bir reklam yüklenemediğinde maio bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

Android

Hata kodu Neden
0-10 maio, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için kodu ve maio'nun dokümanlarını inceleyin.
101 Maio'da reklam bulunmuyor.
102 Geçersiz sunucu parametreleri (ör. yerleşim kimliği eksik).
103 Bir reklamı yüklemek için kullanılan bağlam bir "Etkinlik" örneği değildi.

iOS

Hata kodu Neden
0-10 maio, SDK'ya özgü bir hata döndürdü. Daha fazla bilgi için maio'nun koduna bakın.
101 maio'da henüz reklam yok.
102 Geçersiz sunucu parametreleri (ör. yerleşim kimliği eksik).
103 maio bağdaştırıcısı, istenen reklam biçimini desteklemiyor.
104 Bu ağ yapılandırması için bir reklam zaten yüklenmiş.

maio Flutter Uyumlulaştırma Adaptörü Değişiklik Günlüğü

Sürüm 1.0.3

Sürüm 1.0.2

Sürüm 1.0.1

Sürüm 1.0.0