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

myTarget'ı Uyumlulaştırma ile entegre etme

Bu kılavuzda, uyumlulaştırma ile şelale entegrasyonlarını kapsayan myTarget hedefinden 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, myTarget öğesinin bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve myTarget SDK'sı ile bağdaştırıcının bir uygulamaya nasıl entegre edileceği Android ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

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

Koşullar

Android API düzeyi 19 veya sonraki sürümler

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlayın Başlangıç kılavuzunu

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

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

Ardından, uygulamanızın Google Play URL'sini sağlayın.

MyTarget, uygulama eklerken işlemi tamamlamadan önce bir reklam birimi oluşturmanızı gerektirir.

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

Geçişli

Kullanılabilir reklam biçimleri arasından Geçiş reklamı'nı seçin ve ardından REKLAM BİRİMİ EKLE düğmesini tıklayın.

Ödül olarak verildi

Kullanılabilir reklam biçimlerinden ÖDÜLLÜ VİDEO'yu seçin ve ardından REKLAM BİRİMİ EKLE düğmesini tıklayın.

Yerel biçim

Kullanılabilir reklam biçimlerinden YEREL'i seçin, ardından REKLAM BİRİMİ EKLE'yi tıklayın.

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

AdMob reklam birimi kimliğinizi oluşturmak için slot_id alanına ek olarak myTarget Kalıcı Erişim Jetonunuza da ihtiyacınız vardır. Profil sekmesine gidin ve Erişim Jetonları'nı seçin. myTarget Kalıcı Erişim Jetonunuzu görüntülemek için Jeton Oluştur veya Jeton Göster'i tıklayın.

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

myTarget öğesini reklam biriminizin uyumlulaştırma yapılandırmasına eklemeniz gerekir. Önce AdMob hesabınızda oturum açın.

Daha sonra Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa düzenlemek için uyumlulaştırma grubunun adını tıklayın ve myTarget'ı reklam kaynağı olarak ekleyin 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 Platformunuzu 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 birimlerinizin biri veya daha fazlasıyla ilişkilendirin. Ardından, Bitti'yi tıklayın.

Bu noktada reklam birimleri kartının, aşağıda gösterildiği gibi seçtiğiniz reklam birimleriyle doldurulduğunu görmeniz gerekir:

myTarget öğesini reklam kaynağı olarak ekleme

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

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

myTarget için zaten bir eşlemeniz varsa bunu seçmeniz yeterlidir. Aksi takdirde Eşleme ekle'yi tıklayın.

Ardından, önceki bölümde elde edilen Eşleme adı ve Slot Kimliği'ni girin. Ardından Bitti'yi tıklayı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 ve bağdaştırıcının en son sürümleriyle ekleyin:

repositories {
    google()
    mavenCentral()
}

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

Manuel entegrasyon

myTarget SDK'sını eklemek için myTarget Android SDK belgelerini inceleyin.
Google'ın Maven deposunda myTarget bağdaştırıcı yapıları'na gidin. En son sürümü seçin, myTarget bağdaştırıcısının .aar dosyasını indirin ve projenize ekleyin.

4. Adım: Ek kod gerekli

myTarget entegrasyonu için ek kod gerekmez.

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

Test sırasında myTarget, reklam isteğinde bulunmak için açık kaynak örnek uygulamasındaki alan kimliklerinin kullanılmasını önerir. Bunlar, test amacıylaAdMob reklam birimleriniz için alan kimliği olarak girilebilir ve ardından uygulamanız üretime hazır olduğunda gerçek bir slot kimliği ile değiştirilebilir.

İ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 yapıldığından ve bu kullanıcılardan izin 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 toplayabilen, alabilen veya kullanabilen ve her 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.

SDK sürümünde 5.1.0, myTarget, gizlilik şartlarını desteklemek için bir kullanıcı izin API'si ekledi. Aşağıdaki örnek kod, bu izin bilgilerinin myTarget SDK'sına nasıl iletileceğini gösterir. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce 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ıtlamalı 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ğlanabilen değerler için myTarget'ın Gizlilik ve GDPR kılavuzuna bakın.

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

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

CCPA

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) "satma" hakkının verilmesini gerektirir. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde gösterilen "Kişisel Bilgilerimi Kesinlikle Satmayın" bağlantısıyla sunulur. ABD eyalet gizlilik yasaları uygunluk rehberi, Google reklam sunma için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar ancak Google bu ayarı uyumlulaştırma zincirinizdeki her bir reklam ağına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgi satışına dahil olabilecek her reklam ağını belirlemeniz ve uygunluğu sağlamak için bu ağların her birinden gelen yönergeleri izlemeniz gerekir.

SDK sürümü 5.9.0, myTarget, gizlilik şartlarını desteklemek için bir kullanıcı rızası API'si ekledi. Aşağıdaki örnek kod, bu izin bilgilerinin myTarget SDK'sına nasıl iletileceğini gösterir. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce 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 bağdaştırıcısı yerel reklamlarını NativeAd nesne olarak döndürür. Bu işlem, NativeAd için aşağıdaki yerel reklamlar alanı açıklamalarını doldurur.

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ızlı değerlendirme	Garanti edilmeyen
Depolama	Garanti edilmeyen
Fiyat	Garanti edilmeyen
Logo	Garanti edilmeyen
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 bağdaştırıcısı, getAspectRatio() için her zaman 0 değerini döndürür. myTarget SDK'sı daha sonraki bir sürümde bu sorunu çözecektir.

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 arasında çok az tutarsızlık veya hiç tutarsızlık olmamalıdır.

Hata kodları

Bağdaştırıcı myTarget hedefinden reklam alamazsa aşağıdaki sınıfların altında yer alan ResponseInfo.getAdapterResponse() kodunu 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

Aşağıda, bir reklam yüklenemediğinde myTarget bağdaştırıcısı tarafından gönderilen kodlar ve ilgili mesajlar verilmiştir:

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

myTarget Android Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü