Bu sayfa, Cloud Translation API ile çevrilmiştir.

InMobi'yi Uyumlulaştırma ile Entegre Etme

Bu kılavuzda, hem şelale hem de teklif entegrasyonlarını kapsayan uyumlulaştırma ile InMobi'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sını nasıl kullanacağınız 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 Android bir uygulamaya nasıl uyum sağlanacağı açıklanmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

InMobi için uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif	¹
Şelale
Formatlar
Banner
Geçişli
Ödül olarak verildi
Yerel biçim	²

¹ Teklif entegrasyonu kapalı beta sürümündedir. Erişim istemek için hesap yöneticinizle iletişime geçin.

² Yalnızca şelale uyumlulaştırması için desteklenir.

Koşullar

Android API düzeyi 21 veya üstü

En son Google Mobile Ads SDK'sı
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

Ad Manager hesabınızda oturum açın.

Şirketlere InMobi Ekle

Teklif

Bu adım, teklif entegrasyonları için gerekli değildir.

Şelale

Yönetici > Şirketler'e gidin ve ardından Tüm şirketler sekmesinde Yeni şirket düğmesini tıklayın. Reklam ağı'nı seçin.

Reklam ağı olarak InMobi'i seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin. Otomatik veri toplama'yı açın ve önceki bölümde belirtilen Username and API Key değerini girin.

Ardından, Kullanıcı adınızı girin ve işiniz bittiğinde Kaydet'i tıklayın.

Güvenli sinyal paylaşımını etkinleştirin

Teklif

Yönetici > Genel ayarlar'a gidin. Ad Exchange hesap ayarları sekmesine gidip Güvenli sinyal paylaşımı'nı inceleyip etkinleştirin. Save'i (Kaydet) tıklayın.

Şelale

Bu adım, şelale entegrasyonları için gerekli değildir.

Teklifli sistemi InMobi yapılandırın

Teklif

Yayınlama > Teklif Verenler'e gidin ve SDK Teklifi sekmesinin altında Yeni teklif veren'i tıklayın.

Teklif veren olarak InMobi simgesini seçin.

Bu teklif verenin sinyal kitaplığını izin verilen sinyaller listesine ekle ve Sinyallerin bu teklif verenle paylaşılmasına izin ver seçeneklerini açık duruma getirin. Ardından Devam'ı tıklayın.

Devam'ı tıklayın.

Done'ı (Bitti) tıklayın.

Şelale

Bu adım, şelale entegrasyonları için gerekli değildir.

Reklam birimi eşlemesini yapılandır

Teklif

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Verme sekmesi altındaInMobi şirketini seçin.

Reklam birimi eşleme sekmesine gidin ve Yeni reklam birimi eşleme'yi tıklayın.

Belirli reklam birimi'ni seçin. Bir reklam birimi ve biçim seçin, Envanter türü olarak Mobil uygulamayı ve Mobil uygulamanızı seçin. Ardından, bir önceki bölümde aldığınızAccount ID and Placement ID kodunu girin. Son olarak Kaydet'i tıklayın.

Şelale

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın. Mobil uygulamanızı seçin.

Aşağı kaydırın ve Getiri iş ortağı ekle'yi tıklayın.

Önceki bölümde InMobi şirket için oluşturduğunuzu seçin. Entegrasyon türü olarak Mobil SDK uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin.

Önceki bölümde belirtilen Account ID and Placement ID değerini ve Varsayılan BGBM değerini girin. Kaydet'i tıklayın.

Not: Otomatik veri toplama özelliğinin bir uyumlulaştırma ağı için Dinamik BGBM değerini doğru şekilde hesaplayabilmesi için verileri toplaması birkaç gün sürer. eBGBM hesaplandığında sizin adınıza otomatik olarak güncellenir.

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

Android Studio entegrasyonu (önerilir)

Uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıklarını ve yapılandırmaları ekleyin. InMobi SDK'sının ve bağdaştırıcısının en yeni sürümlerini kullanın:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:inmobi:10.7.4.0")
}

Manuel entegrasyon

InMobi Android SDK'yı indirin ve libs klasöründeki InMobiSDK.aar dosyasını çıkarıp projenize ekleyin.
Google'ın Maven deposundaki InMobi bağdaştırıcı yapılarına gidin. En son sürümü seçin, InMobi bağdaştırıcısının .aar dosyasını indirin ve projenize ekleyin.
InMobi, başka bağımlılıkların da dahil edilmesini gerektirir. Daha ayrıntılı bilgi için lütfen InMobi'nin belgelerini inceleyin.

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 bağdaştırıcısı, 7.1.0.0 sürümünde InMobiConsent sınıfına InMobiConsentclass that lets you pass consent information to InMobi. The following sample code callsupdateGDPRConsent()`` öğesini ekledi. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı üzerinden reklam isteğinde bulunmadan önce yapmanız önerilir.

Java

import com.inmobi.sdk.InMobiSdk;
import com.google.ads.mediation.inmobi.InMobiConsent;
// ...

JSONObject consentObject = new JSONObject();
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true);
  consentObject.put("gdpr", "1");
} catch (JSONException exception) {
  exception.printStackTrace();
}

