i-mobile'ı Uyumlulaştırma ile entegre etme

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Bu kılavuzda, şelale uyumlulaştırmasını kapsayan uyumlulaştırma kullanarak mobil cihazlardan reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. i-mobile reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve i-mobile SDK ile bağdaştırıcının bir uygulamaya nasıl entegre edileceğini Android kapsar.

i-mobile'ın kontrol paneli arayüzü etiketleri, düğmeleri ve açıklamaları için Japonca metin kullanır. 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 dilindeki eşdeğerleriyle parantez içinde çevrilir.

Desteklenen entegrasyonlar ve reklam biçimleri

i-mobile için AdMob uyumlulaştırma adaptörü aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif
Şelale
Biçimler
Banner
Geçişli
Ödül olarak verildi
Yerel biçim

Koşullar

  • Android API düzeyi 19 veya üstü
  • En son Google Mobile Ads SDK'sı

1. Adım: i-mobile'ı ayarlayın

i-mobile hesabınıza kaydolun veya giriş yapın.

サの人/アプ苯管理 (Site/Uygulama Yönetimi) sekmesini ve MRAID規Androidアプ苯 (Yeni Android Uygulaması) düğmesini tıklayarak uygulamanızı i-mobile kontrol paneline ekleyin.

TLD称 (Ad) ve マLIGHTケッbigqueryURL (Pazar URL'si) bilgilerini sağlayarak uygulamanızı kaydedin. Ardından, formun geri kalanını doldurduktan sonra chromecast規測值 (Kaydol) düğmesini tıklayın.

Yeni bir Reklam spotu oluşturmak için uygulamanızı サのinventory/アプ苯管理 (Site/Uygulama Yönetimi) sekmesi altında seçin.

広告ว測ッinventory管理 (Reklam Spot Yönetimi) sekmesine gidin ve MRAID規広告ว測ッ✘ (Yeni Reklam Noktası) düğmesini tıklayın.

reklam_reklamı_oluştur

Ardından formu doldururken 広告ח測ッ✘ん (Reklam Spotu adı), 広告ח測ッinventoryサのズ (Reklam Spot boyutu) ve diğer ayrıntıları sağlayın. Ardından 新規準值 (Kaydol) düğmesini tıklayın.

yeni_reklam_noktası_formu

Yeni Reklam spotunuz hazır. Entegrasyon ayrıntılarını görüntülemek için アプ苯用定取得 (Uygulama ayarlarını al) düğmesini tıklayın.

reklam_listesi_listesi

パ苯苯ッLIGHTャSTARID (Yayıncı Kimliği), ∨デ用アID (Medya Kimliği) ve ปรッ PlaceID (Spot ID) notlarını not edin. Bu parametreleri daha sonra AdMob için kullanıcı arayüzünde uyumlulaştırma için yapılandırırken kullanmanız gerekecek.

2. Adım: AdMob Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırın

Şimdi reklam biriminiz için uyumlulaştırma i-mobile'ı eklemeniz gerekir. Bunun için ö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 düzenlemek için bu uyumlulaştırma grubunun adını tıklayın ve i-mobile'ı 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.

AdMob uyumlulaştırma sekmesi

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. Ardından Reklam Birimi Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut AdMob reklam birimlerinizle ilişkilendirin. Ardından Bitti'yi tıklayın.

Reklam birimlerinin seçtiğiniz reklam birimleriyle doldurulduğunu göreceksiniz.

i-mobile'ı reklam kaynağı olarak ekleyin

Reklam Kaynakları kartında Reklam Ağı Ekle'yi seçin.

i-mobile'ı seçin ve Optimize et özelliğini etkinleştirin. Mobil cihazlar için reklam kaynağı optimizasyonunu ayarlamak üzere i-mobile hesabınızın Giriş Adını ve API Şifresini girin. Ardından, mobil için bir eBGBM değeri girip Devam'ı tıklayın.

Daha önce edindiğiniz Yayıncı Kimliği, Medya Kimliği ve Spot Kimliği bilgilerini girin.

3. Adım: i-mobile SDK'yı ve Adaptörü içe aktarın

Aşağıdaki uygulama bağımlılıklarını, uygulama düzeyindeki build.gradle dosyasına mobil SDK ve bağdaştırıcının en son sürümleriyle ekleyin:

repositories {
    google()
    mavenCentral()
    maven {
      url  "https://imobile.github.io/adnw-sdk-android"
    }
}

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:21.3.0'
    implementation 'com.google.ads.mediation:imobile:2.3.0.0'
}
...

Manuel entegrasyon

  1. i-mobile SDK'ın en son sürümünü indirin ve sdk klasörünün altındaki android-ad-sdk.aarbölümünü çıkarıp projenize ekleyin.

  2. Google'ın Maven deposundaki i-mobile adaptör yapılarına gidin. En son sürümü seçin, i-mobile adaptörün .aar dosyasını indirin ve projenize ekleyin.

4. Adım: Ek kod gerekir

i-mobile entegrasyonu için ek kod gerekmez.

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

i-mobile, entegrasyonunuzu test etmek üzere tüm reklam biçimleri için Spot ID, Media ID ve Yayıncı Kimliği özelliklerini test eder. Kaynaklara buradan ulaşabilirsiniz.

İsteğe bağlı adımlar

Yerel reklamları kullanma

Reklam oluşturma

i-mobile adaptör aşağıdaki bilgileri doldurur: Yerel reklamlarla ilgili gelişmiş alan açıklamaları NativeAd.

Alan Öğeler her zaman i-mobile adaptörle eklenir
Başlık
Resim
Metin
Uygulama simgesi 1
Harekete geçirici mesaj
Yıldızlı değerlendirme
Depolama
Fiyat

