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

MyTarget politikasını Uyumlulaştırma ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını ele alan uyumlulaştırma özelliğini kullanarak myTarget öğesinden reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu bölümde myTarget öğesinin reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve myTarget SDK ile bağdaştırıcısı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ı Ad Manager 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 üstü

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

1. Adım: myTarget kullanıcı arayüzünde yapılandırmaları ayarlayın

İ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.

Uygulama eklerken, myTarget, işlemi tamamlamadan önce bir 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

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çimleri arasından ÖDÜLLÜ VİDEO'yu seçip REKLAM BİRİMİ EKLE düğmesini tıklayın.

Yerel biçim

Kullanılabilir reklam biçimlerinden YEREL'i seçin ve 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 bir sonraki bölümde Ad Manager 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 olacaktı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'u veya Jetonu Göster'i tıklayın.

Test modunu aç

myTarget kullanıcı arayüzüne bir test cihazı eklemek ve yapılandırmak için myTarget belgelerindeki talimatları uygulayın.

2. Adım: Ad Manager kullanıcı arayüzünde myTarget talebini ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

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

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın.

Getiri grubunuz için benzersiz bir Ad girin, Durum'u Etkin olarak ayarlayın, Reklam Biçimi'ni seçin ve Envanter türü'nü Mobil Uygulama olarak ayarlayın. Hedefleme > Envanter bölümünün altında Envanter ve Mobil uygulama altında uyumlulaştırma eklemek istediğiniz reklam birimini seçin.

Ardından, Getiri iş ortağı ekle düğmesini tıklayın.

myTargetiçin zaten bir Getiri iş ortağınız varsa bunu seçebilirsiniz. Aksi takdirde, Yeni bir getiri iş ortağı oluştur'u seçin.

Reklam ağı olarak myTarget'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 Permanent Access Token değerini girin.

Getiri iş ortağı seçildikten sonra Entegrasyon türü olarak Mobil SDK Uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin. Bir önceki bölümde verilenSlot ID kodunu girin. Ardından, Varsayılan BGBM değerini girin.

İşiniz bittiğinde sayfanın alt kısmındaki Kaydet'i tıklayın.

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Mail.ru ekle

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 Mail.ru ekleyin.

3. Adım: myTarget SDK'sını ve bağdaştırıcıyı 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. myTarget SDK ve bağdaştırıcının en son sürümlerini kullanın:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:mytarget:5.20.0.0")
}

Manuel entegrasyon

myTarget SDK'sını dahil etmek için myTarget Android SDK belgelerini inceleyin.
Google'ın Maven deposunda myTarget adaptör 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: myTarget 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.

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 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'ya 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.

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.

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 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ğlanabilen değerler için myTarget destek ekibiyle iletişime geçin.

5. Adım: Gerekli kodu ekleyin

myTarget entegrasyonu için ek kod gerekmez.

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

Test reklamlarını etkinleştir

Ad Manager için test cihazınızı kaydettiğinizden ve myTarget kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.

Test reklamlarını doğrulama

myTargetreklam kaynağından test reklamları aldığınızı doğrulamak için myTarget (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Yerel reklamları kullanma

Reklam oluşturma

myTarget bağdaştırıcısı, yerel reklamlarını NativeAd nesne olarak döndürür. Bir NativeAd için alanlarını doldurur.

Alan	myTarget bağdaştırıcısı 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ı, bu sorunu daha sonraki bir sürümde çö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 fark olması veya hiç tutarsızlık olmaması gerekir.

Hata kodları

Bağdaştırıcı myTarget öğesinden reklam alamazsa aşağıdaki sınıfların altında 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 bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajları burada görebilirsiniz:

Hata kodu	Neden
100	myTarget SDK bir hata döndürdü.
101	Kullanıcı arayüzünde yapılandırılan myTarget sunucu parametreleri Ad Manager eksik/geçersiz.
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 öğesinden yüklenen yerel reklamda gerekli bazı öğeler (ör. resim veya simge) eksik.
100	myTarget SDK'sının henüz bir reklamı yok.
101	Kullanıcı arayüzünde yapılandırılan myTarget sunucu parametreleri Ad Manager eksik/geçersiz.
102	myTarget Bağdaştırıcısı istenen reklam biçimini desteklemiyor.
103	Yüklenmemiş 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.