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

Bu kılavuzda, şelale entegrasyonlarını kapsayan AdMob Uyumlulaştırması'nı 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. AdMob kullanıcı arayüzünde i-mobile'ı uyumlulaştırma için yapılandırırken bu parametrelere ihtiyacınız olacak.

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

i-mobile'ı reklam biriminizin uyumlulaştırma yapılandırmasına eklemeniz gerekir.

Öncelikle AdMob hesabınızda oturum açın. Ardından Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa bu uyumlulaştırma grubunun adını tıklayarak düzenleyin ve i-mobile'ı reklam kaynağı olarak ekleme bölümüne geçin.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu Oluştur'u seçin.

Reklam biçiminizi ve platformunuzu girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın ve Reklam Birimleri Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut AdMob reklam birimlerinizden biri veya daha fazlasıyla ilişkilendirin. Ardından Bitti'yi tıklayın.

Artık seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını göreceksiniz:

i-mobile'ı reklam kaynağı olarak ekleme


Reklam Kaynakları bölümündeki Şelale kartında Reklam Kaynağı Ekle'yi seçin.

i-mobile'ı seçin ve Optimize et anahtarını etkinleştirin. i-mobile için reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde elde edilen Giriş adı ve API Şifresi'ni girin. Ardından i-mobile için bir eBGBM değeri girin ve Devam'ı tıklayın.




i-mobile için zaten bir eşlemeniz varsa bu eşlemeyi seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.



Ardından, önceki bölümde alınan Yayıncı Kimliği, Medya Kimliği ve Spot Kimliği'ni girin. Ardından Bitti'yi tıklayın.

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

Önerilen: 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.

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.

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

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

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.

İsteğe bağlı adımlar

Doğal reklamları kullanma

Reklam oluşturma

i-mobile bağdaştırıcısı, GADNativeAd için aşağıdaki gelişmiş doğal reklam alan açıklamalarını doldurur.

Alan i-mobile bağdaştırıcısı tarafından her zaman dahil edilen öğeler
Başlık
Resim
Gövde
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 alamıyorsa 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 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.
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ı azaltmak 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ü.

2.3.4.6 sürümü

  • 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ü.

Sürüm 2.3.4.2

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

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

2.3.4.1 sürümü

  • 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'sı 2.3.4 sürümüyle 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ü.

Sürüm 2.3.3.0

  • 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ü.

2.3.2.1 sürümü

  • Desteği sonlandırılan willBackgroundApplication temsilci yöntemi; banner, geçiş reklamı ve yerel 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 daha yeni bir sürümü gerekir.
  • IMobileAdapter.xcframework içindeki çerçevelere Info.plist 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 sürümü 11.0'dır.
  • Artık Google Mobile Ads SDK'sının 10.4.0 veya daha yeni bir sürümü gerekir.

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 2.3.1 ile 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 doğal reklamlara dokunulduğunda -nativeAdWillLeaveApplication: geri çağırmasını iletiyor.
  • 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 gerektiriyor.
  • 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ü.