Bu kılavuzda, şelale entegrasyonlarını kapsayan arabuluculuk kullanarak i-mobile'dan reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, i-mobile'ın bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve i-mobile SDK'sının ve bağdaştırıcının bir Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.
i-mobile için kontrol paneli arayüzünde etiketler, düğmeler ve açıklamalar Japonca metin kullanır. Bu kılavuzda yer alan ekran görüntüleri çevrilmemiştir. Ancak bu kılavuzun açıklamalarında ve talimatlarında etiketler ile düğmeler, parantez içinde İngilizce karşılıklarıyla birlikte çevrilmiştir.
Desteklenen entegrasyonlar ve reklam biçimleri
i-mobile için AdMob uyumlulaştırma adaptörü aşağıdaki özelliklere sahiptir:
| Entegrasyon | |
|---|---|
| Teklif verme | |
| Şelale | |
| Formatlar | |
| Banner | |
| Geçiş reklamı | |
| Ödüllü | |
Şartlar
- Unity 5.6 veya sonraki sürümler
- En son Google Mobile Ads SDK'sı
- Android'de dağıtmak için
- Android API düzeyi 21 veya sonraki sürümler
- iOS'te dağıtmak için
- 12.0 veya sonraki bir iOS dağıtım hedefi
- Google Mobile Ads SDK'sı ile yapılandırılmış çalışan bir Unity projesi. Ayrıntılar için Başlayın bölümüne bakın.
- Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu
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.
Yapay Zeka
iOS
Formu doldurun ve 新規登録 (Kaydol) düğmesini tıklayın.
Yapay Zeka
iOS
Yeni bir reklam alanı oluşturmak için サイト／アプリ管理 (Site/Uygulama Yönetimi) sekmesinde uygulamanızı seçin.
Yapay Zeka
iOS
広告スポット管理 (Reklam Alanı Yönetimi) sekmesine gidin ve 新規広告スポット (Yeni Reklam Alanı) düğmesini tıklayın.
Ardından, 広告スポット名 (Reklam alanı adı), 広告スポットサイズ (Reklam alanı boyutu) ve diğer bilgileri sağlayarak 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 (Spot Kimliği)'ni not edin. Bu parametrelere daha sonra AdMob kullanıcı arayüzünde uyumlulaştırma için i-mobile'i yapılandırırken ihtiyacınız olacaktır.
Yapay Zeka
iOS
2. Adım: i-mobile talebini AdMob kullanıcı arayüzünde ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Yapay Zeka
Talimatlar için Android kılavuzundaki 2. adıma bakın.
iOS
Talimatlar için iOS kılavuzunun 2. adımına bakın.
3. Adım: i-mobile SDK'sını ve bağdaştırıcısını içe aktarın
OpenUPM-CLI
OpenUPM-CLI yüklüyse projenizin kök dizininden aşağıdaki komutu çalıştırarak Unity için Google Mobil Reklamlar i-mobile Uyumlulaştırma Eklentisi'ni projenize yükleyebilirsiniz:
openupm add com.google.ads.mobile.mediation.imobile
OpenUPM
Unity Paket Yöneticisi Ayarlarını açmak için Unity proje düzenleyicinizde Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçin.
Kapsamlı Kayıt Daireleri sekmesinde, OpenUPM'yi aşağıdaki ayrıntılarla kapsamlı bir kayıt dairesi olarak ekleyin:
- Ad:
OpenUPM - URL:
https://package.openupm.com - Kapsamlar:
com.google
Ardından, Unity Paket Yöneticisi'ni açmak için pencere > Paket Yöneticisi'ne gidin ve açılır menüden Kayıt Dairelerim'i seçin.
Google Mobile Ads i-mobile Mediation paketini seçin ve Yükle'yi tıklayın.
Unity Paketi
i-mobile için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü değişiklik günlüğündeki indirme bağlantısından indirin ve GoogleMobileAdsIMobileMediation.unitypackage dosyasını zip dosyasından çıkarın.
Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsIMobileMediation.unitypackage dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.
Ardından Öğeler > Harici Bağımlılık Yöneticisi > Android Çözücü > Çözümü Zorla'yı seçin. Harici Bağımlılık Yöneticisi kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.
4. Adım: Ek kod gerekli
Yapay Zeka
i-mobile entegrasyonu için ek kod gerekmez.
iOS
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 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.
Hata kodları
Adaptör i-mobile'dan reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:
Yapay Zeka
| Biçim | Sınıf adı |
|---|---|
| Banner | com.google.ads.mediation.imobile.IMobileAdapter |
| Geçiş reklamı | com.google.ads.mediation.imobile.IMobileAdapter |
| Yerel biçim | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
| Biçim | Sınıf adı |
|---|---|
| Banner | IMobileAdapter |
| Geçiş reklamı | IMobileAdapter |
| Yerel biçim | GADMediationAdapterIMobile |
Bir reklam yüklenemezse i-mobile adaptörü tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:
Yapay Zeka
| Hata kodu | Neden |
|---|---|
| 0-99 | i-mobile SDK'sı hata döndürmüştür. Daha fazla bilgi için kod bölümüne bakın. |
| 101 | i-mobile'ın reklam yüklemesi için Activity bağlamı gerekir. |
| 102 | AdMob kullanıcı arayüzünde yapılandırılan i-mobile sunucu parametreleri eksik/geçersiz. |
| 103 | İstenen reklam boyutu, i-mobile tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
| 104 | i-mobile'ın yerel reklam yükleme başarı geri çağırma işlevi boş bir yerel reklam listesi döndürmüştür. |
iOS
| Hata kodu | Neden |
|---|---|
| 0-10 | i-mobile SDK'sı hata döndürmüştür. Daha fazla bilgi için kod bölümüne bakın. |
| 101 | AdMob 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 gösteremedi. |
| 104 | i-mobile boş bir yerel reklam dizisi döndürmüştür. |
| 105 | i-mobile, yerel reklam öğelerini indirmeyi başaramadı. |
| 106 | i-mobile, aynı Spot kimliğini kullanarak birden fazla geçiş reklamı isteğinde bulunmayı desteklemez. |
i-mobile Unity Mediation Plugin Değişiklik Günlüğü
1.3.6 sürümü
- i-mobile Android adaptörünün 2.3.2.0 sürümünü destekler.
- i-mobile iOS adaptörünün 2.3.4.1 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 9.3.0 sürümü ile derlenmiş ve test edilmiştir.
1.3.5 sürümü
- i-mobile Android adaptörünün 2.3.2.0 sürümünü destekler.
- i-mobile iOS adaptörünün 2.3.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.
1.3.4 sürümü
- i-mobile Android bağdaştırıcısı 2.3.1.2 sürümünü destekler.
- i-mobile iOS adaptörünün 2.3.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümü ile derlenmiş ve test edilmiştir.
1.3.3 sürümü
- i-mobile Android bağdaştırıcısı 2.3.1.1 sürümünü destekler.
- i-mobile iOS adaptörünün 2.3.3.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümü ile derlenmiş ve test edilmiştir.
1.3.2 sürümü
- Adaptör içeriği
GoogleMobileAds/Mediation/IMobile/konumuna taşındı. - i-mobile Android bağdaştırıcısı 2.3.1.1 sürümünü destekler.
- i-mobile iOS adaptörünün 2.3.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.1.0 sürümü ile oluşturulup test edilmiştir.
1.3.1 sürümü
- i-mobile Android adaptörünün 2.3.0.0 sürümünü destekler.
- i-mobile iOS adaptörünün 2.3.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.4.1 sürümü ile oluşturulup test edilmiştir.
Sürüm 1.3.0
- i-mobile Android adaptörünün 2.3.0.0 sürümünü destekler.
- i-mobile iOS adaptörünün 2.3.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.3.1 sürümü ile oluşturulup test edilmiştir.
1.2.2 sürümü
- i-mobile Android adaptörünün 2.0.23.1 sürümünü destekler.
- i-mobile iOS adaptörünün 2.2.0.1 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 7.0.2 sürümü ile derlenmiş ve test edilmiştir.
Sürüm 1.2.1
- i-mobile Android adaptörünün 2.0.23.0 sürümünü destekler.
- i-mobile iOS adaptörünün 2.2.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.0 sürümü ile derlenmiş ve test edilmiştir.
Sürüm 1.2.0
- i-mobile Android adaptörünün 2.0.23.0 sürümünü destekler.
- i-mobile iOS adaptörünün 2.2.0.0 sürümünü destekler.
Sürüm 1.1.0
- i-mobile Android adaptörünün 2.0.22.2 sürümünü destekler.
- i-mobile iOS adaptörünün 2.1.0.1 sürümünü destekler.
Sürüm 1.0.2
- i-mobile Android adaptörünün 2.0.22.0 sürümünü destekler.
- i-mobile iOS adaptörünün 2.0.32.0 sürümünü destekler.
Sürüm 1.0.1
- i-mobile Android adaptörünün 2.0.21.0 sürümünü destekler.
- i-mobile iOS adaptörünün 2.0.31.0 sürümünü destekler.
Sürüm 1.0.0
- İlk sürüm!
- i-mobile Android adaptörünün 2.0.20.1 sürümünü destekler.
- i-mobile iOS adaptörünün 2.0.29.0 sürümünü destekler.