Google Mobile Ads SDK'sı bakım modundadır. En son güncellemeler ve özellikler için migrate ve ayarlayın.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

maio'yu uyumlulaştırma ile entegre etme

Platform seçin: Android iOS Unity Flutter Android (Eski)

Bu kılavuzda, şelale entegrasyonlarını kapsayan AdMob Uyumlulaştırması'nı kullanarak maio'dan reklam yüklemek ve göstermek için Google Mobile Ads SDK (Legacy) ürününün nasıl kullanılacağı gösterilmektedir. Bu açıklamalar, maio'nun bir reklam biriminin uyumlulaş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 Android uygulamasına nasıl entegre edileceğini kapsar.

maio'nun kontrol paneli arayüzündeki etiketler, düğmeler ve açıklamalar Japonca metinler içerir. Bu kılavuzdaki ekran görüntüleri çevrilmemiştir. Ancak bu kılavuzun açıklamalarında ve talimatlarında, etiketler ve düğmeler İngilizce karşılıklarıyla belirtilmiştir. "URL スキーム" (URL şeması) örnek olarak verilebilir.

Desteklenen entegrasyonlar ve reklam biçimleri

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

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

Ön koşullar

Devam etmeden önce aşağıdakileri doğrulayın:

Android API düzeyi 24 veya sonraki sürümler

maio SDK 1.0.7 veya sonraki sürümler.

En yeni Google Mobile Ads SDK (Legacy) sürümü.
AdMob Uyumlulaştırması'nı ayarlayın.

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ğundaki Application management (Uygulama yönetimi) düğmesini ve ardından New app'i (Yeni uygulama) 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 girin. Reklam Türü olarak Video geçiş reklamı'nı seçin ve ardından Güncelle'yi tıklayın.

Ödüllü

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

Application Management (Uygulama Yönetimi) sayfasında Media ID'yi (Medya Kimliği) not edin. Bu kimlik, bir sonraki bölümde AdMob reklam biriminizi oluşturmak için gereklidir.

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

Uyumlulaştırma için reklam birimi kimliğinizi ayarlamak üzere Medya Kimliği ve Bölge Kimliği'nin yanı sıra API Kimliği ve API ANAHTARI gerekir. Reporting API sayfasında, API kimliği ve API anahtarını 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

Reklam biriminizin uyumlulaştırma yapılandırmasına maio'yu eklemeniz gerekir.

Öncelikle AdMob hesabınızda oturum açın. Ardından Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa bu uyumlulaştırma grubunun adını tıklayarak düzenleyin ve maio'yu reklam kaynağı olarak ekleme bölümüne geçin.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu Oluştur'u seçin.

Reklam biçiminizi ve platformunuzu girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın ve Reklam Birimleri Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut AdMob reklam birimlerinizden biri veya daha fazlasıyla ilişkilendirin. Ardından Bitti'yi tıklayın.

Artık seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını göreceksiniz:

maio'yu reklam kaynağı olarak ekleme

Reklam Kaynakları bölümündeki Şelale kartında Reklam Kaynağı Ekle'yi seçin.

maio'yu seçin ve Optimize et anahtarını etkinleştirin. maio için reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde elde edilen API kimliği ve API anahtarını girin. Ardından maio için bir eBGBM değeri girin ve Devam'ı tıklayın.

maio için zaten bir eşlemeniz varsa bu eşlemeyi seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.

Ardından, önceki bölümde alınan Medya Kimliği ve Bölge Kimliği'ni girin. Ardından Bitti'yi tıklayın.

Not: Reklam kaynağı optimizasyonunun bir uyumlulaştırma ağı için eBGBM'yi doğru şekilde hesaplamaya yetecek kadar veri toplaması birkaç gün sürer. Bu süre zarfında reklam kaynağı optimizasyon durumu PENDING olur. Bu nedenle, ağ için manuel olarak bir eBGBM değeri ayarlamanız gerekir. eBGBM hesaplanabildiğinde reklam kaynağı, eBGBM'yi sizin adınıza otomatik olarak güncellemeye başlar.

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

Android Studio entegrasyonu (önerilir)

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

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

Uygulama düzeyindeki gradle dosyanıza aşağıdaki uygulama bağımlılıklarını ekleyin:

Kotlin

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

Modern

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:maio:2.0.9.1'
}

Manuel entegrasyon

maio Android SDK'nın en yeni sürümünü indirip projenize ekleyin.
Google'ın Maven deposundaki maio bağdaştırıcı yapılarına gidin. En yeni sürümü seçin, maio bağdaştırıcısı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 edin

Test reklamlarını etkinleştirme

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

Google Mobile Ads SDK (Legacy)'ın 11.6.0 veya daha yeni bir sürümünü kullanan yayıncılar, istekte bulunurken test cihazı olarak kayıtlı 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.getAdapterResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

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

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

Hata kodu	Neden
0-10	maio, SDK'ya özgü bir hata döndürdü. Daha fazla bilgi için kodu ve maio'nun belgelerini inceleyin.
101	Maio'da uygun reklam yok.
102	Sunucu parametreleri geçersiz (ör. yerleşim kimliği eksik).
103	Reklam yüklemek için kullanılan bağlam bir "Etkinlik" örneği değildi.
104	İstek, yaş kısıtlamasına tabi olarak değerlendirildi ancak maio SDK'sı yaş kısıtlamalı sinyaller alamıyor

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