Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl uyumlulaştırma kullanarak InMobi'den gelen reklamlar hem şelale hem teklif entegrasyonlarını kapsar. Burada, InMobi'nin ve InMobi SDK'sı ile InMobi SDK'sının nasıl entegre edileceği ve bağdaştırıcısını bir uygulamaya Unity dönüştürün.
Desteklenen entegrasyonlar ve reklam biçimleri
Entegrasyon | |
---|---|
Teklif verme | 1 |
Şelale | |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü |
1 Teklif entegrasyonu kapalı beta sürümü kullanıyorsanız erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.
Şartlar
- En son Google Mobile Ads SDK'sı .
- Unity 4 veya sonraki sürümler .
- Android'de dağıtmak için
- Android API düzeyi 21 veya üstü
- iOS'te dağıtmak için
- 10.0 veya sonraki bir iOS dağıtım hedefi
- Google ile yapılandırılmış, çalışan bir Unity proje Mobile Ads SDK'sı. Görüntüleyin Ayrıntılı bilgi için Başlarken.
- Arabuluculuğu tamamlama Başlangıç kılavuzu
1. Adım: InMobi kullanıcı arayüzünde yapılandırmaları ayarlayın
InMobi hesabına kaydolun.
Teklif
InMobi STP'yi Google Open Bidding ile kullan'ı seçin ve Google yayıncı kimliğinizi girin.
Şelale
Şelale entegrasyonları için ek bir adım gerekmez.
Doğrulandıktan sonra InMobi hesabınıza giriş yapın.
Uygulama ekle
Uygulamanızı InMobi kontrol paneline eklemek için Envanter > Envanter Ayarları'nı tıklayın.
Envanter Ekle'yi tıklayın ve açılır menüden Mobil Uygulama kanalını seçin.
Arama çubuğuna yayınlanan uygulama mağazası URL'nizi yazmaya başlayın ve otomatik olarak doldurulan sonuçlardan uygulamayı seçin. Devam'ı tıklayın.
Uygulamanız yayınlanmadıysa Manuel olarak bağla'yı tıklayın ve gerekli ayrıntıları girin. Devam'ı tıklayın.
Uygulama ve Web Sitesi Uyumluluğu ayarlarını inceleyin ve ardından Kaydet ve Yerleşimleri Oluştur'u tıklayın.
Yerleşimler
Envanterinizi oluşturduktan sonra, sistem sizi yerleşim oluşturma iş akışına yönlendirir.
Teklif
Reklam biriminin türünü seçin. Bir Yerleşim Adı girin, sırasıyla Kitle Teklif Verme ve İş Ortağı için Açık ve Google Open Bidding'i seçin ve formun geri kalanını doldurun. İşlemi tamamladığınızda Yerleşim Oluştur'u tıklayın.
Şelale
Reklam biriminin türünü seçin. Ardından bir Yerleşim Adı girin, Kitle Teklif Verme için Kapalı'yı seçin ve formun geri kalanını doldurun. İşlemi tamamladığınızda Yerleşim Oluştur'u tıklayın.
Yerleşim oluşturulduktan sonra ayrıntıları gösterilir.AdMob Reklam biriminizi ayarlamak için kullanılacak olan Yerleşim kimliğini not alın.
Hesap Kimliği
InMobi hesap kimliğinizi Finans > Ödeme Ayarları > Ödeme Bilgileri bölümünde bulabilirsiniz.
InMobi Reporting API Anahtarını Bulma
Teklif
Bu adım, teklif entegrasyonları için gerekli değildir.
Şelale
Hesabım > Hesap Ayarları'na gidin. API Anahtarı sekmesine gidin ve API Anahtarı Oluştur'u tıklayın.
Anahtarın gerektiği kullanıcının e-posta adresini seçin ve API Anahtarı Oluştur'u tıklayın. API anahtarını ve kullanıcı adını/giriş adını içeren bir dosya oluşturulur.
Yalnızca hesabın yayıncı yöneticisi tüm kullanıcılar için bir API anahtarı oluşturabilir. Daha önce oluşturulan API anahtarını unuttuysanız API Anahtarı sekmesinde postanızın üzerine gelerek API anahtarınızı sıfırlayın.
Test modunu aç
Yerleşiminiz için tüm canlı gösterimlerde veya yalnızca belirli test cihazlarında Test Modu'nu etkinleştirin.
2. Adım: Kullanıcı arayüzünde InMobi talebini ayarlayın AdMob
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Android
Talimatlar için Android kılavuzunun 2. adımına bakın.
iOS
Talimatlar için iOS rehberinin 2. adımına göz atın.
GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine InMobi ekleyin
.GDPR ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayarak AdMob kullanıcı arayüzünde GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine InMobi ekleyin.
3. Adım: InMobi SDK'sını ve bağdaştırıcısını içe aktarın
InMobi için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin
indirme bağlantısından
Changelog (Değişiklik günlüğü) ve ayıklama
GoogleMobileAdsInMobiMediation.unitypackage
.
Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel
Paketleyin'i tıklayın ve istediğiniz GoogleMobileAdsInMobiMediation.unitypackage
dosyasını seçin.
indirildi. Tüm dosyaların seçili olduğundan emin olun ve İçe Aktar'ı tıklayın.
Ardından Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici > Kuvvet
Çöz'e dokunun. Unity Play Hizmetleri Çözümleyici kitaplığı bağımlılık gerçekleştirir
ve beyan edilen bağımlılıkları
Unity uygulamanızın Assets/Plugins/Android
dizini.
4. Adım: Gizlilik ayarlarını InMobi SDK'sında uygulayın
AB kullanıcı rızası ve GDPR
Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.
InMobi sürüm 2.1.0 için Google Mobile Ads uyumlulaştırma eklentisine
İzin bilgilerini Google Ads'e aktarmanıza olanak tanıyan InMobi.UpdateGDPRConsent()
yöntemi
InMobi'ye gidin. Aşağıdaki örnek kod, izin bilgilerinin
InMobi SDK'sı. Bu yöntemi çağırmayı seçerseniz bunu önceden
Google Mobile Ads SDK'sı ile reklam isteğinde bulunma
using GoogleMobileAds.Api.Mediation.InMobi;
using System.Collections.Generic;
// ...
Dictionary<string, string> consentObject = new Dictionary<string, string>();
consentObject.Add("gdpr_consent_available", "true");
consentObject.Add("gdpr", "1");
InMobi.UpdateGDPRConsent(consentObject);
InMobi'nin GDPR uygulaması konusuna bakın ayrıntılar inMobi'nin kabul ettiği olası anahtarlar ve değerler hakkında daha fazla bilgi bu izin nesnesini tanımlayın.
ABD eyalet gizlilik yasaları
. ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.
InMobi'nin web sitesine göz atın CCPA belgeleri inceleyin.
5. Adım: Gerekli ilave kodu ekleyin
Android
InMobi entegrasyonuna gerek yoktur.
iOS
SKAdNetwork entegrasyonu
InMobi'nin
belgeleri
kullanarak projenizin Info.plist
dosyasına SKAdNetwork tanımlayıcılarını ekleyin.
6. Adım: Uygulamanızı test edin
Test reklamlarını etkinleştir
AdMob için test cihazınızı kaydettiğinizden ve InMobi kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.
Test reklamlarını doğrulama
InMobireklam kaynağından test reklamları aldığınızı doğrulamak için InMobi (Bidding) and InMobi (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
İsteğe bağlı adımlar
Android
İzinler
InMobi, optimum performans için aşağıdaki isteğe bağlı öğelerin eklenmesini önerir
uygulamanızın AndroidManifest.xml
dosyasına izin verin.
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
İsteğe bağlı olarak bu izinleri
Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml
dosyası yükleyin.
iOS
iOS entegrasyonu için ek bir işlem yapmanıza gerek yoktur.
Hata kodları
Bağdaştırıcı InMobi'den bir reklam alamazsa yayıncılar
kullanarak reklam yanıtından gelen temel hata
ResponseInfo
şu sınıflarda:
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
Aşağıdakiler, Reklamın yüklenmemesi:
Android
Hata kodu | Neden |
---|---|
0-99 | InMobi SDK Hataları. Kodu inceleyin inceleyebilirsiniz. |
100 | Kullanıcı arayüzünde yapılandırılan InMobi sunucu parametreleri AdMob eksik/geçersiz. |
101 | InMobi SDK'sı başlatılamadı. |
102 | İstenen reklam boyutu, InMobi tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
103 | Reklam isteği, birleştirilmiş bir doğal reklam isteği değil. |
104 | InMobi SDK'sı başlatılmadan InMobi reklamı istemeye çalışıldı. Bu bağdaştırıcı InMobi SDK'sını başlattığından teorik olarak hiçbir zaman gerçekleşmemelidir oluşturmanız gerekir. |
105 | InMobi'nin reklamı henüz gösterilmeye hazır değil. |
106 | InMobi bir reklam gösteremedi. |
107 | InMobi, gerekli bir öğenin eksik olduğu bir doğal reklam döndürdü. |
108 | InMobi'nin doğal reklam resim öğeleri, bozuk biçimli bir URL içeriyor. |
109 | Bağdaştırıcı, InMobi'nin doğal reklam resim öğelerini indiremedi. |
iOS
Hata kodu | Neden |
---|---|
101 | Kullanıcı arayüzünde yapılandırılan InMobi sunucu parametreleri AdMob eksik/geçersiz. |
102 | InMobi Bağdaştırıcısı, istenen reklam biçimini desteklemiyor. |
103 | Bu ağ yapılandırması için bir InMobi reklamı zaten yüklü. |
Diğer | InMobi SDK'sı hata döndürdü. Ayrıntılı bilgi için IMRequestStatus.h sayfasını inceleyin. |
InMobi Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü
Sonraki Sürüm
DummyClient
adlı dosyaPlaceholderClient
olarak yeniden adlandırıldı.
Sürüm 4.6.2
- InMobi Android bağdaştırıcısının 10.7.4.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.7.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.6.1
- InMobi Android bağdaştırıcısının 10.7.4.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.7.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.6.0
- InMobi Android bağdaştırıcısının 10.7.3.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.7.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.5.1
- InMobi Android bağdaştırıcısının 10.6.7.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.7.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.5.0
- InMobi Android bağdaştırıcısının 10.6.7.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.7.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.4.1
- InMobi Android bağdaştırıcısının 10.6.2.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.6.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 8.6.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.4.0
- InMobi Android bağdaştırıcısının 10.6.0.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.6.0.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 8.6.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.3.3
- InMobi Android bağdaştırıcısının 10.5.8.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.5.8.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.5.2 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.3.0
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/InMobi/
hedefine taşındı. - Bağdaştırıcı ad alanı,
GoogleMobileAds.Mediation.InMobi
kullanılacak şekilde yeniden düzenlendi. - InMobi Android bağdaştırıcısının 10.5.4.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.5.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.2.2
- InMobi Android bağdaştırıcısının 10.1.2.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.1.2.1 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 7.3.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.2.1
- InMobi Android bağdaştırıcısının 10.1.2.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.1.2.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 7.3.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.2.0
- InMobi Android bağdaştırıcısının 10.1.1.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.1.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.3.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.1.0
- InMobi Android bağdaştırıcısının 10.0.9.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.1.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.3.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.0.4
- InMobi Android bağdaştırıcısının 10.0.7.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.0.7.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.2 sürümüyle geliştirilip test edilmiştir.
Sürüm 4.0.3
- InMobi Android bağdaştırıcısının 10.0.5.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.0.5.0 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 4.0.2
- InMobi Android bağdaştırıcısının 10.0.3.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.0.2.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 4.0.1
- InMobi Android bağdaştırıcısının 10.0.3.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.0.2.0 sürümünü destekler.
Sürüm 4.0.0
- InMobi Android bağdaştırıcısının 10.0.1.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 10.0.1.0 sürümünü destekler.
Sürüm 3.2.0
- InMobi Android bağdaştırıcısının 9.2.0.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.2.1.0 sürümünü destekler.
Sürüm 3.1.2
- InMobi Android bağdaştırıcısının 9.1.9.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.1.7.0 sürümünü destekler.
Sürüm 3.1.1
- InMobi Android bağdaştırıcısının 9.1.1.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.1.1.0 sürümünü destekler.
Sürüm 3.1.0
- InMobi Android bağdaştırıcısının 9.1.0.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.1.0.0 sürümünü destekler.
Sürüm 3.0.3
- InMobi Android bağdaştırıcısının 9.0.7.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.0.7.2 sürümünü destekler.
Sürüm 3.0.2
- InMobi Android bağdaştırıcısının 9.0.7.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.0.7.0 sürümünü destekler.
Sürüm 3.0.1
- InMobi Android bağdaştırıcısının 9.0.6.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.0.7.0 sürümünü destekler.
Sürüm 3.0.0
- InMobi Android bağdaştırıcısının 9.0.4.0 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 9.0.4.0 sürümünü destekler.
Sürüm 2.4.0
- InMobi Android bağdaştırıcısının 7.3.0.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısının 7.4.0.0 sürümünü destekler.
Sürüm 2.3.0
- Android bağdaştırıcısı 7.2.9.0 sürümünü destekler.
- iOS bağdaştırıcısı 7.3.2.0 sürümünü destekler.
Sürüm 2.2.2
- Eklenti, yeni Ödüllü API'yi destekleyecek şekilde güncellendi.
- Android bağdaştırıcısı 7.2.7.0 sürümünü destekler.
- iOS bağdaştırıcısı 7.2.7.0 sürümünü destekler.
Sürüm 2.2.1
- Android bağdaştırıcısı 7.2.2.0 sürümünü destekler.
- iOS bağdaştırıcısı 7.2.4.0 sürümünü destekler.
Sürüm 2.2.0
- Android bağdaştırıcısı 7.2.1.0 sürümünü destekler.
- iOS bağdaştırıcısı 7.2.0.0 sürümünü destekler.
Sürüm 2.1.2
- Android bağdaştırıcısı 7.1.1.1 sürümünü destekler.
- iOS bağdaştırıcısı 7.1.2.0 sürümünü destekler.
Sürüm 2.1.1
- Android bağdaştırıcısı 7.1.1.1 sürümünü destekler.
- iOS bağdaştırıcısı 7.1.1.2 sürümünü destekler.
Sürüm 2.1.0
- Android bağdaştırıcısı 7.1.0.0 sürümünü destekler.
- iOS bağdaştırıcısı 7.1.1.1 sürümünü destekler.
InMobi.UpdateGDPRConsent()
yöntemi eklendi.
Sürüm 2.0.0
- Android bağdaştırıcısı 7.0.4.0 sürümünü destekler.
- iOS bağdaştırıcısı 7.1.1.0 sürümünü destekler.
Sürüm 1.0.0
- İlk çıkış tarihi!
- Android bağdaştırıcısı 6.2.4.0 sürümünü destekler.
- iOS bağdaştırıcısı 6.2.1.0 sürümünü destekler.