Bu kılavuzda, hem şelale hem de teklif entegrasyonlarını kapsayan uyumlulaştırma yöntemini kullanarak InMobi'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. InMobi'nin bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve InMobi SDK ile bağdaştırıcısının bir Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.
Desteklenen entegrasyonlar ve reklam biçimleri
Entegrasyon | |
---|---|
Teklif | 1 |
Şelale | |
Formatlar | |
Banner | |
Geçişli | |
Ödül olarak verildi |
1 Teklifli sistem entegrasyonu kapalı beta sürümündedir. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.
Koşullar
- Unity 4 veya üzeri
- En son Google Mobile Ads SDK'sı
- Android'de dağıtmak için
- Android API düzeyi 19 veya üstü
- iOS'te dağıtmak için
- 10.0 veya üzeri 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şlarken bölümüne bakın.
- Uyumlulaştırmayı tamamlayın 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.
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.Ad Manager 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
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 fareyle 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 Ad Manager ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine InMobi ekle
GDPR ayarları ve ABD eyalet yönetmelikleri ayarları bölümündeki adımları uygulayarak Ad Manager 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ıyı içe aktarın
InMobi için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü, Changelog'daki indirme bağlantısından indirin ve zip dosyasından GoogleMobileAdsInMobiMediation.unitypackage
dosyasını çıkarın.
Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel Paket'i ve indirdiğiniz GoogleMobileAdsInMobiMediation.unitypackage
dosyasını seçin. 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 > Çözmeye Zorla'yı seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemeyi sıfırdan gerçekleştirecek ve beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android
dizinine kopyalayacaktır.
4. Adım: InMobi SDK'sında gizlilik ayarlarını uygulayın
AB kullanıcı rızası alma ve GDPR
Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken, uyumlulaştırma zincirinizde kişisel verileri toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.
InMobi sürüm 2.1.0 için Google Mobile Ads uyumlulaştırma eklentisi, izin bilgilerini InMobi'ye iletmenizi sağlayan InMobi.UpdateGDPRConsent()
yöntemini ekledi. Aşağıdaki örnek kod, izin bilgilerinin InMobi SDK'sına nasıl iletileceğini göstermektedir. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı ile reklam isteğinde bulunmadan önce yapmanızı öneririz.
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 bu izin nesnesinde kabul ettiği olası anahtarlar ve değerler hakkında daha fazla bilgi için InMobi'nin GDPR uygulama ayrıntılarına bakın.
ABD eyalet gizlilik yasaları
ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar ancak Google, bu ayarı uyumlulaştırma zincirinizdeki her reklam ağına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgi satışına dahil olabilecek tüm reklam ağlarını belirlemeniz ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.
InMobi'de CCPA ayarlarının nasıl etkinleştirileceğiyle ilgili yönergeler için InMobi'nin CCPA belgelerine bakın.
5. Adım: Gerekli ek kodu ekleyin
Android
InMobi entegrasyonu için ek kod gerekmez.
iOS
SKAdNetwork entegrasyonu
SKAdNetwork tanımlayıcılarını projenizin Info.plist
dosyasına eklemek için InMobi belgelerini uygulayın.
6. Adım: Uygulamanızı test etme
Test reklamlarını etkinleştir
Ad Manager 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
En iyi performans için InMobi, uygulamanızın AndroidManifest.xml
dosyasına aşağıdaki isteğe bağlı izinleri eklemenizi öneriyor.
<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ına ekleyebilirsiniz.
iOS
iOS entegrasyonu için ek adım gerekmez.
Hata kodları
Bağdaştırıcı, InMobi'den reklam alamazsa yayıncılar aşağıdaki sınıflarda ResponseInfo
kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
Aşağıda, bir reklam yüklenemediğinde InMobi bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajlar verilmiştir:
Android
Hata kodu | Neden |
---|---|
0-99 | InMobi SDK Hataları. Daha fazla bilgi için kodu inceleyin. |
100 | Kullanıcı arayüzünde yapılandırılan InMobi sunucu parametreleri Ad Manager eksik/geçersiz. |
101 | InMobi SDK'sı başlatılamadı. |
102 | İstenen reklam boyutu, InMobi'nin desteklediği bir banner boyutuyla eşleşmiyor. |
103 | Reklam isteği, birleştirilmiş bir yerel reklam isteği değil. |
104 | InMobi SDK'sı başlatılmadan bir InMobi reklamı istemeye çalışıldı. Bağdaştırıcı, InMobi reklamlarını istemeden önce InMobi SDK'sını başlattığından teoride hiçbir zaman bu durum yaşanmamalıdır. |
105 | InMobi'nin reklamı henüz gösterilmeye hazır değil. |
106 | InMobi reklam gösteremedi. |
107 | InMobi, gerekli bir öğenin bulunmadığı bir yerel reklam döndürdü. |
108 | InMobi'nin yerel reklam resim öğeleri hatalı biçimlendirilmiş URL içeriyor. |
109 | Bağdaştırıcı, InMobi'nin yerel reklam resim öğelerini indiremedi. |
iOS
Hata kodu | Neden |
---|---|
101 | Kullanıcı arayüzünde yapılandırılan InMobi sunucu parametreleri Ad Manager eksik/geçersiz. |
102 | InMobi Bağdaştırıcısı, istenen reklam biçimini desteklemiyor. |
103 | Bu ağ yapılandırması için zaten bir InMobi reklamı yüklenmiş. |
Diğer | InMobi SDK'sı bir hata döndürdü. Ayrıntılı bilgi için IMRequestStatus.h sayfasına göz atın. |
InMobi Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü
Sürüm 4.4.1
- InMobi Android adaptörü sürüm 10.6.2.0'ı destekler.
- InMobi iOS bağdaştırıcısı 10.6.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.6.0 ile geliştirilip test edilmiştir.
Sürüm 4.4.0
- InMobi Android adaptörü sürüm 10.6.0.0'ı destekler.
- InMobi iOS bağdaştırıcısı 10.6.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.6.0 ile geliştirilip test edilmiştir.
Sürüm 4.3.3
- InMobi Android adaptörü sürüm 10.5.8.0'ı destekler.
- InMobi iOS bağdaştırıcısı 10.5.8.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.5.2 ile geliştirilip test edilmiştir.
Sürüm 4.3.0
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/InMobi/
klasörüne taşındı. - Bağdaştırıcı ad alanı,
GoogleMobileAds.Mediation.InMobi
kullanılacak şekilde yeniden düzenlendi. - InMobi Android adaptörü sürüm 10.5.4.1'i destekler.
- InMobi iOS bağdaştırıcısı 10.5.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.1.0 ile geliştirilip test edilmiştir.
Sürüm 4.2.2
- InMobi Android adaptörü sürüm 10.1.2.1'i destekler.
- InMobi iOS bağdaştırıcısı 10.1.2.1 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.3.1 ile geliştirildi ve test edildi.
Sürüm 4.2.1
- InMobi Android adaptörü sürüm 10.1.2.0'ı destekler.
- InMobi iOS bağdaştırıcısı 10.1.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.3.1 ile geliştirildi ve test edildi.
Sürüm 4.2.0
- InMobi Android adaptörü sürüm 10.1.1.0'ı destekler.
- InMobi iOS bağdaştırıcısı 10.1.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.3.0 ile geliştirilip test edilmiştir.
Sürüm 4.1.0
- InMobi Android adaptörü sürüm 10.0.9.0'ı destekler.
- InMobi iOS bağdaştırıcısı 10.1.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.3.0 ile geliştirilip test edilmiştir.
Sürüm 4.0.4
- InMobi Android adaptörü sürüm 10.0.7.0'ı destekler.
- InMobi iOS bağdaştırıcısı 10.0.7.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.2 ile geliştirilip test edilmiştir.
Sürüm 4.0.3
- InMobi Android adaptörü sürüm 10.0.5.0'ı destekler.
- InMobi iOS bağdaştırıcısı 10.0.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.0 ile geliştirilip test edilmiştir.
Sürüm 4.0.2
- InMobi Android adaptörü sürüm 10.0.3.0'ı destekler.
- InMobi iOS bağdaştırıcısı 10.0.2.1 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.0 ile geliştirilip test edilmiştir.
Sürüm 4.0.1
- InMobi Android adaptörü sürüm 10.0.3.0'ı destekler.
- InMobi iOS bağdaştırıcısı 10.0.2.0 sürümünü destekler.
Sürüm 4.0.0
- InMobi Android adaptörü sürüm 10.0.1.0'ı destekler.
- InMobi iOS bağdaştırıcısı 10.0.1.0 sürümünü destekler.
Sürüm 3.2.0
- InMobi Android adaptörü sürüm 9.2.0.0'ı destekler.
- InMobi iOS bağdaştırıcısı sürüm 9.2.1.0'ı destekler.
Sürüm 3.1.2
- InMobi Android adaptörü sürüm 9.1.9.0'ı destekler.
- InMobi iOS bağdaştırıcısı 9.1.7.0 sürümünü destekler.
Sürüm 3.1.1
- InMobi Android adaptörü sürüm 9.1.1.0'ı destekler.
- InMobi iOS bağdaştırıcısı 9.1.1.0 sürümünü destekler.
Sürüm 3.1.0
- InMobi Android adaptörü sürüm 9.1.0.0'ı destekler.
- InMobi iOS bağdaştırıcısı sürüm 9.1.0.0'ı destekler.
Sürüm 3.0.3
- InMobi Android adaptörü 9.0.7.1 sürümünü destekler.
- InMobi iOS bağdaştırıcısı 9.0.7.2 sürümünü destekler.
Sürüm 3.0.2
- InMobi Android adaptörü sürüm 9.0.7.0'ı destekler.
- InMobi iOS bağdaştırıcısı 9.0.7.0 sürümünü destekler.
Sürüm 3.0.1
- InMobi Android adaptörü sürüm 9.0.6.0'ı destekler.
- InMobi iOS bağdaştırıcısı 9.0.7.0 sürümünü destekler.
Sürüm 3.0.0
- InMobi Android adaptörü sürüm 9.0.4.0'ı destekler.
- InMobi iOS bağdaştırıcısı 9.0.4.0 sürümünü destekler.
Sürüm 2.4.0
- InMobi Android adaptörü sürüm 7.3.0.1'i destekler.
- InMobi iOS bağdaştırıcısı 7.4.0.0 sürümünü destekler.
Sürüm 2.3.0
- Android adaptörü 7.2.9.0 sürümünü destekler.
- iOS bağdaştırıcısının 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ının 7.2.7.0 sürümünü destekler.
- iOS bağdaştırıcısının 7.2.7.0 sürümünü destekler.
Sürüm 2.2.1
- Android adaptör 7.2.2.0 sürümünü destekler.
- iOS bağdaştırıcısının 7.2.4.0 sürümünü destekler.
Sürüm 2.2.0
- Android adaptör 7.2.1.0 sürümünü destekler.
- iOS bağdaştırıcısının 7.2.0.0 sürümünü destekler.
Sürüm 2.1.2
- Android bağdaştırıcısının 7.1.1.1 sürümünü destekler.
- iOS bağdaştırıcısının 7.1.2.0 sürümünü destekler.
Sürüm 2.1.1
- Android bağdaştırıcısının 7.1.1.1 sürümünü destekler.
- iOS bağdaştırıcısının 7.1.1.2 sürümünü destekler.
Sürüm 2.1.0
- Android adaptör 7.1.0.0 sürümünü destekler.
- iOS bağdaştırıcısının 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ının 7.0.4.0 sürümünü destekler.
- iOS bağdaştırıcısının 7.1.1.0 sürümünü destekler.
Sürüm 1.0.0
- İlk sürüm!
- Android bağdaştırıcısının 6.2.4.0 sürümünü destekler.
- iOS bağdaştırıcısının 6.2.1.0 sürümünü destekler.