myTarget'ı uyumlulaştırmayla entegre etme

Bu kılavuzda, şelale entegrasyonlarını kapsayan uyumlulaştırma aracılığıyla myTarget'tan reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bir reklam biriminin uyumlulaştırma yapılandırmasına myTarget ekleme ve myTarget SDK ile bağdaştırıcıyı bir Unity uygulamasına entegre etme konuları 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 sonraki sürümler
  • En son Google Mobile Ads SDK'sı
  • Android'de dağıtım yapmak için
    • Android API düzeyi 21 veya üstü
  • iOS'te dağıtım yapmak için
    • 12.0 veya sonraki bir 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: Kullanıcı arayüzünde myTarget talebini ayarlayın AdMob

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 ekleyin

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'yı ve bağdaştırıcıyı içe aktarın

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

Unity proje düzenleyicinizde Assets > Import Package > CustomPackage'ı (Öğeler > Paketi İçe Aktar > Özel Paket) 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.

Sonra, Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici > Zorla Çöz'ü seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

4. Adım: Gizlilik ayarlarını myTarget SDK'sına uygulayın

Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcıların ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara belirli açıklamaların yapıldığından ve bu kullanıcılardan alınan izinlerin 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 toplayabilecek, alabilecek veya kullanabilecek tüm reklam ağlarını tanımlamalı ve her ağın kullanımı hakkında bilgi sağlamalısınız. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

myTarget 2.1.0 sürümü 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ıtlaması olan bir kategoride yer aldığı biliniyorsa SetUserAgeRestricted() yöntemini de çağırabilirsiniz.

MyTarget.SetUserAgeRestricted(true);

Daha fazla bilgi için myTarget Gizlilik ve GDPR kılavuzuna bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerinin" "satılmasını" (yasaların bu terimlerin tanımladığı şekilde) devre dışı bırakma seçeneği sunmasını gerektirir. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" bağlantısıyla sunulur. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam sunumu için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar. Ancak Google, bu ayarı uyumlulaştırma zincirinizdeki tüm reklam ağlarına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgi satışına katılabilecek her bir reklam ağını belirlemeli ve uygunluğu sağlamak için bu ağların her birinin talimatlarını takip etmelisiniz.

myTarget 3.13.3 sürümü için Google Mobil Reklamlar uyumlulaştırma eklentisi SetCCPAUserConsent(bool) yöntemini 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.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 koda gerek yoktur.

iOS

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için myTarget belgelerindeki adımları uygulayın.

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

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 bir reklam alamazsa yayıncılar aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtında temel alınan 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 gönderilen kodlar ve beraberindeki mesajlar aşağıda verilmiştir:

Android

Hata kodu Neden
100 myTarget SDK 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 doğal 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 kullanılabilir bir reklamı yok.
101 Kullanıcı arayüzünde yapılandırılan myTarget sunucu parametreleri AdMob eksik/geçersiz.
102 myTarget Adapter, istenen reklam biçimini desteklemiyor.
103 Yüklenmemiş bir myTarget reklamı gösterilmeye çalışıldı.
104 İstenen reklam boyutu, myTarget tarafından desteklenen bir banner boyutuyla eşleşmiyor.
105 Gerekli doğal reklam öğeleri eksik.

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

Sürüm 3.17.0

Sürüm 3.16.2

Sürüm 3.16.1

Sürüm 3.16.0

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 bağdaştırıcısı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 bağdaştırıcısı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 bağdaştırıcısı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 bağdaştırıcısı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 bağdaştırıcısı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 bağdaştırıcısı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 bağdaştırıcısı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:
    • MyTarget.SetUserConsent() yöntemini kullanarak kullanıcının izin durumunu MyTarget SDK'sına yönlendirin.
    • MyTarget.SetUserAgeRestricted yöntemi.
    • MyTarget.IsUserConsent() yöntemini kullanarak kullanıcının mevcut izin durumunu öğrenin.
    • MyTarget.IsUserAgeRestricted() yöntemini kullanın.

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 çıkış tarihi!
  • 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.