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

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 aracını nasıl kullanacağınız 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 iOS 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 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:

  • iOS 13.0 veya sonraki sürüm dağıtım hedefi

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.

広告スポット管理 (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. 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. Bunu 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 şifresi'ni girin.

Getiri iş ortağı seçildikten sonra Entegrasyon türü olarak Mobil SDK Uyumlulaştırması'nı, Platform olarak iOS'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 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

Swift Package Manager'ı kullanma

Devam etmeden önce, desteklenen minimum bağdaştırıcı sürümü olan 2.3.4.2'ye sahip olmanız gerekir.

Projenize paket bağımlılığı eklemek için aşağıdaki adımları uygulayın:

  1. Xcode'da File (Dosya) > Add Package Dependencies... (Paket Bağımlılıkları Ekle...) bölümüne gidin.

  2. Görüntülenen istemde aşağıdaki paket URL'sini arayın:

    https://github.com/googleads/googleads-mobile-ios-mediation-imobile.git
    
  3. Bağımlılık Kuralı'nda Dal'ı seçin.

  4. Metin alanına main yazın.

CocoaPods'u kullanma

  • Aşağıdaki satırı projenizin Podfile dosyasına ekleyin:

    pod 'GoogleMobileAdsMediationIMobile'
    
  • Komut satırından şu komutu çalıştırın:

    pod install --repo-update

Manuel entegrasyon

  • i-mobile SDK'sının en yeni sürümünü indirin ve projenize ImobileSdkAds.framework bağlayın.
  • i-mobile bağdaştırıcısının en yeni sürümünü Değişiklik Günlüğü'ndeki indirme bağlantısından indirin ve projenizdeki IMobileAdapter.framework dosyasını bağlayın.

4. adım: Gerekli kodu ekleyin

SKAdNetwork'ü uygulama

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

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ü, GADNativeAd 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 1
Harekete geçirici mesaj
Yıldız puanı
Mağaza
Fiyat

1 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 alamazsa yayıncılar aşağıdaki sınıflarda GADResponseInfo.adNetworkInfoArray kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

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:

Hata kodu Neden
0-10 i-mobile SDK'sı bir hata döndürdü. Daha fazla bilgi için koda bakın.
101 Ad Manager kullanıcı arayüzünde yapılandırılan i-mobile sunucu parametreleri 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 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.
107 Yaş kısıtlamalı sinyaller alamadığı için i-mobile SDK'ya yönelik yaş kısıtlamalı istekleri filtreleyin.

i-mobile iOS Uyumlulaştırma Adaptörü Değişiklik Günlüğü

2.3.4.8 sürümü

  • Alt sürümlere izin vermek için Google Mobile Ads SDK'sı bağımlılığını esnetmek amacıyla minimum iOS sürümü güncellendi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.7.0 sürümü.
  • i-mobile SDK'sı 2.3.4 sürümü.

Sürüm 2.3.4.7

  • Yeni ageRestrictedTreatment, GADAgeRestrictedTreatmentChild olarak ayarlandığında i-mobile SDK için yaş kısıtlamalı istekleri filtreleyin.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.4.0 sürümü.
  • i-mobile SDK'sı 2.3.4 sürümü.

Sürüm 2.3.4.6

  • Yaş kısıtlamalı sinyaller alamadığı için i-mobile SDK'ya yönelik yaş kısıtlamalı istekleri filtreleyin.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.2.0 sürümü.
  • i-mobile SDK'sı 2.3.4 sürümü.

2.3.4.5 sürümü

  • Google Mobile Ads SDK'sı bağımlılığı 13.0.0 sürümüne güncellendi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.0.0 sürümü.
  • i-mobile SDK'sı 2.3.4 sürümü.

Sürüm 2.3.4.4

  • CocoaPods minimum iOS sürümü 13.0 olarak güncellendi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 13.0.0 sürümü.
  • i-mobile SDK'sı 2.3.4 sürümü.

Sürüm 2.3.4.3

  • IMobileAdapter modül eşlemesindeki çerçeve ve şemsiye başlık adları düzeltildi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 12.12.0 sürümü
  • i-mobile SDK'sı 2.3.4 sürümü.

2.3.4.2 sürümü

  • Artık Google Mobile Ads SDK'sının 12.0.0 veya sonraki bir sürümünü gerektirir.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 12.0.0 sürümü.
  • i-mobile SDK'sı 2.3.4 sürümü.

Sürüm 2.3.4.1

  • CFBundleShortVersionString, dört yerine üç bileşene sahip olacak şekilde güncellendi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 11.10.0 sürümü
  • i-mobile SDK'sı 2.3.4 sürümü.

Sürüm 2.3.4.0

  • i-mobile SDK 2.3.4 ile uyumluluğu doğrulandı.
  • adSDKVersion içinde i-mobile SDK sürümünü döndürme desteği eklendi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 11.2.0 sürümü.
  • i-mobile SDK'sı 2.3.4 sürümü.

2.3.3.0 sürümü

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

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 11.1.0 sürümü.
  • i-mobile SDK'sı 2.3.3 sürümü.

Sürüm 2.3.2.1

  • Desteği sonlandırılan willBackgroundApplication temsilci yöntemi; banner, geçiş reklamı ve doğal reklam uygulamalarından kaldırıldı.
  • Artık minimum iOS 12.0 sürümü gerekir.
  • Artık Google Mobile Ads SDK'sının 11.0 veya sonraki bir sürümü gerekir.
  • IMobileAdapter.xcframework içinde Info.plist çerçevelerine dahil edildi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 11.0.1 sürümü.
  • i-mobile SDK'sı 2.3.2 sürümü.

2.3.2.0 sürümü

  • i-mobile SDK 2.3.2 ile uyumluluğu doğrulandı.
  • armv7 mimarisi için destek kaldırıldı.
  • Artık minimum iOS 11.0 sürümü gerekir.
  • Artık Google Mobile Ads SDK'sı 10.4.0 veya daha yeni bir sürüm gerektiriyor.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 10.4.0 sürümü.
  • i-mobile SDK'sı 2.3.2 sürümü.

Sürüm 2.3.1.0

  • i-mobile SDK'sı 2.3.1 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 10.3.0 sürümü.
  • i-mobile SDK'sı 2.3.1 sürümü

Sürüm 2.3.0.1

  • Artık Google Mobile Ads SDK'sının 10.0.0 veya daha yeni bir sürümünü gerektirir.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 10.0.0 sürümü.
  • i-mobile SDK'sı 2.3.0 sürümü.

Sürüm 2.3.0.0

  • i-mobile SDK 2.3.0 ile uyumluluğu doğrulandı.
  • Artık Google Mobile Ads SDK'sı 9.8.0 veya daha yeni bir sürüm gerektiriyor.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 9.13.0 sürümü.
  • i-mobile SDK'sı 2.3.0 sürümü.

Sürüm 2.2.0.1

  • Artık Google Mobile Ads SDK'sının 9.0.0 veya daha yeni bir sürümü gerekir.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 9.0.0 sürümü.
  • i-mobile SDK'sı 2.2.0 sürümü.

Sürüm 2.2.0.0

  • i-mobile SDK'sının 2.2.0 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 8.13.0 sürümü.
  • i-mobile SDK'sı 2.2.0 sürümü.

Sürüm 2.1.0.1

  • Google Mobile Ads SDK'sı 8.0.0 veya sonraki sürümlere olan bağımlılık esnetildi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 8.4.0 sürümü.
  • i-mobile SDK'sı 2.1.0 sürümü.

Sürüm 2.1.0.0

  • i-mobile SDK'sının 2.1.0 sürümüyle uyumluluğu doğrulandı.
  • Artık Google Mobile Ads SDK'sı 8.1.0 veya daha yeni bir sürüm gerektiriyor.
  • Adaptör, .xcframework biçimini kullanacak şekilde güncellendi.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 8.1.0 sürümü.
  • i-mobile SDK'sı 2.1.0 sürümü.

Sürüm 2.0.33.1

  • Standartlaştırılmış bağdaştırıcı hata kodları ve mesajları eklendi.
  • Adaptör artık aynı i-mobile Spot Kimliği kullanılarak birden fazla geçiş reklamı istenmesini sınırlıyor.
  • Bağdaştırıcı artık yerel reklamlara dokunulduğunda -nativeAdWillLeaveApplication: geri çağırma işlevini yönlendiriyor.
  • Artık Google Mobile Ads SDK'sı 7.68.0 veya daha yeni bir sürüm gerektiriyor.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 7.68.0 sürümü
  • i-mobile SDK'sı 2.0.33 sürümü.

Sürüm 2.0.33.0

  • i-mobile SDK'sının 2.0.33 sürümüyle uyumluluğu doğrulandı.
  • Artık Google Mobile Ads SDK'sı 7.65.0 veya daha yeni bir sürüm gerektirir.
  • Artık minimum iOS sürümü 9.0 olmalıdır.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 7.65.0 sürümü.
  • i-mobile SDK'sı 2.0.33 sürümü.

Sürüm 2.0.32.0

  • i-mobile SDK'sının 2.0.32 sürümüyle uyumluluğu doğrulandı.
  • Artık Google Mobile Ads SDK'sının 7.60.0 veya daha yeni bir sürümünü gerektirir.
  • Uyarlanabilir banner istek boyutlarına daha iyi uyması için 320x50 ve 320x100 boyutundaki reklamları ölçeklendirme desteği eklendi.
  • i386 mimarisi için destek kaldırıldı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 7.60.0 sürümü.
  • i-mobile SDK'sı 2.0.32 sürümü.

Sürüm 2.0.31.0

  • i-mobile SDK'sının 2.0.31 sürümüyle uyumluluğu doğrulandı.

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 7.53.1 sürümü.
  • i-mobile SDK'sı 2.0.31 sürümü.

Sürüm 2.0.29.0

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

Aşağıdakilerle geliştirilip test edilmiştir:

  • Google Mobile Ads SDK'sı 7.52.0 sürümü.
  • i-mobile SDK'sı 2.0.29 sürümü.