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.
Banner
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
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
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
AB İzni 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.
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
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.
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 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. |
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 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. |
myTarget Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü
Sürüm 3.15.0
- myTarget Android bağdaştırıcı sürüm 5.20.0.0'ı destekler.
- myTarget iOS bağdaştırıcı sürüm 5.20.1.0'ı destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.7.0 ile geliştirilip test edilmiştir.
Sürüm 3.14.0
- myTarget Android bağdaştırıcı sürüm 5.18.0.0'ı destekler.
- myTarget iOS bağdaştırıcı sürüm 5.19.0.0'ı destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.5.0 ile geliştirilip test edilmiştir.
Sürüm 3.13.2
- myTarget Android bağdaştırıcı sürüm 5.16.5.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.17.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.3.0 ile geliştirilip test edilmiştir.
Sürüm 3.13.1
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/MyTarget/
klasörüne taşındı. - Bağdaştırıcı ad alanı,
GoogleMobileAds.Mediation.MyTarget
kullanılacak şekilde yeniden düzenlendi. - myTarget Android bağdaştırıcı sürüm 5.16.4.1'i destekler.
- myTarget iOS bağdaştırıcısı 5.17.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.1.0 ile geliştirilip test edilmiştir.
Sürüm 3.13.0
- myTarget Android bağdaştırıcı sürüm 5.16.4.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.17.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 8.0.0 ile geliştirilip test edilmiştir.
Sürüm 3.12.0
- myTarget Android bağdaştırıcı sürüm 5.15.5.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.16.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.3.0 ile geliştirilip test edilmiştir.
Sürüm 3.11.4
- myTarget Android bağdaştırıcı sürüm 5.15.4.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.15.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.2.0 ile geliştirilip test edilmiştir.
Sürüm 3.11.3
MyTarget
sınıfındakiIsConsent()
yöntemiGetUserConsent()
olarak yeniden adlandırıldı.- Aşağıdaki yöntemler
MyTarget
sınıfına eklendi:SetCCPAUserConsent(bool)
GetCCPAUserConsent()
- myTarget Android bağdaştırıcı sürüm 5.15.3.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.15.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.2.0 ile geliştirilip test edilmiştir.
Sürüm 3.11.2
- myTarget Android bağdaştırıcı sürüm 5.15.2.1'i destekler.
- myTarget iOS bağdaştırıcısı 5.15.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.2 ile geliştirilip test edilmiştir.
Sürüm 3.11.1
- myTarget Android bağdaştırıcı sürüm 5.15.1.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.15.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.0 ile geliştirilip test edilmiştir.
Sürüm 3.11.0
- myTarget Android bağdaştırıcı sürüm 5.15.0.0'ı destekler.
- myTarget iOS bağdaştırıcı sürüm 5.15.0.1'i destekler.
- Google Mobil Reklamlar Unity Eklentisi sürüm 7.0.0 ile geliştirilip test edilmiştir.
Sürüm 3.10.2
- myTarget Android bağdaştırıcı sürüm 5.14.4.0'ı destekler.
- myTarget iOS bağdaştırıcı sürüm 5.14.4.0'ı destekler.
Sürüm 3.10.1
- myTarget Android bağdaştırıcı sürüm 5.14.3.0'ı destekler.
- myTarget iOS bağdaştırıcı sürüm 5.14.2.0'ı destekler.
Sürüm 3.10.0
- myTarget Android bağdaştırıcı sürüm 5.14.2.0'ı destekler.
- myTarget iOS bağdaştırıcı sürüm 5.14.1.0'ı destekler.
Sürüm 3.9.0
- myTarget Android bağdaştırıcı sürüm 5.13.0.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.11.2.0 sürümünü destekler.
Sürüm 3.8.2
- myTarget Android bağdaştırıcı sürüm 5.11.7.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.9.10.0 sürümünü destekler.
Sürüm 3.8.1
- myTarget Android bağdaştırıcı sürüm 5.11.5.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.9.6.0 sürümünü destekler.
Sürüm 3.8.0
- myTarget Android bağdaştırıcı sürüm 5.11.4.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.9.5.0 sürümünü destekler.
Sürüm 3.7.0
- myTarget Android bağdaştırıcı sürüm 5.10.0.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.7.5.0 sürümünü destekler.
Sürüm 3.6.1
MyTarget.IsUserConsent()
yöntemiMyTarget.IsConsent()
olarak yeniden adlandırıldı.- myTarget Android bağdaştırıcı sürüm 5.9.1.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.7.2.0 sürümünü destekler.
Sürüm 3.6.0
- myTarget Android bağdaştırıcı sürüm 5.9.0.0'ı destekler.
- myTarget iOS bağdaştırıcı sürüm 5.7.0.0'ı destekler.
Sürüm 3.5.2
- myTarget Android bağdaştırıcı sürüm 5.8.3.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.6.3.0 sürümünü destekler.
Sürüm 3.5.1
- myTarget Android bağdaştırıcı sürüm 5.8.2.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.6.1.0 sürümünü destekler.
Sürüm 3.5.0
- myTarget Android bağdaştırıcı sürüm 5.8.1.0'ı destekler.
- myTarget iOS bağdaştırıcı sürüm 5.6.0.0'ı destekler.
Sürüm 3.4.0
- myTarget Android bağdaştırıcı sürüm 5.8.0.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.5.2.0 sürümünü destekler.
Sürüm 3.3.0
- myTarget Android bağdaştırıcı sürüm 5.7.0.0'ı destekler.
- myTarget iOS bağdaştırıcı sürüm 5.5.1.0'ı destekler.
Sürüm 3.2.0
- myTarget Android bağdaştırıcı sürüm 5.6.3.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.4.9.0 sürümünü destekler.
Sürüm 3.1.0
- myTarget Android bağdaştırıcı sürüm 5.4.6.0'ı destekler.
- myTarget iOS bağdaştırıcısı 5.3.3.0 sürümünü destekler.
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.
- Kullanıcının izin durumunu MyTarget SDK'sına yönlendirmek için
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.