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ğini ve InMobi SDK ile bağdaştırıcının bir uygulamaya nasıl Flutter entegre edileceğini ele alıyor.

Desteklenen entegrasyonlar ve reklam biçimleri

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

¹ Teklifli sistem entegrasyonu kapalı beta sürümündedir. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.

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

Koşullar

• En yeni Google Mobile Ads SDK'sı
• Flutter 3.7.0 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 üzeri iOS dağıtım hedefi
• Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Flutter 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.

Not: Sistem sizi yerleşim oluşturma iş akışına yönlendirmezse Envanter > Envanter Ayarları'na gidin. Ardından, yerleşim oluşturmak istediğiniz uygulamayı veya web sitesini arayın. Yerleşim ekle'yi tıklayın.

Teklif

Not: InMobi kontrol panelinde teklifli sistemi yapılandırma erişimi için hesap yöneticinizle iletişime geçin.

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.

Not: InMobi Yerleşim Kimliği, yerleşim adının altında bulunur.

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.

Not: Test modu tüm yerleşimler için varsayılan olarak Kapalı durumdadır. Ancak test modu, tüm uygulama örneklerindeki yerleşimler veya yalnızca belirttiğiniz cihazlar için etkinleştirilebilir.

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

Önemli: AB Rıza ve GDPR, CPRA ve Kullanıcı Mesajlaşma Platformu yapılandırmasını tamamlamak için Hesap Yönetimi izniniz olduğunu doğrulayın. Ayrıntılar için Hesabınıza kullanıcı erişimini yönetme sayfasına göz atın.

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

Not: Uyumlu InMobi ve Google Mobile Ads SDK'sı sürümlerinin entegre edilmemesi, derleme sorunlarına yol açabilir.

pub.dev üzerinden entegrasyon

Aşağıdaki bağımlılığı paketinizin pubspec.yaml dosyasınaInMobi SDK ve bağdaştırıcının en son sürümleriyle ekleyin:

dependencies:
  gma_mediation_inmobi: ^1.0.0

Manuel Entegrasyon

InMobi için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü (ve içeriğini) Flutter projenize ekleyin. Ardından, aşağıdaki bağımlılığı ekleyerek pubspec.yaml dosyanızdaki eklentiye başvurun:

dependencies:
  gma_mediation_inmobi:
    path: path/to/local/package

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 için Google Mobile Ads uyumlulaştırma eklentisi, izin bilgilerinin InMobi SDK'sına iletilmesini desteklemez.

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 için Google Mobile Ads uyumlulaştırma eklentisi, izin bilgilerinin InMobi SDK'sına iletilmesini desteklemez.

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.

Önemli: Uygulamanızı yayınlamadan önce AdMob ve InMobi için test modunu devre dışı bırakın.

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 Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü

1.0.0

• İlk sürüm.
• InMobi Android adaptörü sürüm 10.6.7.1 ile doğrulanmış uyumluluk.
• InMobi iOS bağdaştırıcısı sürüm 10.7.2.0 ile doğrulanmış uyumluluk.
• Google Mobile Ads Flutter Eklentisi sürüm 5.1.0 ile geliştirildi ve test edilmiştir.