Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl uyumlulaştırma kullanarak myTarget Ads'den gelen reklamlar ele alacağız. MyTarget'ın bir reklam biriminin uyumlulaştırma yapılandırması ve myTarget SDK ile bağdaştırıcının Unity uygulamasıdır.
Desteklenen entegrasyonlar ve reklam biçimleri
Entegrasyon | |
---|---|
Teklif verme | |
Şelale | |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü | |
Ödüllü geçiş reklamı |
Şartlar
- Unity 4 veya sonraki sürümler
- En son Google Mobile Ads SDK'sı
- Android'de dağıtmak için
- Android API düzeyi 21 veya üstü
- iOS'te dağıtmak 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. Görüntüleyin Ayrıntılı bilgi için Başlarken.
- Arabuluculuğu tamamlama 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: Kullanıcı arayüzünde myTarget talebini ayarlayın Ad Manager
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Mail.ru ekleyin
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'yı ve bağdaştırıcıyı içe aktarın
myTarget için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin
indirme bağlantısından
Değişiklik günlüğü'nü açın ve
GoogleMobileAdsMyTargetMediation.unitypackage
.
Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar > Özel
Paketleyin ve GoogleMobileAdsMyTargetMediation.unitypackage
dosyasını bulun.
indirildi. 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 > Kuvvet
Çöz'e dokunun. Unity Play Hizmetleri Çözümleyici kitaplığı bağımlılık gerçekleştirir
ve beyan edilen bağımlılıkları
Unity uygulamanızın Assets/Plugins/Android
dizini.
4. Adım: Gizlilik ayarlarını myTarget SDK'sına uygulayın
AB Kullanıcı Rızası ve GDPR
Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.
myTarget 2.1.0 sürümü için Google Mobil Reklamlar uyumlulaştırma eklentisinde,
SetUserConsent()
ve SetUserAgeRestricted()
yöntemleri. Aşağıdaki örnek
kod, kullanıcı izni bilgilerinin myTarget SDK'sına nasıl iletileceğini gösterir. Şu durumda:
bu yöntemi çağırmayı seçerseniz istekte bulunmadan önce bunu yapmanız önerilir.
Google Mobile Ads SDK'sı aracılığıyla reklamlar gösterir.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetUserConsent(true);
Kullanıcının yaş kısıtlaması olan bir kategoride yer aldığı biliniyorsa, kullanıcıları
SetUserAgeRestricted()
yöntemini çağırın.
MyTarget.SetUserAgeRestricted(true);
myTarget'lara göz atın Gizlilik ve GDPR rehberi konulu videomuzu izleyin.
ABD eyalet gizlilik yasaları
ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.
myTarget 3.13.3 sürümü için Google Mobil Reklamlar uyumlulaştırma eklentisinde,
SetCCPAUserConsent(bool)
yöntemini çağırın. Aşağıdaki örnek kod,
myTarget SDK için kullanıcı rızası alma bilgilerini verin. Bu yöntemi çağırmayı seçerseniz
bunu Google Arama Ağı'ndan reklam isteğinde bulunmadan önce
Mobile Ads SDK'sı.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetCCPAUserConsent(true);
Şu hesap için myTarget destek ekibiyle iletişime geçin: daha fazla bilgi edinin.
5. Adım: Gerekli kodu ekleyin
Android
myTarget entegrasyonu için ek koda gerek yoktur.
iOS
SKAdNetwork entegrasyonu
myTarget belgelerindeki talimatları uygulayın.
kullanarak projenizin Info.plist
dosyasına SKAdNetwork tanımlayıcılarını ekleyin.
6. Adım: Uygulamanızı test edin
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 bir reklam alamazsa yayıncılar
kullanarak reklam yanıtından gelen temel hata
ResponseInfo
şu sınıflarda:
Android
com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter
iOS
GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded
myTarget bağdaştırıcısı tarafından gönderilen kodlar ve ona eşlik eden mesajlar Reklam yüklenemedi:
Android
Hata kodu | Neden |
---|---|
100 | myTarget SDK 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 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 Ad Manager 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.18.0
DummyClient
adlı dosyaPlaceholderClient
olarak yeniden adlandırıldı.- myTarget Android bağdaştırıcısının 5.22.1.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.21.6.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.17.1
- myTarget Android bağdaştırıcısının 5.21.1.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.21.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.17.0
- myTarget Android bağdaştırıcısının 5.21.0.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.21.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.16.2
- myTarget Android bağdaştırıcısının 5.20.1.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.21.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.16.1
- myTarget Android bağdaştırıcısının 5.20.1.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.21.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.16.0
- myTarget Android bağdaştırıcısının 5.20.0.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.21.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.15.0
- myTarget Android bağdaştırıcısının 5.20.0.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.20.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.7.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.14.0
- myTarget Android bağdaştırıcısının 5.18.0.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.19.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.5.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.13.2
- myTarget Android bağdaştırıcısının 5.16.5.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.17.5.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 8.3.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.13.1
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/MyTarget/
hedefine 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ının 5.16.4.1 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.17.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.13.0
- myTarget Android bağdaştırıcısının 5.16.4.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.17.4.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.12.0
- myTarget Android bağdaştırıcısının 5.15.5.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.16.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.3.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.11.4
- myTarget Android bağdaştırıcısının 5.15.4.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.15.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.2.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.11.3
MyTarget
sınıfındakiIsConsent()
yöntemiGetUserConsent()
olarak yeniden adlandırıldı.MyTarget
sınıfına aşağıdaki yöntemler eklendi:SetCCPAUserConsent(bool)
GetCCPAUserConsent()
- myTarget Android bağdaştırıcısının 5.15.3.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.15.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.2.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.11.2
- myTarget Android bağdaştırıcısının 5.15.2.1 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.15.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.2 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.11.1
- myTarget Android bağdaştırıcısının 5.15.1.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.15.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.11.0
- myTarget Android bağdaştırıcısının 5.15.0.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.15.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.10.2
- myTarget Android bağdaştırıcısının 5.14.4.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.14.4.0 sürümünü destekler.
Sürüm 3.10.1
- myTarget Android bağdaştırıcısının 5.14.3.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.14.2.0 sürümünü destekler.
Sürüm 3.10.0
- myTarget Android bağdaştırıcısının 5.14.2.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.14.1.0 sürümünü destekler.
Sürüm 3.9.0
- myTarget Android bağdaştırıcısının 5.13.0.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.11.2.0 sürümünü destekler.
Sürüm 3.8.2
- myTarget Android bağdaştırıcısının 5.11.7.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.9.10.0 sürümünü destekler.
Sürüm 3.8.1
- myTarget Android bağdaştırıcısının 5.11.5.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.9.6.0 sürümünü destekler.
Sürüm 3.8.0
- myTarget Android bağdaştırıcısının 5.11.4.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.9.5.0 sürümünü destekler.
Sürüm 3.7.0
- myTarget Android bağdaştırıcısının 5.10.0.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 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ının 5.9.1.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.7.2.0 sürümünü destekler.
Sürüm 3.6.0
- myTarget Android bağdaştırıcısının 5.9.0.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.7.0.0 sürümünü destekler.
Sürüm 3.5.2
- myTarget Android bağdaştırıcısının 5.8.3.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.6.3.0 sürümünü destekler.
Sürüm 3.5.1
- myTarget Android bağdaştırıcısının 5.8.2.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.6.1.0 sürümünü destekler.
Sürüm 3.5.0
- myTarget Android bağdaştırıcısının 5.8.1.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.6.0.0 sürümünü destekler.
Sürüm 3.4.0
- myTarget Android bağdaştırıcısının 5.8.0.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.5.2.0 sürümünü destekler.
Sürüm 3.3.0
- myTarget Android bağdaştırıcısının 5.7.0.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.5.1.0 sürümünü destekler.
Sürüm 3.2.0
- myTarget Android bağdaştırıcısının 5.6.3.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 5.4.9.0 sürümünü destekler.
Sürüm 3.1.0
- myTarget Android bağdaştırıcısının 5.4.6.0 sürümünü destekler.
- myTarget iOS bağdaştırıcısının 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 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.