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'ın kontrol paneli arayüzünde etiketler, düğmeler ve açıklamalar için Japonca metin kullanılmıştı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 uyumlulaştırma bağdaştırıcısı Ad Manager şu ö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ğıtım yapmak 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, Advertiser規 (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: Kullanıcı arayüzünde i-mobile talebini Ad Manager ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
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 projenize Unity için Google Mobile Ads i-mobile Uyumlulaştırma Eklentisini yükleyebilirsiniz:
openupm add com.google.ads.mobile.mediation.imobile
OpenUPM
Unity proje düzenleyicinizde Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçerek Unity Paket Yöneticisi Ayarları'nı açın.
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, Pencere > Paket Yöneticisi'ne giderek Unity Paket Yöneticisi'ni açın ve açılır menüden Kayıtlarım'ı seçin.
Google Mobile Ads i-mobile Uyumlulaştırması paketini seçin ve Yükle'yi tıklayın.
Unity Paketi
Değişiklik günlüğündeki indirme bağlantısını kullanarak i-mobile için Google Mobile Ads uyumlulaştırma eklentisinin en yeni sürümünü indirin ve zip dosyasından GoogleMobileAdsIMobileMediation.unitypackage
öğesini çı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üklenemediğinde i-mobile adaptörü tarafından gönderilen kodlar ve beraberindeki 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 | Ad Manager 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ılı geri çağırması boş bir yerel reklam listesi döndürdü. |
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 | 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 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üğü
Sürüm 1.3.6
- i-mobile Android Adaptör 2.3.2.0 sürümünü destekler.
- i-mobile iOS bağdaştırıcının 2.3.4.1 sürümünü destekler.
- Google Mobil Reklamlar 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 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üyle geliştirilip 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.
Sürüm 1.3.2
- 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 bağdaştırıcı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 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 bağdaştırıcısı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üyle geliştirilip 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 bağdaştırıcısı 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 çıkış tarihi!
- 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.