Bu kılavuzda, uyumlulaştırma kullanarak hem şelale hem de teklif entegrasyonlarını kapsayan 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. Bu kılavuzda, InMobi'nin bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve InMobi SDK'sının bir uygulamaya nasıl entegre edilebileceği ile Unity adaptörün nasıl entegre edileceği açıklanmaktadır.
Desteklenen entegrasyonlar ve reklam biçimleri
Entegrasyon | |
---|---|
Teklif | 1 |
Şelale | |
Formatlar | |
Banner | |
Geçişli | |
Ödül olarak verildi | |
Yerel biçim | 2 |
1 Teklif entegrasyonu kapalı beta sürümündedir. Erişim istemek için hesap yöneticinizle iletişime geçin.
Koşullar
- En son Google Mobile Ads SDK'sı
- Unity 4 veya sonraki sürümler
- Android'de dağıtım yapmak için
- Android API düzeyi 21 veya üstü
- iOS'te dağıtım yapmak için
- 10.0 veya sonraki bir iOS dağıtım hedefi
- Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Unity proje. 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 ekleyin
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ısını içe aktarın
Changelog'daki indirme bağlantısından InMobi için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsInMobiMediation.unitypackage
öğesini çıkarın.
Unity proje düzenleyicinizde Assets > Import Package > CustomPackage'ı (Öğeler > Paketi İçe Aktar > Özel Paket) 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.
Sonra, Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici > Zorla Çöz'ü seçin. Unity Play Hizmetleri Çözümleyici 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: Gizlilik ayarlarını InMobi SDK'sında uygulayın
AB kullanıcı rızası ve GDPR
Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcıların ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara belirli açıklamaların yapıldığından ve bu kullanıcılardan alınan izinlerin alındığından emin olmanız 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 toplayabilecek, alabilecek veya kullanabilecek tüm reklam ağlarını tanımlamalı ve her ağın kullanımı hakkında bilgi sağlamalısınız. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.
InMobi'nin 2.1.0 sürümü 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österir. 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 bilgilerinin" "satılmasını" (yasaların bu terimlerin tanımladığı şekilde) devre dışı bırakma seçeneği sunmasını gerektirir. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" bağlantısıyla sunulur. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam sunumu için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar. Ancak Google, bu ayarı uyumlulaştırma zincirinizdeki tüm reklam ağlarına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgi satışına katılabilecek her bir reklam ağını belirlemeli ve uygunluğu sağlamak için bu ağların her birinin talimatlarını takip etmelisiniz.
InMobi için CCPA ayarlarının nasıl etkinleştirileceğiyle ilgili yönergeler için InMobi'nin CCPA belgelerini inceleyin.
5. Adım: Gerekli ilave kodu ekleyin
Android
InMobi entegrasyonuna gerek yoktur.
iOS
SKAdNetwork entegrasyonu
SKAdNetwork tanımlayıcılarını projenizin Info.plist
dosyasına eklemek için InMobi dokümanlarını uygulayın.
6. Adım: Uygulamanızı test edin
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
InMobi, optimum performans için uygulamanızın AndroidManifest.xml
dosyasına aşağıdaki isteğe bağlı izinleri eklemenizi önerir.
<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" />
İsterseniz bu izinleri Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml
dosyasına ekleyebilirsiniz.
iOS
iOS entegrasyonu için ek bir işlem yapmanıza gerek yoktur.
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ında temel alınan hatayı kontrol edebilir:
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
Bir reklam yüklenemediğinde InMobi bağdaştırıcısı tarafından gönderilen kodlar ve beraberindeki mesajlar aşağıda verilmiştir:
Android
Hata kodu | Neden |
---|---|
0-99 | InMobi SDK Hataları. Daha fazla bilgi için koda bakın. |
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 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ı. Bağdaştırıcı, InMobi SDK'sını istemeden önce InMobi SDK'sını başlattığından teorik olarak bu durum hiçbir zaman gerçekleşmemelidir. |
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 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 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üğü
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.