Maio'yu Uyumlulaştırma ile entegre etme

Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl maio reklamları uyumlulaştırma, ele alacağız. Bir reklam biriminin uyumlulaştırma yapılandırması ve maio SDK ile bağdaştırıcının Android uygulamasını kullanın.

maio'nun kontrol paneli arayüzündeki etiketler, düğmeler ve etiketler için Japonca metin kullanılır. ve bu kılavuzdaki ekran görüntüleri çevrilmemiştir. Ancak bu kılavuzun açıklama ve talimatlarında etiketler ve düğmeler İngilizcedeki eşdeğerleriyle referansta bulunulması gerekir. "URL ホテーム," örneğin, "URL Şeması"dır.

Desteklenen entegrasyonlar ve reklam biçimleri

Maio için 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ü
Yerel biçim

Şartlar

  • Android API düzeyi 21 veya üstü
  • maio SDK 1.0.7 veya sonraki sürümler

1. adım: maio kullanıcı arayüzünde yapılandırmaları ayarlayın

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

Tercih ettiğiniz Reklam Türü'ne karşılık gelen sekmeyi seçin.

Geçişli

Uygulamanızın adını girin, platformu seçin ve uygulama URL'nizi girin. Reklam Türü olarak Video geçiş reklamı'nı seçin ve ardından Güncelle'yi tıklayın.

Ödül olarak verildi

Uygulamanızın adını girin, platformu seçin ve uygulama URL'nizi girin. Reklam Türü olarak Video Ödülleri'ni seçin ve Güncelle'yi tıklayın.

Uygulama Yönetimi sayfasında Medya Kimliği'ni not edin. Sonraki bölümde Ad Manager reklam biriminizi ayarlamanız gerekir.

Zone Management (Bölge Yönetimi) sayfasında Zone ID (Bölge Kimliği) değerini not edin. Sonraki bölümde reklam biriminizi Ad Manager oluşturmanız da gerekecektir.

Uyumlulaştırma için Media ID ve Zone ID'ye ek olarak API ID ve API KEY'e de ihtiyacınız vardır. Reporting API sayfasında, API ID ve API KEY'i not edin.

2. Adım: Kullanıcı arayüzünde maio talebini ayarlayın Ad Manager

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

Ad Manager hesabınızda oturum açın.

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın.

Getiri grubunuz için benzersiz bir Ad girin, Durum'u Etkin olarak ayarlayın, Reklam Biçimi'ni seçin ve Envanter türü'nü Mobil Uygulama olarak ayarlayın. Hedefleme > Envanter bölümünün altında Envanter ve Mobil uygulama altında uyumlulaştırma eklemek istediğiniz reklam birimini seçin.

Ardından, Getiri iş ortağı ekle düğmesini tıklayın.

maioiçin zaten bir Getiri iş ortağınız varsa bunu seçebilirsiniz. Aksi takdirde, Yeni bir getiri iş ortağı oluştur'u seçin.

Reklam ağı olarak maio'i seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin.

Otomatik veri toplama'yı açın ve önceki bölümde belirtilen API ID and API KEY değerini girin.

Getiri iş ortağı seçildikten sonra Entegrasyon türü olarak Mobil SDK Uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin. Bir önceki bölümde verilenMedia ID and Zone ID kodunu girin. Ardından, Varsayılan BGBM değerini girin.

olduğu gibi, hedeflenen uygulamayla ilişkilendirilmelidir.

İşiniz bittiğinde sayfanın alt kısmındaki Kaydet'i tıklayın.

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

Proje düzeyindeki settings.gradle.kts dosyanıza aşağıdakini ekleyin: depolar:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

Ardından, uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdakileri ekleyin: ve yapılandırmalarına değineceğiz. Chrome Web Mağazası'ndaki maio SDK ve bağdaştırıcısı:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

Manuel entegrasyon

  • Şu uygulamanın en son sürümünü indirin: maio Android SDK'sı oluşturun ve projenize ekleyin.
  • Google'ın Maven deposunda maio bağdaştırıcı yapıları'na gidin. En son sürümü seçin ve maio adaptörünün ".aar" dosyasını indirin. ve projenize ekleyin.

