myTarget'ı uyumlulaştırmayla 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 videoda myTarget öğesinin reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve myTarget SDK ile bağdaştırıcının bir Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Entegrasyon
Teklif
Şelale
Formatlar
Banner
Geçişli
Ödül olarak verildi
Ödüllü Geçiş Reklamı

Koşullar

  • Unity 4 veya üzeri
  • En son Google Mobile Ads SDK'sı
  • Android'de dağıtmak için
    • Android API düzeyi 19 veya üstü
  • iOS'te dağıtmak için
    • 12.0 veya üstü iOS dağıtım hedefi
  • Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Unity projesi. 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: 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.

Uygulamanız hem Android hem de iOS platformlarını destekliyorsa bunların her birini ayrı ayrı kurmanız gerekir.

Android

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

iOS

Ardından uygulamanızın iTunes 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 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 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: AdMob kullanıcı arayüzünde myTarget talebini 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 Mail.ru ekle

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

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

Changelog'daki indirme bağlantısından myTarget için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsMyTargetMediation.unitypackage dosyasını çıkarın.

Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsMyTargetMediation.unitypackage dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

Ardından, Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici > Çözmeye Zorla'yı seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemeyi sıfırdan gerçekleştirecek ve beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalayacaktır.

4. Adım: myTarget SDK'sında gizlilik ayarlarını uygulayın

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.

myTarget sürüm 2.1.0 için Google Mobil Reklamlar uyumlulaştırma eklentisi, SetUserConsent() ve SetUserAgeRestricted() yöntemlerini içerir. Aşağıdaki örnek kod, kullanıcı izni 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.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetUserConsent(true);

Kullanıcının yaş kısıtlamalı bir kategoride olduğu biliniyorsa SetUserAgeRestricted() yöntemini de çağırabilirsiniz.

MyTarget.SetUserAgeRestricted(true);

Daha fazla bilgi 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.

myTarget sürümü 3.13.3 için Google Mobil Reklamlar uyumlulaştırma eklentisinde SetCCPAUserConsent(bool) yöntemi bulunur. Aşağıdaki örnek kod, kullanıcı 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.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetCCPAUserConsent(true);

Daha fazla bilgi için myTarget destek ekibiyle iletişime geçin.

5. Adım: Gerekli kodu ekleyin

Android

myTarget entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için myTarget dokümanlarındaki talimatları uygulayın.

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

Test reklamlarını etkinleştir

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

Hata kodları

Bağdaştırıcı myTarget'tan 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.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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:

Android

Hata kodu Neden
100 myTarget SDK bir hata döndürdü.
101 Kullanıcı arayüzünde yapılandırılan myTarget sunucu parametreleri AdMob 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.

iOS

Hata kodu Neden
100 myTarget SDK'sının henüz bir reklamı yok.
101 Kullanıcı arayüzünde yapılandırılan myTarget sunucu parametreleri AdMob 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.

myTarget Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

Sürüm 3.15.0

Sürüm 3.14.0

Sürüm 3.13.2

Sürüm 3.13.1

Sürüm 3.13.0

Sürüm 3.12.0

Sürüm 3.11.4

Sürüm 3.11.3

Sürüm 3.11.2

Sürüm 3.11.1

Sürüm 3.11.0

Sürüm 3.10.2

Sürüm 3.10.1

Sürüm 3.10.0

Sürüm 3.9.0

Sürüm 3.8.2

Sürüm 3.8.1

Sürüm 3.8.0

Sürüm 3.7.0

Sürüm 3.6.1

Sürüm 3.6.0

Sürüm 3.5.2

Sürüm 3.5.1

Sürüm 3.5.0

Sürüm 3.4.0

Sürüm 3.3.0

Sürüm 3.2.0

Sürüm 3.1.0

Sürüm 3.0.0

  • Eklenti, yeni açık beta Ödüllü API'yi destekleyecek şekilde güncellendi.
  • myTarget Android adaptörünün 5.3.9.0 sürümünü destekler.
  • myTarget iOS bağdaştırıcısının 5.0.4.0 sürümünü destekler.

Sürüm 2.3.2

  • myTarget Android adaptörünün 5.2.5.0 sürümünü destekler.
  • myTarget iOS bağdaştırıcısının 4.8.9.0 sürümünü destekler.

Sürüm 2.3.1

  • myTarget Android adaptörünün 5.2.5.0 sürümünü destekler.
  • myTarget iOS bağdaştırıcısının 4.8.5.0 sürümünü destekler.

Sürüm 2.3.0

  • myTarget Android adaptörünün 5.2.2.0 sürümünü destekler.
  • myTarget iOS bağdaştırıcısının 4.8.0.0 sürümünü destekler.

Sürüm 2.2.0

  • myTarget Android adaptörünün 5.1.4.0 sürümünü destekler.
  • myTarget iOS bağdaştırıcısının 4.8.0.0 sürümünü destekler.

Sürüm 2.1.2

  • myTarget Android adaptörünün 5.1.3.0 sürümünü destekler.
  • myTarget iOS bağdaştırıcısının 4.7.11.0 sürümünü destekler.

Sürüm 2.1.1

  • myTarget Android adaptörünün 5.1.1.0 sürümünü destekler.
  • myTarget iOS bağdaştırıcısının 4.7.10.0 sürümünü destekler.

Sürüm 2.1.0

  • myTarget Android SDK'sının 5.1.0 sürümünü destekler.
  • myTarget iOS SDK'sının 4.7.9 sürümünü destekler.
  • Aşağıdaki yöntemler eklendi:
    • Kullanıcının izin durumunu MyTarget SDK'sına yönlendirmek için MyTarget.SetUserConsent() yöntemini kullanabilirsiniz.
    • Kullanıcının yaş kısıtlamalı bir kategoride (ör. 16 yaşından küçük) olduğunun bilindiğini belirtmek için bir işaret ayarlayan MyTarget.SetUserAgeRestricted yöntemi.
    • Kullanıcının mevcut izin durumunu öğrenmek için MyTarget.IsUserConsent() yöntemini kullanın.
    • Kullanıcının yaş kısıtlamalı bir kategoride (ör. 16 yaşından küçük) olduğunu belirten işareti almak için MyTarget.IsUserAgeRestricted() yöntemini kullanabilir.

Sürüm 2.0.1

  • myTarget Android SDK'sının 5.0.2 sürümünü destekler.
  • myTarget iOS SDK'sının 4.7.8 sürümünü destekler.

Sürüm 2.0.0

  • myTarget Android SDK'sının 5.0.0 sürümünü destekler.
  • myTarget iOS SDK'sının 4.7.7 sürümünü destekler.

Sürüm 1.1.0

  • myTarget Android SDK'sının 4.7.2 sürümünü destekler.
  • myTarget iOS SDK'sının 4.7.6 sürümünü destekler.

Sürüm 1.0.0

  • İlk sürüm!
  • myTarget Android SDK'sının 4.6.27 sürümünü destekler.
  • myTarget iOS SDK'sının 4.6.24 sürümünü destekler.