InMobi'yi uyumlulaştırma ile entegre edin

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.

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 AdMob ayarlayın

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 ekle

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ı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

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

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

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 AdMob 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 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 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

Sürüm 4.4.0

Sürüm 4.3.3

Sürüm 4.3.0

Sürüm 4.2.2

Sürüm 4.2.1

Sürüm 4.2.0

Sürüm 4.1.0

Sürüm 4.0.4

Sürüm 4.0.3

Sürüm 4.0.2

Sürüm 4.0.1

Sürüm 4.0.0

Sürüm 3.2.0

Sürüm 3.1.2

Sürüm 3.1.1

Sürüm 3.1.0

Sürüm 3.0.3

Sürüm 3.0.2

Sürüm 3.0.1

Sürüm 3.0.0

Sürüm 2.4.0

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.