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

Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma kullanılarak i-mobile'dan 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'ın bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve i-mobile SDK'sının ve bağdaştırıcının bir uygulamaya nasıl entegre edileceğini kapsar.

i-mobile için kontrol paneli arayüzünde etiketler, düğmeler ve açıklamalar Japonca metin kullanır. Bu kılavuzdaki ekran görüntüleri anlamına gelir. Ancak bu kılavuzun açıklamalarında ve talimatlarında etiketler ile düğmeler, parantez içinde İngilizce karşılıklarıyla birlikte çevrilmiştir.

Desteklenen entegrasyonlar ve reklam biçimleri

i-mobile 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ü

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

Kaydolma veya günlük tutma i-mobile hesabınıza giriş yapın.

Uygulamanızı サイト/゗プ olmaksızın管TM (Site/Uygulama Yönetimi) sekmesine gidin ve platformu.

Android

iOS

Formu doldurun ve Advertiser規っ (Kaydol) düğmesini tıklayın.

Android

iOS

Yeni bir reklam alanı oluşturmak için サイト／アプリ管理 (Site/Uygulama Yönetimi) sekmesinde uygulamanızı seçin.

Android

iOS

広告スポット管理 (Reklam Alanı Yönetimi) sekmesine gidin ve 新規広告スポット (Yeni Reklam Alanı) düğmesini tıklayın.

create_ad_spot

Ardından, 広告クット名 (Reklam Spotu adı) değerlerini girerek formu doldurun. 広告型ットサイズ (Reklam Alanı boyutu) ve diğer ayrıntılar. Daha sonra 妏 (Kaydol) düğmesi.

new_ad_spot_form

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.

ad_spot_list

パっテイルクーID (Yayıncı Kimliği), accessibilityデッılamazID (Medya Kimliği) olarak bildirilecektir, ve ホテトID (Spot ID). Daha sonra yapılandırma sırasında bu parametrelere ihtiyacınız olacak AdMob kullanıcı arayüzünde uyumlulaştırma için i-mobile.

Android

iOS

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

3. Adım: i-mobile SDK'sını ve Bağdaştırıcıyı içe aktarın

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

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

Ardından, uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıkları ve yapılandırmaları ekleyin. i-mobile SDK'sının 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.4.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

Manuel entegrasyon

  1. i-mobile SDK'sının en son sürümünü indirip android-ad-sdk.aar dosyasını sdk klasörüne çıkarın ve projenize ekleyin.

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

4. Adım: Gerekli kodu ekleyin

i-mobile entegrasyonu için ek kod gerekmez.

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

Test reklamlarını etkinleştir

Ad Manager. i-mobile, test için test Spot Kimliği, Medya Kimliği ve Yayıncı Kimliği bilgilerini sağlar. Bunları burada bulabilirsiniz.

Test reklamlarını doğrulama

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

İsteğe bağlı adımlar

Doğal reklamları kullanma

Reklam oluşturma

i-mobile adaptörü, NativeAd için aşağıdaki alanlarını doldurur.

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

1 i-mobile SDK, doğal reklamlar için uygulama simgesi öğesi sağlamaz. Bunun yerine i-mobile adaptörü, uygulama simgesini şeffaf bir resimle doldurur.

Hata kodları

Adaptör, i-mobile'den bir reklam alamazsa yayıncılar reklam yanıtındaki temel hatayı . ResponseInfo.getAdapterResponses() şu sınıflarda:

Biçim Sınıf adı
Banner com.google.ads.mediation.imobile.IMobileAdapter
Geçiş reklamı com.google.ads.mediation.imobile.IMobileAdapter
Yerel biçim com.google.ads.mediation.imobile.IMobileMediationAdapter

Bir reklam yüklenemezse i-mobile adaptörü tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

Hata kodu Neden
0-99 i-mobile SDK hata döndürdü. Kodu inceleyin inceleyebilirsiniz.
101 i-mobile, reklamları yüklemek için Activity bağlamı gerektirir.
102 Ad Manager kullanıcı arayüzünde yapılandırılan i-mobile sunucu parametreleri eksik/geçersiz.
103 İstenen reklam boyutu, i-mobile tarafından desteklenen bir banner boyutuyla eşleşmiyor.
104 i-mobile'ın yerel reklam yükleme başarı geri çağırma işlevi boş bir yerel reklam listesi döndürdü.

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

Sürüm 2.3.2.0

  • i-mobile SDK v2.3.2 ile uyumluluğu doğrulandı.

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı sürüm 23.1.0.
  • IMobile SDK'sı sürüm 2.3.2.

Sürüm 2.3.1.2

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

Aşağıdakilerle tasarlanıp test edilmiştir:

  • Google Mobile Ads SDK'sı sürüm 23.0.0.
  • IMobile SDK'sı sürüm 2.3.1.

Sürüm 2.3.1.1

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

Aşağıdakilerle derlenip test edildi:

  • Google Mobile Ads SDK'sı 22.0.0 sürümü.
  • IMobile SDK'sı sürüm 2.3.1.

Sürüm 2.3.1.0

  • i-mobile SDK v2.3.1 ile uyumluluk doğrulandı.
  • Zorunlu minimum Google Mobile Ads SDK sürümü 21.5.0 olarak güncellendi.

Aşağıdakilerle derlenip test edildi:

  • Google Mobile Ads SDK'sı 21.5.0 sürümü.
  • IMobile SDK'sı sürüm 2.3.1.

Sürüm 2.3.0.0

  • i-mobile SDK v2.3.0 ile uyumluluğu doğrulandı.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 21.3.0 olarak güncellendi.

Aşağıdakilerle tasarlanıp test edilmiştir:

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

Sürüm 2.0.23.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 derlenip test edildi:

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

2.0.23.0 sürümü

  • i-mobile SDK v2.0.23 ile uyumluluk doğrulandı.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 20.5.0 olarak güncellendi.

Birlikte tasarladığınız ve test ettiğiniz

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

Sürüm 2.0.22.2

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

Aşağıdakilerle tasarlanıp test edilmiştir:

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

2.0.22.1 sürümü

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

Birlikte tasarladığınız ve test ettiğiniz

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

Sürüm 2.0.22.0

  • i-mobile SDK 2.0.22 sürümü ile uyumluluk doğrulandı.
  • Bağdaştırıcı, satır içi uyarlanabilir banner isteklerini destekleyecek şekilde güncellendi.

Birlikte tasarladığınız ve test ettiğiniz

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

Sürüm 2.0.21.0

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

Aşağıdakilerle tasarlanıp 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.
  • Google Mobile Ads SDK'sı için gereken minimum sürüm 18.3.0 olarak güncellendi.

Birlikte tasarladığınız ve test ettiğiniz

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

Sürüm 2.0.20.1

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

Birlikte tasarladığınız ve test ettiğiniz

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

Sürüm 2.0.20.0

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