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

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

Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl i-mobile reklamları ile uyumlulaştırma, ele alacağız. Burada, i-mobile'ın bir reklam birimine nasıl ekleneceği ve i-mobile SDK ile bağdaştırıcının Google Analytics 360'a nasıl entegre edileceği Android uygulama.

i-mobile'ın kontrol paneli arayüzü, etiketleri için Japonca metin kullanıyor. ve açıklamaları görebilirsiniz. Bu kılavuzdaki ekran görüntüleri anlamına gelir. Ancak bu kılavuzun açıklama ve talimatlarında, düğmelerin İngilizce dilindeki karşılıkları parantez içinde ç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ü

En son Google Mobile Ads SDK'sı
Arabuluculuğu tamamlama 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'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ğıdakini ekleyin: depolar:

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ğıdakileri ekleyin: ve yapılandırmalarına değineceğiz. Chrome Web Mağazası'ndaki i-mobile SDK ve bağdaştırıcı:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

Manuel entegrasyon

Son sürümünü indirin i-mobile SDK'yı indirin ve android-ad-sdk.aar adlı dosyayı sdk klasörünün altına indirin ve projenize ekleyin.
i-mobile bağdaştırıcı yapıları'na gidin Google'ın Maven deposunda. En son sürümü seçin, i-mobile'ı indirin bağdaştırıcının .aar dosyasını seçin ve bu dosyayı 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

Doğal reklamları kullanma

Reklam oluşturma

i-mobile adaptörü aşağıdakileri doldurur alanlar - NativeAd.

Alan	Öğeler her zaman i-mobile adaptörü 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, 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

i-mobile adaptörü tarafından gönderilen kodlar ve beraberindeki mesajlar Reklam yüklenemedi:

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	Kullanıcı arayüzünde yapılandırılan 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ü. Kodu inceleyin inceleyebilirsiniz.
101	Kullanıcı arayüzünde yapılandırılan 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 bir reklam gösteremedi.
104	i-mobile, boş bir doğal reklam dizisi döndürdü.
105	i-mobile doğal reklam öğelerini indiremedi.
106	i-mobile, aynı Spot Kimliği'ni 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üğü

Sürüm 2.3.2.0

i-mobile SDK v2.3.2 ile uyumluluk doğrulandı.

Aşağıdakilerle geliştirilip test edildi:

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 geliştirilip test edildi:

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ı, 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ştirilip test edildi:

Google Mobile Ads SDK'sı sürüm 22.0.0.
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ı.
Google Mobile Ads SDK'sı için gereken minimum sürüm 21.5.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edildi:

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

Sürüm 2.3.0.0

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

Aşağıdakilerle geliştirilip test edildi:

Google Mobile Ads SDK'sı sürüm 21.3.0.
IMobile SDK'sı 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 geliştirilip test edildi:

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