Google Mobile Ads SDK'sı bakım modundadır. En son güncellemeler ve özellikler için migrate ve ayarlayın.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

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

Platform seçin: Android iOS Unity Flutter Android (Eski)

Bu kılavuzda, şelale entegrasyonlarını kapsayarak uyumlulaştırma kullanarak i-mobile'dan reklam yüklemek ve göstermek için Google Mobile Ads SDK (Legacy) özelliğinin nasıl kullanılacağı açıklanmaktadır. Bu açıklamalar, 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ısının bir Android uygulamasına nasıl entegre edileceğini kapsar.

i-mobile'ın kontrol paneli arayüzünde etiketler, düğmeler ve açıklamalar için Japonca metinler kullanılır. Bu kılavuzdaki ekran görüntüleri çevrilmemiştir. Ancak bu kılavuzdaki açıklamalarda ve talimatlarda 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 adaptörünün özellikleri şöyledir:

Entegrasyon
Teklifli sistem
Şelale
Formatlar
Banner
Geçiş reklamı
Ödüllü
Yerel biçim

Ön koşullar

Devam etmeden önce aşağıdakileri doğrulayın:

Android API düzeyi 24 veya sonraki sürümler.

En yeni Google Mobile Ads SDK (Legacy) sürümü.
Aracılığı ayarlayın.

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.

サイト／アプリ管理 (Site/Uygulama Yönetimi) sekmesini ve uygulamanızın platformuna ait düğmeyi tıklayarak uygulamanızı i-mobile kontrol paneline ekleyin.

Formu doldurun ve 新規登録 (Kaydol) düğmesini tıklayın.

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

広告スポット管理 (Ad Spot Management) sekmesine gidin ve 新規広告スポット (New Ad Spot) düğmesini tıklayın.

create_ad_spot

Ardından 広告スポット名 (Reklam Alanı adı), 広告スポットサイズ (Reklam Alanı boyutu) ve diğer ayrıntıları girerek formu doldurun. Ardından, 新規登録 (Sign up) 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 (Yayıncı Kimliği), メディアID (Medya Kimliği) ve スポットID (Nokta Kimliği) değerlerini not edin. Ad Manager kullanıcı arayüzünde i-mobile'ı uyumlulaştırma için yapılandırırken bu parametrelere ihtiyacınız olacaktır.

app-ads.txt dosyanızı güncelleme

Uygulamalar İçin Yetkili Satıcılar app-ads.txt, uygulama reklamı envanterinizin yalnızca yetkili olarak tanımladığınız kanallar üzerinden satılmasını sağlamaya yardımcı olan bir IAB Tech Lab girişimidir. Reklam gelirinde önemli ölçüde kayıp yaşanmasını önlemek için bir app-ads.txt dosyası uygulamanız gerekir. Henüz yapmadıysanız Ad Manager için bir app-ads.txt dosyası oluşturun.

i-mobile için app-ads.txt uygulamasını kullanmak istiyorsanız Sık Sorulan Sorular bölümüne bakın.

2. adım: Ad Manager kullanıcı arayüzünde i-mobile talebini 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ünde, uyumlulaştırma eklemek istediğiniz reklam birimini Envanter ve Mobil uygulama altında seçin.

Ardından Getiri iş ortağı ekle düğmesini tıklayın.

i-mobile için zaten bir getiri iş ortağınız varsa bu iş ortağını seçebilirsiniz. Aksi takdirde Yeni bir getiri iş ortağı oluştur'u seçin.

Reklam ağı olarak i-mobile'ı seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin.

Otomatik veri toplama'yı etkinleştirin ve Giriş adı ile API şifresini girin.

Getiri iş ortağı seçildikten sonra Entegrasyon türü olarak Mobil SDK uyumlulaştırması'nı, Platform olarak Android'i ve Durum olarak Etkin'i seçin. Önceki bölümde alınan Yayıncı Kimliği, Medya Kimliği ve Spot Kimliği'ni girin. Ardından, bir varsayılan BGBM değeri girin.

İşleminiz 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ısını 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")
    }
  }
}

Uygulama düzeyindeki gradle dosyanıza aşağıdaki uygulama bağımlılıklarını ekleyin:

Kotlin

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

Modern

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

Manuel entegrasyon

i-mobile SDK'nın en yeni sürümünü indirin ve sdk klasöründeki android-ad-sdk.aar öğesini çıkarıp projenize ekleyin.
Google'ın Maven deposunda i-mobile bağdaştırıcı yapılarına gidin. En yeni sürümü seçin, i-mobile bağdaştırıcısının .aar dosyasını indirip projenize ekleyin.

4. adım: Gerekli kodu ekleyin

Reklamı etkinlik bağlamıyla yükleme

Banner, geçiş reklamı, ödüllü ve doğal reklam biçimleri yüklenirken Activity bağlamını iletin.Etkinlik bağlamı olmadan reklam yükleme başarısız olur.

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

Test reklamlarını etkinleştirme

Ad Manager için test cihazınızı kaydettiğinizden emin olun. i-mobile, test için test amaçlı Spot Kimliği, Medya Kimliği ve Yayıncı Kimliği sağlar. Bunları burada bulabilirsiniz.

Test reklamlarını doğrulama

i-mobile'dan test reklamları aldığınızı doğrulamak için i-mobile (Şelale) 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ı doldurur.

Alan	i-mobile bağdaştırıcısı tarafından her zaman dahil edilen öğeler
Başlık
Resim
Body
Uygulama simgesi	¹
Harekete geçirici mesaj
Yıldız puanı
Mağaza
Fiyat

¹ Doğal reklamlar için i-mobile SDK'sı, uygulama simgesi öğesi sağlamaz. Bunun yerine, i-mobile bağdaştırıcısı uygulama simgesini şeffaf bir resimle doldurur.

Hata kodları

Adaptör i-mobile'dan reklam alamıyorsa yayıncılar aşağıdaki sınıflarda ResponseInfo.getAdapterResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

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üklenemediğinde i-mobile bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

Hata kodu	Neden
0-99	i-mobile SDK'sı bir hata döndürdü. Daha fazla bilgi için kodu inceleyin.
101	i-mobile, reklamları yüklemek için bir `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 doğal reklam yükleme başarılı geri çağırma işlevi boş bir doğal reklam listesi döndürdü.
105	İstek, yaş sınırına tabi işlem içeriyordu ancak i-mobile SDK'sı yaş sınırına tabi sinyalleri alamıyor