maio'yu uyumlulaştırma ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını kapsayacak şekilde aracılık kullanarak maio'dan reklam yüklemek ve göstermek için Google Mobile Ads SDK'sını nasıl kullanacağınız gösterilmektedir. Bu dokümanda, maio'nun bir reklam biriminin aracılık yapılandırmasına nasıl ekleneceği ve maio SDK'sının ve bağdaştırıcısının bir Flutter uygulamasına nasıl entegre edileceği açıklanmaktadır.

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 arabuluculuk bağdaştırıcısı aşağıdaki özelliklere sahiptir:

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

Şartlar

  • 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 23 veya üstü
  • iOS'te dağıtmak için
    • iOS 12.0 veya sonraki bir sürümün 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ırmayı tamamlama Başlangıç kılavuzu

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 Video Ödülleri'ni 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 Anahtarı da gerekir. 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 aracılık 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 yeni 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 reklam inceleyicide maio (Şelale) reklam kaynaklarını kullanarak tek reklam kaynağı testini etkinleştirin.

Hata kodları

Adaptör, maio'dan reklam alamazsa yayıncılar aşağıdaki sınıflar altında 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 şunlardır:

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 belgelerini 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 Bağdaştırıcısı Değişiklik Günlüğü

Sürüm 1.0.3 (Devam ediyor)

Sürüm 1.0.2

Sürüm 1.0.1

Sürüm 1.0.0