Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

Bu kılavuzda, şelale entegrasyonlarını ele alan uyumlulaştırma özelliğini kullanarak 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. Bu kılavuzda, i-mobile'ın reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Android uygulamaya i-mobile SDK ile bağdaştırıcının nasıl entegre edileceği ele alınmaktadır.

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çıklama ve talimatlarında etiketler ve 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ı Ad Manager şunlara 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ü

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu

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

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

Uygulamanızı i-mobile kontrol paneline eklemek için サイト/アプん管苯 (Site/Application Management) sekmesini ve uygulama platformunuzun düğmesini tıklayın.

Formu doldurun ve 電規設 (Sign up) (Kaydolun) düğmesini tıklayın.

Yeni bir Reklam spotu oluşturmak için サイト/アプsold管 dekorasyonlu (Site/Application Management) sekmesi altında uygulamanızı seçin.

広告すンント管テ (Reklam Spot Management) sekmesine gidin ve individual規広告イント (New Ad Spot) (Yeni Reklam Spotu) düğmesini tıklayın.

create_ad_spot

Daha sonra, 広告スすト名 (Reklam Spot adı), 広告イトサイズ (Reklam Spot boyutu) ve diğer bilgileri sağlayarak formu doldurun. Ardından, automatic規 dağıtımı (Kaydolun) düğmesini tıklayın.

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 (Publisher ID), テデイアID (Media ID) ve OCCURRENCE menüsündeki (Spot ID) kimlik bilgilerini not edin. Daha sonra, kullanıcı arayüzünde i-mobile'ı uyumlulaştırma için yapılandırırken bu parametrelere Ad Manager ihtiyaç duyacaksınız.

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

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.

i-mobileiç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 i-mobile'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 Login name and API Password

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 verilenPublisher ID, Media ID and Spot ID kodunu girin. Ardından, Varsayılan BGBM değerini girin.

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

3. Adım: i-mobile SDK 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.github.io/adnw-sdk-android")
    }
  }
}

Ardından, uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıklarını ve yapılandırmaları ekleyin. i-mobile 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:imobile:2.3.1.1")
}

Manuel entegrasyon

i-mobile SDK'nın en son sürümünü indirin ve sdk klasörünün altındaki android-ad-sdk.aar dosyasını çıkartıp projenize ekleyin.
Google'ın Maven deposunda i-mobile bağdaştırıcı 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 etme

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

Yerel reklamları kullanma

Reklam oluşturma

i-mobile bağdaştırıcısı aşağıdaki alanları bir NativeAd için doldurur.

Alan	Öğeler her zaman i-mobile bağdaştırıcı tarafından dahil edilir
Başlık
Resim
Metin
Uygulama simgesi	¹
Harekete geçirici mesaj
Yıldızlı değerlendirme
Depolama
Fiyat

¹ i-mobile SDK, yerel reklamlarda 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'dan reklam alamazsa yayıncılar aşağıdaki sınıfların altında ResponseInfo.getAdapterResponse() kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

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

Bir reklam yüklenemediğinde i-mobile bağdaştırıcısı tarafından atılan kodlar ve ilgili mesajları burada bulabilirsiniz:

Hata kodu	Neden
0-99	i-mobile SDK hata döndürdü. Daha fazla bilgi için kodu inceleyin.
101	i-mobile, reklamları yüklemek için `Activity` bağlamı gerektirir.
102	Kullanıcı arayüzünde yapılandırılmış i-mobile sunucu parametreleri Ad Manager 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ılı geri çağırması boş bir yerel reklam listesi döndürdü.
0-10	i-mobile SDK hata döndürdü. Daha fazla bilgi için kodu inceleyin.
101	Kullanıcı arayüzünde yapılandırılmış i-mobile sunucu parametreleri Ad Manager eksik/geçersiz.
102	İstenen reklam boyutu, i-mobile tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103	i-mobile 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 kimliğini kullanarak birden çok geçiş reklamı isteğinde bulunmayı desteklemez.

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

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.
IMobile SDK 2.3.1 sürümü.

Sürüm 2.3.1.0

i-mobile SDK v2.3.1 ile doğrulanmış uyumluluk.
Gereken minimum Google Mobile Ads SDK'sı sürümü, 21.5.0 olarak güncellendi.

Aşağıdakilerle geliştirildi ve test edildi:

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

Sürüm 2.3.0.0

i-mobile SDK v2.3.0 ile doğrulanmış uyumluluk.
Gereken minimum Google Mobile Ads SDK'sı sürümü, 21.3.0 olarak güncellendi.

Aşağıdakilerle geliştirildi ve test edildi:

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

Sürüm 2.0.23.1

compileSdkVersion ve targetSdkVersion, 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.
IMobile SDK sürümü 2.0.23.