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
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. 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:
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.
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.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.
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,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ü.
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.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ü.
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ı.
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ü.
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
willBackgroundApplicationtemsilci 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.xcframeworkiçindeInfo.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ı.
armv7mimarisi 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,
.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 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ü.