i-mobile'ı AdMob Uyumlulaştırması ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma özelliğini kullanarak i-mobile'dan reklam yüklemek ve göstermek için Google Mobile Ads SDK for React Native aracının nasıl kullanılacağı gösterilmektedir. 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 React Native yerel uygulamasına nasıl entegre edileceğini kapsar.

i-mobile'ın kontrol paneli arayüzündeki etiketler, düğmeler ve açıklamalar Japonca metinler içerir. Bu kılavuzdaki ekran görüntüleri çevrilmemiştir. Ancak bu kılavuzun açıklamalarında ve talimatlarında, etiketler ve düğmeler parantez içinde İngilizce karşılıklarıyla çevrilmiştir.

Desteklenen entegrasyonlar ve reklam biçimleri

i-mobile için AdMob uyumlulaştırma bağdaştırıcısının özellikleri şöyledir:

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

Ön koşullar

Devam etmeden önce aşağıdakileri doğrulayı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.

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

Ardından 広告スポット名 (Reklam Spotu adı), 広告スポットサイズ (Reklam Spotu boyutu) ve diğer ayrıntıları girerek formu doldurun. Ardından, 新規登録 (Kaydol) 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. AdMob kullanıcı arayüzünde i-mobile'ı uyumlulaştırma için yapılandırırken bu parametrelere ihtiyacınız olacak.

Android

iOS

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. Bunu henüz yapmadıysanız uygulamanız için bir app-ads.txt dosyası oluşturun.

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

2. adım: AdMob kullanıcı arayüzünde i-mobile talebini ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

Android

Talimatlar için Android kılavuzundaki 2. adıma bakın.

iOS

Talimatlar için iOS kılavuzundaki 2. adıma bakın.

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

Projenizin kök dizinine Google Mobile Ads SDK for React Native i-mobile için uyumlulaştırma bağdaştırıcısını yükleyin. Aşağıdakileri tamamlayın:

  1. gma-sdk-react-native/adapters/imobile/ dizinindeki Google Mobile Ads SDK for React Native bağdaştırıcı tar dosyasını projenizin local_packages/ dizinine kopyalayın. adapters klasörünüz yoksa Ön koşullar bölümüne bakın.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/imobile/gma-mediation-imobile-0.1.0.tgz local_packages/

    EXTRACT_DIR ifadesini, arşivi çıkardığınız dizinin yoluyla değiştirin.

  2. Tercih ettiğiniz paket yöneticisini kullanarak bağdaştırıcı paketini yükleyin:

    npm

    npm install ./local_packages/gma-mediation-imobile-0.1.0.tgz

    yumak

    yarn add ./local_packages/gma-mediation-imobile-0.1.0.tgz

  3. Android için derleme yapıyorsanız projenizin android dizinindeki build.gradle dosyasına aşağıdaki depoyu ekleyin:

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

4. adım: Ek kod gerekli

Android

i-mobile entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için i-mobile'ın dokümanlarını inceleyin.

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

Test reklamlarını etkinleştirme

AdMob 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.

Hata kodları

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

Android

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

iOS

Biçim Sınıf adı
Banner IMobileAdapter
Geçiş reklamı IMobileAdapter
Yerel biçim GADMediationAdapterIMobile

Bir reklam yüklenemediğinde i-mobile bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

Android

Hata kodu Neden
0-99 i-mobile SDK'sı bir hata döndürdü. Daha fazla bilgi için koda bakın.
101 i-mobile, reklamları yüklemek için Activity bağlamı gerektirir.
102 AdMob kullanıcı arayüzünde yapılandırılan i-mobile sunucu parametreleri eksik veya 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ü.

iOS

Hata kodu Neden
0-10 i-mobile SDK'sı bir hata döndürdü. Daha fazla bilgi için koda bakın.
101 AdMob kullanıcı arayüzünde yapılandırılan i-mobile sunucu parametreleri eksik veya 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 doğal reklam dizisi döndürdü.
105 i-mobile, doğal reklam öğelerini indiremedi.
106 i-mobile, aynı nokta kimliğini kullanarak birden fazla geçiş reklamı isteğinde bulunmayı desteklemez.

Sürüm 0.1.0

  • İlk sürüm.