1 Yerel reklamlar için i-mobile SDK'sı bir uygulama simgesi öğesi sağlamaz. Bunun yerine, i-mobile adaptör uygulama simgesini şeffaf bir resimle doldurur.

Hata kodları

Bağdaştırıcı, i-mobile üzerinden reklam alamazsa yayıncılar ResponseInfo.getAdapterResponse() kullanarak reklam yanıtında altta yatan hatayı aşağıdaki sınıflarda kontrol edebilir:

Biçim Sınıf adı
Banner com.google.ads.uyumlulaştırması.imobile.IMobileAdapter
Geçişli com.google.ads.uyumlulaştırması.imobile.IMobileAdapter
Yerel biçim com.google.ads.uyumlulaştırması.imobile.IMobileUyumlulaştırmaAdapter

Reklamlar yüklenemediğinde i-mobile adaptörünün attığı kodlar ve ilgili mesajlar aşağıda verilmiştir:

Hata kodu Neden
0-99 i-mobile SDK bir hata döndürdü. Daha fazla bilgi için kod bölümüne bakın.
101 i-mobile, reklamları yüklemek için Activity bağlamı gerektirir.
102 Kullanıcı arayüzünde yapılandırılan AdMob mobil sunucu parametreleri eksik/geçersiz.
103 İstenen reklam boyutu, mobil desteklenen bir banner boyutuyla eşleşmiyor.
104 i-mobile'ın yerel reklam yükleme başarılı geri çağırması boş bir yerel reklam listesi döndürdü.
0-10 i-mobile SDK bir hata döndürdü. Daha fazla bilgi için kod bölümüne bakın.
101 Kullanıcı arayüzünde yapılandırılan AdMob mobil sunucu parametreleri eksik/geçersiz.
102 İstenen reklam boyutu, mobil desteklenen bir banner boyutuyla eşleşmiyor.
103 i-mobile bir reklam sunamadı.
104 i-mobile boş bir yerel reklam dizisi döndürdü.
105 i-mobile, yerel reklam öğelerini indiremedi.
106 i-mobile, aynı Spot ID'yi kullanarak birden fazla geçiş reklamı için istekte bulunmayı desteklemez.

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

Sürüm 2.3.0.0

  • i-mobile SDK 2.3.0 sürümüyle doğrulandı.
  • Gereken minimum Google Mobile Ads SDK'sı sürümü 21.3.0 olarak güncellendi.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.3.0 sürümü.
  • IMobile SDK sürümü 2.3.0.

Sürüm 2.0.23.1

  • compileSdkVersion ve targetSdkVersion, API 31 olarak 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.

Şunlarla oluşturulur ve test edilir:

  • Google Mobile Ads SDK'sının 21.0.0 sürümü.
  • IMobile SDK sürümü 2.0.23.

Sürüm 2.0.23.0

  • i-mobile SDK 2.0.23 sürümü ile uyumluluk doğrulandı.
  • Gereken minimum Google Mobile Ads SDK'sı sürümü 20.5.0 olarak güncellendi.

Şununla geliştirilmiş ve test edilmiştir:

  • Google Mobile Ads SDK'sının 20.5.0 sürümü.
  • IMobile SDK sürümü 2.0.23.

Sürüm 2.0.22.2

  • Standartlaştırılmış adaptör hata kodları ve mesajları eklendi.
  • Gereken minimum Google Mobile Ads SDK'sı sürümü 20.1.0 olarak güncellendi.

Şununla geliştirilmiş ve test edilmiştir:

  • Google Mobile Ads SDK'sının 20.1.0 sürümü.
  • IMobile SDK sürümü 2.0.22.

Sürüm 2.0.22.1

  • Gereken minimum Google Mobile Ads SDK'sı sürümü 20.0.0 olarak güncellendi.

Şununla geliştirilmiş ve test edilmiştir:

  • Google Mobile Ads SDK'sının 20.0.0 sürümü.
  • IMobile SDK sürümü 2.0.22.

Sürüm 2.0.22.0

  • i-mobile SDK 2.0.22 sürümüyle doğrulandı.
  • Adaptör, satır içi uyarlanabilir banner isteklerini destekleyecek şekilde güncellendi.

Şununla geliştirilmiş ve test edilmiştir:

  • Google Mobile Ads SDK'sı 19.1.0 sürümü.
  • IMobile SDK sürümü 2.0.22.

Sürüm 2.0.21.0

  • i-mobile SDK 2.0.21 sürümüyle doğrulandı.
  • Gereken minimum Google Mobile Ads SDK'sı sürümü 19.1.0 olarak güncellendi.
  • Uyarlanabilir banner reklamları ölçeklendirme desteği eklendi.

Şununla geliştirilmiş ve test edilmiştir:

  • Google Mobile Ads SDK'sı 19.1.0 sürümü.
  • IMobile SDK sürümü 2.0.21.

Sürüm 2.0.20.2

  • Esnek banner reklam boyutları için destek eklendi.
  • Gereken minimum Google Mobile Ads SDK'sı sürümü 18.3.0 olarak güncellendi.

Şununla geliştirilmiş ve test edilmiştir:

  • Google Mobile Ads SDK'sı 18.3.0 sürümü.
  • IMobile SDK sürümü 2.0.20.

Sürüm 2.0.20.1

  • Adaptör artık sıfır olmayan mediaContent en boy oranı döndürüyor.

Şununla geliştirilmiş ve test edilmiştir:

  • Google Mobile Ads SDK'sı 18.2.0 sürümü.
  • IMobile SDK sürümü 2.0.20.

Sürüm 2.0.20.0

  • İlk sürüm!
  • Banner, geçiş reklamı ve yerel reklamlar için destek eklendi.