InMobiConsent.updateGDPRConsent(consentObject);

Kotlin

import com.inmobi.sdk.InMobiSdk
import com.google.ads.mediation.inmobi.InMobiConsent
// ...

val consentObject = JSONObject()
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true)
  consentObject.put("gdpr", "1")
} catch (exception: JSONException) {
  exception.printStackTrace()
}

InMobiConsent.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ı sayfasını inceleyin.

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.

10.5.7.1, InMobi bağdaştırıcısı, paylaşılan tercihlerden IAB U.S. Privacy dizesini okuma desteği ekledi. Paylaşılan tercihlerde ABD gizlilik dizesini ayarlamak için ABD eyalet gizlilik yasaları belgesindeki talimatları uygulayın.

Ayrıca, InMobi kontrol panelinde CCPA ayarlarının nasıl etkinleştirileceğiyle ilgili yönergeler için InMobi'nin CCPA dokümanlarına göz atın.

5. Adım: Ek kod gerekir

InMobi entegrasyonu için ek kod gerekmez.

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

İ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" />

Ağa özel parametreler

InMobi bağdaştırıcısı, Android Bundle olarak bağdaştırıcıya iletilebilecek ek istek parametrelerini destekler. Adaptör, pakette aşağıdaki anahtarları arar:

İstek parametreleri ve değerler
`InMobiNetworkKeys.AGE_GROUP` Kullanıcının yaş grubu.	`InMobiNetworkValues.BELOW_18` `InMobiNetworkValues.BETWEEN_18_AND_24` `InMobiNetworkValues.BETWEEN_25_AND_29` `InMobiNetworkValues.BETWEEN_30_AND_34` `InMobiNetworkValues.BETWEEN_35_AND_44` `InMobiNetworkValues.BETWEEN_45_AND_54` `InMobiNetworkValues.BETWEEN_55_AND_65` `InMobiNetworkValues.ABOVE_65`
`InMobiNetworkKeys.EDUCATION` Kullanıcının eğitim düzeyi.	`InMobiNetworkValues.EDUCATION_HIGHSCHOOLORLESS` `InMobiNetworkValues.EDUCATION_COLLEGEORGRADUATE` `InMobiNetworkValues.EDUCATION_POSTGRADUATEORABOVE`
`InMobiNetworkKeys.AGE`	Dize. Kullanıcının yaşı
`InMobiNetworkKeys.POSTAL_CODE`	Dize. Kullanıcının posta kodu (genellikle beş haneli bir sayıdır)
`InMobiNetworkKeys.AREA_CODE`	Dize. Kullanıcının alan kodu (telefon numarasının bir kısmı)
`InMobiNetworkKeys.LANGUAGE`	Dize. Kullanıcının ana dili (biliniyorsa).
`InMobiNetworkKeys.CITY`	Dize. Kullanıcının şehri
`InMobiNetworkKeys.STATE`	Dize. Kullanıcının durumu
`InMobiNetworkKeys.COUNTRY`	Dize. Kullanıcının ülkesi
`InMobiNetworkKeys.LOGLEVEL` InMobi SDK'sının Günlük düzeyini ayarlar.	`InMobiNetworkValues.LOGLEVEL_NONE` `InMobiNetworkValues.LOGLEVEL_DEBUG` `InMobiNetworkValues.LOGLEVEL_ERROR`

Aşağıda, bu reklam isteği parametrelerinin nasıl ayarlanacağına ilişkin bir kod örneği verilmiştir:

Java

Bundle extras = new Bundle();
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_54);
extras.putString(InMobiNetworkKeys.AREA_CODE, "12345");

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(InMobiAdapter.class, extras)
   .build();

Kotlin

val extras = Bundle()
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_54)
extras.putString(InMobiNetworkKeys.AREA_CODE, "12345")

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(InMobiAdapter::class.java, extras)
   .build()

Doğal reklamları kullanma

Reklam oluşturma

InMobi bağdaştırıcısı, yerel reklamlarını NativeAd nesneleri olarak döndürür. Aşağıdaki alanları ( NativeAd) doldurur.

Alan	Öğeler her zaman InMobi bağdaştırıcısı tarafından dahil edilir
Başlık
Resim	1
Medya görüntüleme
Metin
Uygulama simgesi
Harekete geçirici mesaj
Yıldız puanı
Depolama
Fiyat

¹ InMobi adaptörü, yerel reklamları için ana resim öğesine doğrudan erişim sağlamaz. Bunun yerine, adaptör MediaView bölümünü bir video veya resimle doldurur.

Gösterim ve tıklama izleme

Google Mobile Ads SDK'sı, gösterim ve tıklama izleme için InMobi SDK'sının geri çağırmalarını kullanır. Bu nedenle, her iki kontrol panelindeki raporlar arasında çok az tutarsızlık olması veya hiç tutarsızlık olması gerekir.

Hata kodları

Bağdaştırıcı InMobi'den reklam alamazsa yayıncılar aşağıdaki sınıflarda ResponseInfo.getAdapterResponses() kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

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:

Hata kodu	Neden
0-99	InMobi SDK Hataları. Daha fazla bilgi için kod bölümüne 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.
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.