Bu kılavuzda, şelale entegrasyonlarını kapsayacak şekilde AdMob Aracılığı'nı kullanarak i-mobile'dan reklam yüklemek ve göstermek için Google Mobile Ads SDK'sının nasıl kullanılacağı açıklanmaktadır. Bu dokümanda, i-mobile'ın bir reklam biriminin aracılık yapılandırmasına nasıl ekleneceği ve i-mobile SDK'sının ve bağdaştırıcısının bir iOS uygulamasına nasıl entegre edileceği açıklanmaktadır.
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, İngilizce dilindeki karşılıklarıyla birlikte parantez içinde çevrilmiştir.
Desteklenen entegrasyonlar ve reklam biçimleri
i-mobile için arabuluculuk 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
- iOS 12.0 veya sonraki bir sürümün dağıtım hedefi
En yeni Google Mobile Ads SDK'sı
Uyumlulaştırma Başlangıç kılavuzunu tamamlama
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/Application Management) sekmesini ve uygulamanızın platformuna ait düğmeyi tıklayarak uygulamanızı i-mobile kontrol paneline ekleyin.
Formu doldurun ve 新規登録 (Sign up) düğmesini tıklayın.
Yeni bir reklam alanı 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.
Ardından, 広告スポット名 (Ad Spot name), 広告スポットサイズ (Ad Spot size) ve diğer ayrıntıları girerek formu doldurun. Ardından 新規登録 (Kaydol) düğmesini tıklayın.
Yeni reklam alanınız hazır. Entegrasyon ayrıntılarını görüntülemek için アプリ設定取得 (Get App settings) düğmesini tıklayın.
パブリッシャーID (Yayıncı Kimliği), メディアID (Medya Kimliği) ve スポットID (Spot Kimliği)'ni not edin. Bu parametrelere daha sonra AdMob kullanıcı arayüzünde i-mobile'ı aracılık için yapılandırırken 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
uygulamanız için bir app-ads.txt dosyası oluşturun.
i-mobile için app-ads.txt uygulamak üzere 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 aracılık ayarlarını yapılandırma
i-mobile'ı reklam biriminizin aracılık yapılandırmasına eklemeniz gerekir.
Öncelikle AdMob hesabınızda oturum açın. Ardından Aracılık 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, aracılık 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örmelisiniz:
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 aldığınız Giriş adı ve API şifresini girin. Ardından i-mobile için bir eBGBM değeri girin ve Devam'ı tıklayın.
i-mobile için zaten bir eşleme oluşturduysanız bu eşlemeyi seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.
Ardından, önceki bölümde aldığınız 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
CocoaPods'u kullanma (önerilir)
Aşağıdaki satırı projenizin Podfile'ına ekleyin:
pod 'GoogleMobileAdsMediationIMobile'
Komut satırından şunu çalıştırın:
pod install --repo-updateManuel entegrasyon
- i-mobile SDK'sının en yeni sürümünü indirip projenizde
ImobileSdkAds.frameworkbağlantısını oluşturun. - i-mobile bağdaştırıcısının en son sürümünü Değişiklik Günlüğü'ndeki indirme bağlantısından ve projenizdeki bağlantıdan
IMobileAdapter.frameworkindirin.
4. adım: Gerekli kodu ekleyin
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 Spot ID, Media ID ve Publisher ID sağlar. Bunları burada bulabilirsiniz.
Test reklamlarını doğrulama
i-mobile'dan test reklamları aldığınızı doğrulamak için reklam inceleyicide i-mobile (Şelale) reklam kaynaklarını kullanarak 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
yerel reklamlar gelişmiş alan açıklamalarını
doldurur.
| Alan | Öğeler her zaman i-mobile bağdaştırıcısı tarafından dahil edilir |
|---|---|
| Başlık | |
| Resim | |
| Metin | |
| Uygulama simgesi | 1 |
| Harekete geçirici mesaj | |
| Yıldızlı değerlendirme | |
| Depolama | |
| Fiyat |
1 Yerel reklamlarda i-mobile SDK'sı uygulama simgesi öğesi sağlamaz. Bunun yerine, i-mobile adaptörü uygulama simgesini şeffaf bir resimle doldurur.
Hata kodları
Adaptör i-mobile'dan reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında 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 oluşturulan kodlar ve ilgili mesajlar aşağıda verilmiştir:
| Hata kodu | Neden |
|---|---|
| 0-10 | i-mobile SDK'sı hata döndürdü. Daha fazla bilgi için koda göz atı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 gösteremedi. |
| 104 | i-mobile, boş bir yerel reklam dizisi döndürdü. |
| 105 | i-mobile, yerel reklam öğelerini indiremedi. |
| 106 | i-mobile, aynı nokta kimliği kullanılarak birden fazla geçiş reklamı isteğinde bulunmayı desteklemez. |
i-mobile iOS Uyumlulaştırma Adaptörü Değişiklik Günlüğü
Sonraki sürüm
- -fobjc-arc ve -fstack-protector-all seçeneklerini etkinleştirin.
Sürüm 2.3.4.2
- Artık Google Mobile Ads SDK'sının 12.0.0 veya daha sonraki bir sürümü gereklidir.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 12.0.0 sürümü.
- i-mobile SDK sürümü 2.3.4.
Sürüm 2.3.4.1
CFBundleShortVersionString, dört bileşen yerine üç bileşen içerecek şekilde güncellendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 11.10.0 sürümü.
- i-mobile SDK sürümü 2.3.4.
Sürüm 2.3.4.0
- i-mobile SDK 2.3.4 ile uyumluluk doğrulandı.
adSDKVersioniçinde i-mobile SDK sürümünü döndürme desteği eklendi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 11.2.0 sürümü.
- i-mobile SDK sürümü 2.3.4.
Sürüm 2.3.3.0
- i-mobile SDK 2.3.3 ile uyumluluk doğrulandı.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 11.1.0 sürümü.
- i-mobile SDK sürümü 2.3.3.
Sürüm 2.3.2.1
- Banner, geçiş reklamı ve yerel reklam uygulamalarından kullanımdan kaldırılan
willBackgroundApplicationtemsilci yöntemi kaldırıldı. - Artık minimum iOS sürümü 12.0 gerektiriyor.
- Artık Google Mobile Ads SDK'sının 11.0 veya daha sonraki bir sürümü gereklidir.
IMobileAdapter.xcframeworkiçindeki çerçevelereInfo.plistdahil edildi.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 11.0.1 sürümü.
- i-mobile SDK sürümü 2.3.2.
Sürüm 2.3.2.0
- i-mobile SDK 2.3.2 ile uyumluluk doğrulandı.
armv7mimarisi için destek kaldırıldı.- Artık minimum iOS sürümü 11.0 gerektiriyor.
- Artık Google Mobile Ads SDK'sının 10.4.0 veya daha sonraki bir sürümü gereklidir.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 10.4.0 sürümü.
- i-mobile SDK sürümü 2.3.2.
Sürüm 2.3.1.0
- i-mobile SDK 2.3.1 ile uyumluluk doğrulandı.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 10.3.0 sürümü.
- i-mobile SDK sürümü 2.3.1.
Sürüm 2.3.0.1
- Artık Google Mobile Ads SDK'sının 10.0.0 veya daha sonraki bir sürümü gereklidir.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 10.0.0 sürümü.
- i-mobile SDK sürümü 2.3.0.
Sürüm 2.3.0.0
- i-mobile SDK 2.3.0 ile uyumluluk doğrulandı.
- Artık Google Mobile Ads SDK'sının 9.8.0 veya daha sonraki bir sürümü gereklidir.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 9.13.0 sürümü.
- i-mobile SDK sürümü 2.3.0.
Sürüm 2.2.0.1
- Artık Google Mobile Ads SDK'sının 9.0.0 veya daha sonraki bir sürümü gereklidir.
Aşağıdakilerle tasarlanıp test edilmiştir:
- Google Mobile Ads SDK'sı 9.0.0 sürümü.
- i-mobile SDK sürümü 2.2.0.
Sürüm 2.2.0.0
- i-mobile SDK'sı 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ürümü 2.2.0.
Sürüm 2.1.0.1
- Google Mobile Ads SDK'sının 8.0.0 veya daha sonraki bir sürümüne olan bağımlılık azaltıldı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 8.4.0 sürümü.
- i-mobile SDK sürümü 2.1.0.
Sürüm 2.1.0.0
- i-mobile SDK'sı 2.1.0 sürümüyle uyumluluğu doğrulandı.
- Artık Google Mobile Ads SDK'sının 8.1.0 veya daha sonraki bir sürümü gereklidir.
- Bağdaştırıcı,
.xcframeworkbiç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ürümü 2.1.0.
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.
- Adaptör artık yerel reklamlara dokunulduğunda
-nativeAdWillLeaveApplication:geri çağırmasını yönlendiriyor. - Artık Google Mobile Ads SDK'sının 7.68.0 veya daha sonraki bir sürümü gereklidir.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 7.68.0 sürümü.
- i-mobile SDK sürümü 2.0.33.
Sürüm 2.0.33.0
- i-mobile SDK'sı 2.0.33 sürümüyle uyumluluğu doğrulandı.
- Artık Google Mobile Ads SDK'sının 7.65.0 veya daha sonraki bir sürümü gereklidir.
- Artık minimum iOS sürümü 9.0 gerektiriyor.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı 7.65.0 sürümü.
- i-mobile SDK sürümü 2.0.33.
Sürüm 2.0.32.0
- i-mobile SDK'sı 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 sonraki bir sürümü gereklidir.
- 320x50 ve 320x100 boyutlarındaki reklamların, uyarlanabilir banner istek boyutlarına daha iyi uyacak şekilde ölçeklendirilmesi için destek 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ürümü 2.0.32.
Sürüm 2.0.31.0
- i-mobile SDK'sı 2.0.31 sürümüyle uyumluluğu doğrulandı.
Aşağıdakilerle geliştirilip test edilmiştir:
- Google Mobile Ads SDK'sı sürüm 7.53.1.
- i-mobile SDK sürümü 2.0.31.
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ı sürüm 7.52.0.
- i-mobile SDK sürümü 2.0.29.