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
En yeni Google Mobile Ads SDK sürümü.
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.
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.
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.
パブリッシャー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:
Xcode'da File (Dosya) > Add Package Dependencies... (Paket Bağımlılıkları Ekle...) bölümüne gidin.
Görüntülenen istemde aşağıdaki paket URL'sini arayın:
https://github.com/googleads/googleads-mobile-ios-mediation-imobile.gitBağımlılık Kuralı'nda Dal'ı seçin.
Metin alanına
mainyazın.
Manuel entegrasyon
- i-mobile SDK'sının en yeni sürümünü indirin ve projenize
ImobileSdkAds.frameworkbağ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.frameworkdosyası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,GADAgeRestrictedTreatmentChildolarak 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.0olarak 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
IMobileAdaptermodü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ı.
adSDKVersioniç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
willBackgroundApplicationtemsilci 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.xcframeworkiçindeki çerçevelereInfo.plistdahil 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ı.
armv7mimarisi 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,
.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ı 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ü.