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

MyTarget öğesini Uyumlulaştırma ile entegre etme

Bu kılavuzda, uyumlulaştırma kullanarak şelale entegrasyonlarını kapsayan reklamları hedeflemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. myTarget'ın bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve myTarget SDK'sının ve bağdaştırıcısının bir Android uygulamaya nasıl entegre edileceğini açıklar.

Desteklenen entegrasyonlar ve reklam biçimleri

myTarget için AdMob uyumlulaştırma adaptörü aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif
Şelale
Biçimler
Banner
Geçişli
Ödül olarak verildi
Yerel biçim

Koşullar

Android API düzeyi 19 veya üstü

En son Google Mobile Ads SDK'sı

1. Adım: myTarget ağını kurun

İlk olarak myTarget hesabınıza kaydolun veya giriş yapın. Başlıkta UYGULAMALAR'ı tıklayarak Uygulamalar sayfasına gidin. UYGULAMA EKLE'yi tıklayarak uygulamanızı ekleyin.

Ardından uygulamanızın Google Play URL'sini girin.

Bir uygulama eklerken myTarget, işlemi tamamlayabilmek için reklam birimi oluşturmanızı gerektirir.

Kullanılabilir reklam biçimlerinden BANNER'ı seçin ve ardından REKLAM BİRİMİ EKLE düğmesini tıklayın.

Geçişli

Mevcut reklam biçimlerinden geçiş reklamı'nı seçin, ardından REKLAM BİRİMİ EKLE düğmesini tıklayın.

Ödül olarak verildi

Mevcut reklam biçimlerinden ÖDÜLLÜ VİDEO'yu seçip REKLAM BİRİMİ EKLE düğmesini tıklayın.

Yerel biçim

Mevcut reklam biçimlerinden DOĞA'yı seçin, ardından REKLAM BİRİMİ EKLE'yi tıklayın.

Reklam biriminizin ayrıntılar sayfasına, reklam birimi ayarları altında slot_id olarak belirtilen alan kimliğinizi not edin. Bu alan kimliği, sonraki bölümde AdMob reklam biriminizi ayarlamak için kullanılır.

AdMob reklam birimi kimliğinizi ayarlamak için slot_id'nin yanı sıra myTarget Kalıcı Erişim Jetonunuz da gerekir. Profile (Profil) sekmesine gidin ve Access Tokens (Erişim Jetonları) seçeneğini belirleyin. myTarget Kalıcı Erişim Jetonunuzu görüntülemek için Jeton Oluştur veya Jetonu Göster'i tıklayın.

2. Adım: AdMob Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırın

myTarget'ı reklam biriminizin uyumlulaştırma yapılandırmasına eklemeniz gerekir. İlk olarak AdMob hesabınızda oturum açın.

Ardından Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa düzenlemek için bu uyumlulaştırma grubunun adını tıklayın ve MyTarget'ı reklam kaynağı olarak ekleme adımına geçin.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma grubu oluştur'u seçin.

Reklam Biçimi ve Platform girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın ve Reklam Birimleri Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut AdMob reklam birimlerinizden bir veya daha fazlasıyla ilişkilendirin. Ardından, Bitti'yi tıklayın.

Reklam birimleri kartını aşağıda gösterildiği gibi, seçtiğiniz reklam birimleriyle doldurduğunuzu göreceksiniz.

myTarget'ı reklam kaynağı olarak ekleyin

Reklam Kaynakları kartında Reklam Ağı Ekle'yi seçin.

Reklam ağı olarak myTarget'ı seçin, Optimize et anahtarını etkinleştirin, önceki bölümde elde edilen Kalıcı Erişim Jetonu'nu girin ve myTarget için reklam kaynağı optimizasyonunu ayarlamak üzere myTarget için bir eBGBM değeri girin. Ardından Devam'ı tıklayın.

Önceki bölümde elde edilen slot kimliğini girin ve Bitti'yi tıklayın.

Ödüllü reklamlar

Ödüllü reklam biriminizin ayarlarında ödül tutarı ve ödül türü için değerler sağlayın. Ardından, hangi reklam ağının sunulacağıyla ilgili olarak kullanıcıya aynı ödülü verdiğinizden emin olmak için Uyumlulaştırma gruplarındaki tüm ağlara uygulayın kutusunu işaretleyin.

Bu ayarı uygulamazsanız myTarget adaptörü varsayılan olarak "" değerinde (boş dize) 1 değerine sahip bir ödül alır.

AdMob reklam birimlerinin ödül değerlerini ayarlama hakkında daha fazla bilgi için Reklam birimi oluşturma bölümüne bakın.

3. Adım: myTarget SDK'sını ve bağdaştırıcıyı içe aktarın

Android Studio entegrasyonu (önerilir)

Aşağıdaki uygulama bağımlılıklarını, uygulama düzeyindeki build.gradle dosyasına myTarget SDK'sının ve bağdaştırıcısının en son sürümleriyle ekleyin:

repositories {
    google()
    mavenCentral()
}

// ...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:21.4.0'
    implementation 'com.google.ads.mediation:mytarget:5.16.3.0'
}
// ...

Manuel entegrasyon

myTarget SDK'sını dahil etmek için myTarget Android SDK dokümanlarına bakın.
Google'ın Maven deposundaki myTarget adaptör yapılarına gidin. En son sürümü seçin, myTarget adaptörünün .aar dosyasını indirin ve projenize ekleyin.

4. Adım: Ek kod gerekir

myTarget entegrasyonu için ek kod gerekmez.

5. Adım: Uygulamanızı test edin

Test sırasında myTarget, reklam isteğinde bulunmak için açık kaynak örnek uygulamasından alan kimliklerini kullanmanızı önerir. Bunlar, test amacıylaAdMob reklam birimleriniz için yuva kimliği olarak girilebilir ve ardından uygulamanız üretime hazır olduğunda gerçek bir alan kimliğiyle değiştirilir.

