Bu kılavuzda, şelale entegrasyonlarını ele alan uyumlulaştırma özelliğini kullanarak maio'dan reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, reklam biriminin uyumlulaştırma yapılandırmasına nasıl maio ekleneceği ve maio SDK ile bağdaştırıcısının bir uygulamaya nasıl entegre edileceğiAndroid ele alınmaktadır.
Maio'nun kontrol paneli arayüzü, etiketleri, düğmeleri ve açıklamaları için Japonca metin kullanır ve bu kılavuzdaki ekran görüntüleri çevrilmemiştir. Ancak bu kılavuzun açıklama ve talimatlarında, etiketlere ve düğmelere İngilizce karşılıklarıyla atıfta bulunulmuştur. Örneğin, "URL 🏏ーム", "URL Şeması"dır.
Desteklenen entegrasyonlar ve reklam biçimleri
Maio için Ad Manager uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:
Entegrasyon | |
---|---|
Teklif | |
Şelale | |
Formatlar | |
Banner | |
Geçişli | |
Ödül olarak verildi | |
Yerel biçim |
Koşullar
- Android API düzeyi 19 veya üstü
- maio SDK'sı 1.0.7 veya üstü
En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu
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 talebi Ad Manager kurun
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ıyı 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")
}
}
}
Ardından, uygulama düzeyindeki build.gradle.kts
dosyanıza aşağıdaki uygulama bağımlılıklarını ve yapılandırmaları ekleyin. Maio SDK ve bağdaştırıcının en son sürümlerini kullanın:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:maio:1.1.16.2")
}
Manuel entegrasyon
- maio Android SDK'nın en son sürümünü indirin ve projenize ekleyin.
- Google'ın Maven deposunda maio bağdaştırıcısı yapılarına gidin. En son 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 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 aşağıdaki sınıfların altında
ResponseInfo.getAdapterResponses()
kullanarak reklam yanıtındaki temel hatayı kontrol edebilirler:
Biçim | Sınıf adı |
---|---|
Geçişli | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
Ödül olarak verildi | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
Bir reklam yüklenemediğinde maio bağdaştırıcısı tarafından atılan kodlar ve ilgili mesajlar şunlardır:
Hata kodu | Neden |
---|---|
0-10 | maio, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için kod ve maio belgelerine bakın. |
101 | Maio'nun kullanılabilir 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 özgü bir hata döndürdü. Daha fazla bilgi için maio'nun koduna bakın. |
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üklendi. |
maio Android Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü
Sonraki Sürüm
- Gereken minimum Google Mobile Ads SDK'sı sürümü, 22.4.0 olarak güncellendi.
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ştirildi ve test edildi:
- Google Mobile Ads SDK'sı sürüm 22.0.0.
- Maio SDK'sı sürüm 1.1.16.
Sürüm 1.1.16.1
compileSdkVersion
vetargetSdkVersion
, API 31'e güncellendi.- Gereken minimum Google Mobile Ads SDK'sı sürümü, 21.0.0 olarak güncellendi.
- Gereken minimum Android API düzeyi 19 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
- Google Mobile Ads SDK'sı sürüm 21.0.0.
- Maio SDK'sı sürüm 1.1.16.
Sürüm 1.1.16.0
- Hata kodları, ek maio hatalarını yakalayacak şekilde güncellendi.
- Maio SDK'sının 1.1.16 sürümüyle uyumlu olduğu doğrulandı.
- Gereken minimum Google Mobile Ads SDK'sı sürümü, 20.4.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
- Google Mobile Ads SDK'sı sürüm 20.4.0.
- Maio SDK'sı sürüm 1.1.16.
Sürüm 1.1.15.0
- Maio SDK'sı 1.1.15 sürümüyle uyumlu olduğu doğrulandı.
- Gereken minimum Google Mobile Ads SDK'sı sürümü, 20.0.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
- Google Mobile Ads SDK'sı sürüm 20.0.0.
- Maio SDK'sı sürüm 1.1.15.
Sürüm 1.1.14.0
- Standartlaştırılmış bağdaştırıcı hata kodları ve mesajları eklendi.
- Maio SDK'sı 1.1.14 sürümü ile doğrulanmış uyumluluk.
- Gereken minimum Google Mobile Ads SDK'sı sürümü, 19.8.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
- Google Mobile Ads SDK'sı sürüm 19.8.0.
- Maio SDK'sı sürüm 1.1.14.
Sürüm 1.1.13.0
- Maio SDK'sı 1.1.13 sürümü ile doğrulanmış uyumluluk.
- Gereken minimum Google Mobile Ads SDK'sı sürümü, 19.5.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
- Google Mobile Ads SDK'sı sürüm 19.5.0.
- Maio SDK'sı sürüm 1.1.13.
Sürüm 1.1.12.0
- Gereken minimum Google Mobile Ads SDK'sı sürümü, 19.4.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
- Google Mobile Ads SDK'sı sürüm 19.4.0.
- Maio SDK'sı sürüm 1.1.12.
Sürüm 1.1.11.1
- Zaman aşımını sınırlandırmak için, maio'nun gösterilmeye hazır bir reklamı yoksa reklam istekleri artık anında başarısız olacaktır.
- Gereken minimum Google Mobile Ads SDK'sı sürümü, 19.1.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
- Google Mobile Ads SDK'sı sürüm 19.1.0.
- Maio SDK'sı sürüm 1.1.11.
Sürüm 1.1.11.0
- Maio SDK'sı 1.1.11 sürümü ile doğrulanmış uyumluluk.
- Gereken minimum Google Mobile Ads SDK'sı sürümü, 18.3.0 olarak güncellendi.
Aşağıdakilerle geliştirildi ve test edildi:
- Google Mobile Ads SDK'sı sürüm 18.3.0.
- Maio SDK'sı sürüm 1.1.11.
Sürüm 1.1.10.0
- Maio SDK'sı 1.1.10 sürümü ile doğrulanmış uyumluluk.
- Gereken minimum Google Mobile Ads SDK'sı sürümü, 18.2.0 olarak güncellendi.
Sürüm 1.1.8.0
- Maio SDK'sı 1.1.8 sürümüyle uyumlu olduğu doğrulandı.
- Gereken minimum Google Mobile Ads SDK'sı sürümü, 18.1.0 olarak güncellendi.
Sürüm 1.1.7.0
- Hata Düzeltmeleri.
- Maio SDK'sının 1.1.7 sürümüyle uyumlu olduğu doğrulandı.
Sürüm 1.1.6.1
- Yeni Ödüllü API'yi desteklemek için adaptör güncellendi.
- Gereken minimum Google Mobile Ads SDK'sı sürümü, 17.2.0 olarak güncellendi.
Sürüm 1.1.6.0
- Maio SDK'sı 1.1.6 sürümü ile doğrulanmış uyumluluk.
Sürüm 1.1.5.0
- Maio SDK'sı 1.1.5 sürümüyle uyumlu olduğu doğrulandı.
Sürüm 1.1.4.0
- Maio SDK 1.1.4 sürümü ile doğrulanmış uyumluluk.
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 1.1.3 sürümü ile doğrulanmış uyumluluk.
Sürüm 1.1.2.1
- Bağdaştırıcı, güncellenmiş ilk kullanıma hazırlama işlevleriyle güncellendi.
Sürüm 1.1.2.0
- Maio SDK'sı 1.1.2 sürümü ile doğrulanmış uyumluluk.
Sürüm 1.1.1.1
onRewardedVideoComplete()
reklam etkinliğini çağırmak için bağdaştırıcı güncellendi.
Sürüm 1.1.1.0
- Maio SDK'sı 1.1.1 sürümü ile doğrulanmış uyumluluk.
Sürüm 1.1.0.0
- Maio SDK 1.1.0 sürümü ile doğrulanmış uyumluluk.
Sürüm 1.0.8.0
- Maio SDK'sı 1.0.8 sürümüyle uyumlu olduğu doğrulandı.
Sürüm 1.0.7.1
- Reklamlar yüklenemediğinde NullPointerExceptions'ın oluşmasına neden olabilen bir sorun düzeltildi.
Sürüm 1.0.7.0
AdRequest
öğesine test cihazı kimliği eklenerek test modunu etkinleştirme özelliği eklendi.- Maio SDK'sı 1.0.7 sürümüyle uyumlu olduğu doğrulandı.
Sürüm 1.0.6.0
- İlk sürüm!
- Geçiş reklamları ve ödüllü video reklamlar için destek eklendi.