4. Adım: Gerekli kodu ekleyin

Maio Android entegrasyonu için ek kod gerekmez.

5. Adım: Uygulamanızı test etme

Test reklamlarını etkinleştir

Ad Manager.

Google Mobile Ads SDK'sının 11.6.0 veya sonraki bir sürümünü kullanan yayıncılar, istekte bulunurken test cihazı olarak kaydedilmiş telefon ve tabletlerdeki maio'dan otomatik test reklamlarını alır.

Test reklamlarını doğrulama

maioreklam kaynağından test reklamları aldığınızı doğrulamak için maio (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

Hata kodları

Bağdaştırıcı maio'dan bir reklam alamazsa yayıncılar reklam yanıtındaki temel hatayı . ResponseInfo.getAdapterResponses() şu sınıflarda:

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

Reklam yüklenemediğinde maio bağdaştırıcısı tarafından gönderilen kodlar ve beraberindeki mesajlar aşağıda verilmiştir:

Hata kodu Neden
0-10 maio, SDK'ya özel bir hata döndürdü. Kodu inceleyin ve maio'nun dokümanları inceleyebilirsiniz.
101 Maio'nun kullanabileceği bir reklam yok.
102 Geçersiz sunucu parametreleri (ör. eksik Yerleşim Kimliği).
103 Bir reklamı yüklemek için kullanılan bağlam "Etkinlik" örneği değildi.
0-10 maio, SDK'ya özel bir hata döndürdü. Görüntüleyin maio'nun kodu inceleyebilirsiniz.
101 maio'nun henüz bir reklamı yok.
102 Geçersiz sunucu parametreleri (ör. eksik Yerleşim Kimliği).
103 Maio bağdaştırıcısı, istenen reklam biçimini desteklemiyor.
104 Bu ağ yapılandırması için zaten bir reklam yüklü.

maio Android Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü

Sürüm 1.1.16.3

  • Gereken minimum Google Mobile Ads SDK'sı sürümü 23.0.0 olarak güncellendi.
  • maio SDK'nın 1.1.16 sürümü ile uyumluluk doğrulandı.

Aşağıdakilerle geliştirilip test edildi:

  • Google Mobile Ads SDK'sı sürüm 23.0.0.
  • Maio SDK 1.1.16 sürümü.

Sürüm 1.1.16.2

  • Bağdaştırıcı, yeni VersionInfo sınıfını kullanacak şekilde güncellendi.
  • Gereken minimum Google Mobile Ads SDK'sı sürümü 22.0.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edildi:

  • Google Mobile Ads SDK'sı sürüm 22.0.0.
  • Maio SDK 1.1.16 sürümü.

Sürüm 1.1.16.1

  • compileSdkVersion ve targetSdkVersion, API 31 olarak güncellendi.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 21.0.0 olarak güncellendi.
  • Gerekli minimum Android API düzeyi 19 olarak güncellendi.

Aşağıdakilerle geliştirilip test edildi:

  • Google Mobile Ads SDK'sı sürüm 21.0.0.
  • Maio SDK 1.1.16 sürümü.

Sürüm 1.1.16.0

  • Hata kodları, diğer maio hatalarını yakalayacak şekilde güncellendi.
  • maio SDK'nın 1.1.16 sürümü ile uyumluluk doğrulandı.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 20.4.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edildi:

  • Google Mobile Ads SDK'sı sürüm 20.4.0.
  • Maio SDK 1.1.16 sürümü.

Sürüm 1.1.15.0

  • maio SDK'nın 1.1.15 sürümü ile uyumluluk doğrulandı.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 20.0.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edildi:

  • Google Mobile Ads SDK'sı sürüm 20.0.0.
  • Maio SDK 1.1.15 sürümü

Sürüm 1.1.14.0

  • Standartlaştırılmış bağdaştırıcı hata kodları ve mesajları eklendi.
  • maio SDK'nın 1.1.14 sürümü ile uyumluluk doğrulandı.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 19.8.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edildi:

  • Google Mobile Ads SDK'sı sürüm 19.8.0.
  • Maio SDK 1.1.14 sürümü

Sürüm 1.1.13.0

  • maio SDK'nın 1.1.13 sürümü ile uyumluluk doğrulandı.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 19.5.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edildi:

  • Google Mobile Ads SDK'sı sürüm 19.5.0.
  • Maio SDK 1.1.13 sürümü

Sürüm 1.1.12.0

  • Google Mobile Ads SDK'sı için gereken minimum sürüm 19.4.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edildi:

  • Google Mobile Ads SDK'sı sürüm 19.4.0.
  • Maio SDK 1.1.12 sürümü.

Sürüm 1.1.11.1

  • Zamanlamaları sınırlamak için maio'nun gösterilmeye hazır bir reklamı yoksa reklam istekleri artık hemen başarısız olur.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 19.1.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edildi:

  • Google Mobile Ads SDK'sı sürüm 19.1.0.
  • Maio SDK 1.1.11 sürümü

Sürüm 1.1.11.0

  • maio SDK'nın 1.1.11 sürümü ile uyumluluk doğrulandı.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 18.3.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edildi:

  • Google Mobile Ads SDK'sı sürüm 18.3.0.
  • Maio SDK 1.1.11 sürümü

Sürüm 1.1.10.0

  • maio SDK 1.1.10 sürümü ile uyumluluk doğrulandı.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 18.2.0 olarak güncellendi.

Sürüm 1.1.8.0

  • maio SDK'nın 1.1.8 sürümü ile uyumluluk doğrulandı.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 18.1.0 olarak güncellendi.

Sürüm 1.1.7.0

  • Hata Düzeltmeleri.
  • maio SDK'nın 1.1.7 sürümü ile uyumluluk doğrulandı.

Sürüm 1.1.6.1

  • Bağdaştırıcı, yeni Ödüllü API'yi destekleyecek şekilde güncellendi.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 17.2.0 olarak güncellendi.

Sürüm 1.1.6.0

  • maio SDK'nın 1.1.6 sürümü ile uyumluluk doğrulandı.

Sürüm 1.1.5.0

  • maio SDK'nın 1.1.5 sürümü ile uyumluluk doğrulandı.

Sürüm 1.1.4.0

  • maio SDK'nın 1.1.4 sürümü ile uyumluluk doğrulandı.

Sürüm 1.1.3.1

  • Bağdaştırıcı, singleton yerine örnek sınıfıyla çalışacak şekilde güncellendi.

Sürüm 1.1.3.0

  • maio SDK'nın 1.1.3 sürümü ile uyumluluk doğrulandı.

Sürüm 1.1.2.1

  • Bağdaştırıcı, güncellenmiş başlatma işlevleriyle güncellendi.

Sürüm 1.1.2.0

  • maio SDK'nın 1.1.2 sürümü ile uyumluluk doğrulandı.

Sürüm 1.1.1.1

  • Bağdaştırıcı, onRewardedVideoComplete() reklam etkinliğini çağıracak şekilde güncellendi.

Sürüm 1.1.1.0

  • maio SDK'nın 1.1.1 sürümü ile uyumluluk doğrulandı.

Sürüm 1.1.0.0

  • maio SDK'nın 1.1.0 sürümü ile uyumluluk doğrulandı.

Sürüm 1.0.8.0

  • maio SDK'nın 1.0.8 sürümü ile uyumluluk doğrulandı.

Sürüm 1.0.7.1

  • Reklamlar başarısız olduğunda NullPointerExceptions hatasının oluşmasına neden olabilecek sorun düzeltildi yükleyin.

Sürüm 1.0.7.0

  • AdRequest cihaza test cihazı kimliği eklenerek test modunu etkinleştirme olanağı eklendi.
  • maio SDK'nın 1.0.7 sürümü ile uyumluluk doğrulandı.

Sürüm 1.0.6.0

  • İlk çıkış tarihi!
  • Geçiş reklamları ve ödüllü video reklamlar için destek eklendi.