İsteğe bağlı adımlar

AB kullanıcı rızası 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ın verildiğinden ve kullanıcılardan izin verildiğinden emin olmanız gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) kapsamındaki gereksinimleri yansıtmaktadır. Rıza isterken, uyumlulaştırma zincirinizde kişisel verileri toplayabilecek, alabilecek veya kullanabilecek tüm reklam ağlarını belirtmeniz ve her bir ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

SDK sürümünde 5.1.0, myTarget, gizlilik şartlarını desteklemek için bir kullanıcı rızası API'si ekledi. Aşağıdaki örnek kodda, bu izin bilgilerinin myTarget SDK'sına nasıl iletileceği gösterilmektedir. Bu yöntemi çağırmayı seçerseniz Google Mobile Ads SDK'sı üzerinden reklam isteğinde bulunmadan önce bunu yapmanız önerilir.

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserConsent(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserConsent(true)

Ayrıca, kullanıcının yaş kısıtlaması olan bir kategoride olduğu biliniyorsa bu izin bilgilerini myTarget SDK'sına iletmek için aşağıdaki kodu kullanabilirsiniz.

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserAgeRestricted(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserAgeRestricted(true)

Daha fazla bilgi ve yöntemde sağlanabilecek değerler için myTarget'ın Gizlilik ve GDPR kılavuzuna bakın.

Mail.ru'yu GDPR reklam iş ortakları listesine ekleyin

GDPR ayarları bölümündeki adımları uygulayarak Mail.ru'yu AdMob kullanıcı arayüzündeki GDPR reklam iş ortakları listesine ekleyin.

CCPA

Kaliforniya Tüketici Gizliliği Yasası (CCPA) Kaliforniya eyaletinde ikamet eden kullanıcılara "kişisel bilgilerinin" "satılması" (yasaların bu terimleri tanımlandığı şekilde) için kapsam dışında kalmayı seçme hakkı CCPA hazırlığı kılavuzu, Google reklam yayını için kısıtlanmış veri işlemeyi etkinleştirme olanağı sağlar ancak Google bu ayarı uyumlulaştırma zincirinizdeki her reklam ağına uygulayamaz. Bu nedenle, kişisel bilgilerinizin satışında yer alabilecek tüm reklam ağlarını uyumlulaştırma zincirinizde tanımlamanız ve CCPA ile uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

SDK sürümünde 5.9.0, myTarget, gizlilik şartlarını desteklemek için bir kullanıcı rızası API'si ekledi. Aşağıdaki örnek kodda, bu izin bilgilerinin myTarget SDK'sına nasıl iletileceği gösterilmektedir. Bu yöntemi çağırmayı seçerseniz Google Mobile Ads SDK'sı üzerinden reklam isteğinde bulunmadan önce bunu yapmanız önerilir.

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setCcpaUserConsent(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setCcpaUserConsent(true)

Daha fazla bilgi ve yöntemde sağlanabilecek değerler için myTarget destek ekibiyle iletişime geçin.

Yerel reklamları kullanma

Reklam oluşturma

myTarget adaptörü, yerel reklamlarını NativeAd nesne olarak döndürür. Aşağıdaki yerel reklam alanı açıklamalarını doldurur: NativeAd.

Alan	myTarget adaptörü tarafından doldurulur
Başlık	Her zaman
Resim	Her zaman
Metin	Her zaman
Uygulama simgesi	Her zaman
Harekete geçirici mesaj	Her zaman
Yıldız puanı	Garantili değil
Depolama	Garantili değil
Fiyat	Garantili değil
Logo	Garantili değil
Reklamveren	Her zaman

myTarget SDK'sı mediaView genişlik ve yükseklik için her zaman 0 değerini döndürür. Bu nedenle myTarget adaptörü getAspectRatio() için her zaman 0 değerini döndürür. myTarget SDK'sı bu sorunu daha sonraki bir sürümde düzeltecektir.

Gösterim ve tıklama izleme

Google Mobile Ads SDK'sı, gösterim ve tıklama izleme için myTarget SDK'sının geri çağırmalarını kullanır. Bu nedenle, her iki kaynaktan alınan raporlar az sayıda tutarsızlıkla veya hiç tutarsızlık olmadan eşleşmelidir.

Hata kodları

Bağdaştırıcı myTarget'tan reklam alamazsa aşağıdaki sınıflardan ResponseInfo.getAdapterResponse() kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

Bir reklam yüklenemediğinde myTarget adaptörünün attığı kodlar ve ilgili mesajlar aşağıda verilmiştir:

Hata kodu	Neden
100	myTarget SDK'sı bir hata döndürdü.
101	AdMob kullanıcı arayüzünde yapılandırılan myTarget sunucu parametreleri eksik/geçersiz.
102	İstenen reklam boyutu, myTarget tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103	Reklam isteği, birleştirilmiş bir yerel reklam isteği değil.
104	myTarget'tan yüklenen yerel reklam, istenen yerel reklamdan farklı.
105	myTarget'tan yüklenen yerel reklamda bazı gerekli öğeler (ör. resim veya simge) eksik.
100	myTarget SDK'da henüz kullanılabilir reklam yok.
101	AdMob kullanıcı arayüzünde yapılandırılan myTarget sunucu parametreleri eksik/geçersiz.
102	myTarget adaptör istenen reklam biçimini desteklemiyor.
103	Yüklenen bir myTarget reklamı göstermeye çalıştım.
104	İstenen reklam boyutu, myTarget tarafından desteklenen bir banner boyutuyla eşleşmiyor.
105	Gerekli yerel reklam öğeleri eksik.