Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl Liftoff Monetize'daki reklamları kullanarak uyumlulaştırma özellikleri şelale entegrasyonları. Bu, Liftoff Monetize'ın bir reklam biriminin ve Vungle SDK ile bağdaştırıcısının bir kampanyaya nasıl entegre edileceği Unity uygulamasını kullanın.
Desteklenen entegrasyonlar ve reklam biçimleri
Entegrasyon | |
---|---|
Teklif verme | |
Şelale | |
Formatlar | |
Uygulama Açma | 1, 3 |
Banner | 2 |
Geçiş reklamı | |
Ödüllü | |
Ödüllü geçiş reklamı | 2 |
1 Teklifli sistem bu biçim için entegrasyonu kapalı beta sürümündedir.
2 Teklifli sistem bu biçim için entegrasyonu açık beta sürümündedir.
Bu biçim için 3 şelale entegrasyonu kapalı beta sürümündedir.
Şartlar
- En son Google Mobile Ads SDK'sı
- Unity 4 veya üzeri
- (Teklifli sistem için): Liftoff Monetize için Google Mobile Ads uyumlulaştırma eklentisi 3.8.2 veya sonraki sürümler (en son sürüm önerilir)
- 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ış Unity çalışan bir proje. Görüntüleyin Ayrıntılı bilgi için Başlarken.
- Arabuluculuğu tamamlama Başlangıç kılavuzu
1. adım: Liftoff Monetize kullanıcı arayüzünde yapılandırmaları ayarlayın
2. adım: Kullanıcı arayüzünde Liftoff Monetize 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 Liftoff 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 Liftoff ekleyin.
3. Adım: Vungle SDK ve Liftoff Monetize bağdaştırıcısını içe aktarın
Liftoff için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin
Şuradaki indirme bağlantısından para kazanın:
Değişiklik günlüğü'nü açın ve
GoogleMobileAdsVungleMediation.unitypackage
.
Unity proje düzenleyicinizde Öğeler > Paketi İçe Aktar >
Özel Paket'e dokunup GoogleMobileAdsVungleMediation.unitypackage
dosyasını bulun.
indiremezsiniz. 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 >
Zorla Çöz'e dokunun. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve belirtilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android
dizinine kopyalar.
4. adım: Liftoff Monetize SDK'da gizlilik ayarlarını 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 Yönetmeliği (GDPR) şartlarını yansıtmaktadır. 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.
Liftoff Monetize için Google Mobil Reklamlar uyumlulaştırma eklentisi, Vungle SDK'ya izin bilgilerini iletme. Aşağıdaki örnek kod, Vungle SDK'ya izin bilgilerini iletmek için kullanılır. Bu yöntemini kullanıyorsanız, bu işlemi Google Mobile Ads SDK'sı.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif
Daha fazla bilgi ve yöntemde sağlanabilecek değerler için GDPR'nin Android ve iOS için önerdiği uygulama talimatlarını inceleyin.
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.
Liftoff Monetize için Google Mobil Reklamlar uyumlulaştırma eklentisi, Vungle SDK'ya izin bilgilerini iletme. Aşağıdaki örnek kod, Vungle SDK'ya izin bilgilerini iletmek için kullanılır. Bu yöntemini kullanıyorsanız, bu işlemi Google Mobile Ads SDK'sı.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetCCPAStatus(true);
Şunlar için CCPA tarafından önerilen uygulama talimatlarını inceleyin: Daha fazla ayrıntı için Android ve iOS yöntemde eklenebilecek değerleri ifade eder.
5. Adım: Gerekli kodu ekleyin
Android
Liftoff Monetize entegrasyonu için ek kod gerekmez.
iOS
SKAdNetwork entegrasyonu
SKAdNetwork tanımlayıcılarını projenizin Info.plist
dosyasına eklemek için Liftoff Monetize'in dokümanlarını inceleyin.
6. Adım: Uygulamanızı test edin
Test reklamlarını etkinleştir
AdMob için test cihazınızı kaydettiğinizden ve Liftoff Monetize kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.
Test reklamlarını doğrulama
Liftoff Monetizereklam kaynağından test reklamları aldığınızı doğrulamak için Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
Hata kodları
Bağdaştırıcı, Liftoff Monetize'dan reklam alamazsa yayıncılar
reklam yanıtındaki temel hatayı kontrol etmek için
ResponseInfo
(aşağıdaki sınıflarda):
Android
Biçim | Sınıf adı |
---|---|
Uygulama Açılışı (Teklifli Sistem) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Uygulama Açılışı (Şelale) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Banner (Teklifli Sistem) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Banner (Şelale) | com.vungle.mediation.VungleInterstitialAdapter |
Geçiş reklamı (Teklif Verme) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Geçiş Reklamı (Şelale) | com.vungle.mediation.VungleInterstitialAdapter |
Ödüllü (Teklifli Sistem) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Ödüllü (Şelale) | com.vungle.mediation.VungleAdapter |
Ödüllü Geçiş Reklamı (Teklif Verme) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Ödüllü Geçiş Reklamı (Şelale) | com.google.ads.mediation.vungle.VungleMediationAdapter |
iOS
Biçim | Sınıf adı |
---|---|
Uygulama Açılışı (Teklifli Sistem) | GADMediationAdapterVungle |
Uygulama Açılışı (Şelale) | GADMediationAdapterVungle |
Banner (Teklifli Sistem) | GADMediationAdapterVungle |
Banner (Şelale) | GADMAdapterVungleInterstitial |
Geçiş reklamı (Teklifli sistem) | GADMediationAdapterVungle |
Geçiş Reklamı (Şelale) | GADMAdapterVungleInterstitial |
Ödüllü (Teklif Verme) | GADMediationAdapterVungle |
Ödüllü (Şelale) | GADMAdapterVungleRewardBasedVideoAd |
Ödüllü Geçiş Reklamı (Teklifli Sistem) | GADMediationAdapterVungle |
Ödüllü Geçiş Reklamı (Şelale) | GADMediationAdapterVungle |
Liftoff Monetize tarafından oluşturulan kodlar ve beraberindeki mesajlar bağdaştırıcısını kontrol etmek için aşağıdaki adımları uygulayın:
Android
Hata kodu | Neden |
---|---|
101 | Geçersiz sunucu parametreleri (ör. uygulama kimliği veya yerleşim kimliği). |
102 | İstenen banner boyutu geçerli bir Liftoff Monetize reklamıyla eşleşmiyor seçin. |
103 | Liftoff Monetize'ın isteği için Activity bağlamı gerekir.
reklam. |
104 | Vungle SDK'sı aynı yerleşim kimliği için birden fazla reklam yükleyemez. |
105 | Vungle SDK'sı başlatılamadı. |
106 | Vungle SDK başarılı bir yükleme geri çağırması döndürdü, ancak Banners.getBanner() veya Vungle.getNativeAd() null döndürdü. |
107 | Vungle SDK'sı reklamı oynatmaya hazır değil. |
108 | Vungle SDK'sı geçersiz teklif jetonu döndürdü. |
iOS
Hata kodu | Neden |
---|---|
101 | Geçersiz sunucu parametreleri (ör. uygulama kimliği veya yerleşim kimliği). |
102 | Bu ağ yapılandırması için zaten bir reklam yüklü. Vungle SDK'sı aynı yerleşim kimliği için ikinci bir reklam yükleyemez. |
103 | İstenen reklam boyutu, Liftoff Monetize'ın desteklediği bir istekle eşleşmiyor banner boyutu. |
104 | Vungle SDK'sı banner reklamı oluşturamadı. |
105 | Vungle SDK'sı aynı anda yalnızca 1 banner reklam yüklemeyi destekler. yerleşim kimliği. |
106 | Vungle SDK'sı, reklamın oynatılamayacağını belirten bir geri çağırma gönderdi. |
107 | Vungle SDK'sı reklamı oynatmaya hazır değil. |
Vungle SDK'sından gelen hatalar için Hata Kodları: iOS ve Android için Vungle SDK'ya bakın.
Liftoff Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü
Sürüm 5.2.1
DummyClient
adlı dosyaPlaceholderClient
olarak yeniden adlandırıldı.- Liftoff Monetize Android bağdaştırıcısının 7.4.0.1 sürümünü destekler.
- Liftoff Monetize iOS bağdaştırıcısının 7.4.0.1 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 5.2.0
- Liftoff Monetize Android bağdaştırıcısının 7.4.0.0 sürümünü destekler.
- Liftoff Monetize iOS bağdaştırıcısının 7.4.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.1 sürümü ile oluşturulup test edilmiştir.
Sürüm 5.1.1
- Liftoff Monetize Android bağdaştırıcısının 7.3.2.0 sürümünü destekler.
- Liftoff Monetize iOS bağdaştırıcısının 7.3.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 5.1.0
- Android projesi olarak dışa aktarırken derleme hatasına neden olan bir
NullPointerException
düzeltildi. - Gizlilik API'leri güncellendi:
UpdateConsentStatus()
veUpdateCCPAStatus()
yöntemleri kaldırıldı.VungleConsentStatus
veVungleCCPAStatus
sıralamaları kaldırıldı.SetGDPRStatus(bool)
yöntemiSetGDPRStatus(bool, String)
olarak güncellendi.
LiftoffMonetizeMediationExtras
sınıfından aşağıdaki yöntemler kaldırıldı:SetAllPlacements(String[])
SetSoundEnabled(bool)
- Liftoff Monetize Android bağdaştırıcısının 7.3.1.0 sürümünü destekler.
- Liftoff Monetize iOS bağdaştırıcısı 7.3.1.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 5.0.0
MediationExtras
için yinelenen tanım uyarısı düzeltildi.- Liftoff Monetize Android bağdaştırıcısının 7.1.0.0 sürümünü destekler.
- Liftoff Monetize iOS bağdaştırıcısının 7.2.1.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.7.0 sürümü ile oluşturulup test edilmiştir.
Sürüm 4.0.0
- Vungle olan Unity uyumlulaştırma eklentisi Liftoff Monetize olarak yeniden adlandırıldı.
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/LiftoffMonetize/
hedefine taşındı. - Bağdaştırıcı ad alanı,
GoogleMobileAds.Mediation.LiftoffMonetize
kullanılacak şekilde yeniden düzenlendi. LiftoffMonetize
sınıfına aşağıdaki yöntemler eklendi:SetGDPRStatus(bool)
SetGDPRMessageVersion(String)
SetCCPAStatus(bool)
- Liftoff Monetize Android bağdaştırıcısı 6.12.1.1 sürümünü destekler.
- Liftoff Monetize iOS bağdaştırıcısının 7.0.1.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.4.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.9.2
Vungle
sınıfı güncellendi:UpdateCCPAStatus(VungleCCPAStatus)
yöntemi eklendi.GetCurrentConsentStatus()
yöntemi kaldırıldı.GetCurrentConsentMessageVersion()
yöntemi kaldırıldı.
- Vungle Android bağdaştırıcısı 6.12.1.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.12.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.4.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.9.1
- Vungle Android bağdaştırıcısı 6.12.1.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.12.1.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.4.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.9.0
- Vungle Android bağdaştırıcısı 6.12.0.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.12.0.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.8.2
- Vungle Android bağdaştırıcısı 6.11.0.2 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.11.0.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 3.8.1
- Vungle Android bağdaştırıcısı 6.11.0.1 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.11.0.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.8.0
- Vungle Android bağdaştırıcısı 6.11.0.0 sürümünü destekler.
- Vungle iOS adaptörünün 6.11.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.0 sürümü ile derlenmiş ve test edilmiştir.
Sürüm 3.7.5
- Vungle Android bağdaştırıcısı 6.10.5.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.10.6.1 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.0 sürümü ile derlenmiş ve test edilmiştir.
3.7.4 sürümü
- Vungle Android bağdaştırıcısı 6.10.4.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.10.6.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.7.3
- Vungle Android bağdaştırıcısı 6.10.3.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.10.5.1 sürümünü destekler.
3.7.2 sürümü
- Vungle Android bağdaştırıcısı 6.10.2.1 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.10.5.1 sürümünü destekler.
Sürüm 3.7.1
- Vungle Android bağdaştırıcısı 6.10.2.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.10.4.0 sürümünü destekler.
Sürüm 3.7.0
- Vungle Android bağdaştırıcısı 6.10.2.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.10.3.0 sürümünü destekler.
Sürüm 3.6.0
- Vungle Android bağdaştırıcısı 6.9.1.1 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.9.2.0 sürümünü destekler.
3.5.1 sürümü
- Vungle Android bağdaştırıcısı 6.8.1.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.8.1.0 sürümünü destekler.
3.5.0 sürümü
- Vungle Android bağdaştırıcısı 6.8.0.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.8.0.0 sürümünü destekler.
Sürüm 3.4.1
- Vungle Android bağdaştırıcısı 6.7.1.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.7.1.0 sürümünü destekler.
Sürüm 3.4.0
- Vungle Android bağdaştırıcısı 6.7.0.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.7.0.0 sürümünü destekler.
Sürüm 3.3.1
vungle-extras-library.jar
, Unity 2020'yi desteklemek için bir.aar
derlemesi kullanılarakvungle-unity-android-library.aar
olarak yeniden paketlendi.- Bu sürüme geçerken lütfen projenizden
vungle-extras-library.jar
hizmetini kaldırın.
- Bu sürüme geçerken lütfen projenizden
- Vungle Android bağdaştırıcısı 6.5.3.0 sürümünü destekler.
- Vungle iOS adaptörünün 6.5.3.0 sürümünü destekler.
Sürüm 3.3.0
- Vungle Android bağdaştırıcısı 6.5.3.0 sürümünü destekler.
- Vungle iOS bağdaştırıcının 6.5.3.0 sürümünü destekler.
Sürüm 3.2.0
- Vungle Android bağdaştırıcısı 6.4.11.1 sürümünü destekler.
- Vungle iOS adaptörünün 6.4.6.0 sürümünü destekler.
3.1.4 sürümü
- Android bağdaştırıcısı 6.3.24.1 sürümünü destekler.
- iOS bağdaştırıcısı 6.3.2.3 sürümünü destekler.
Sürüm 3.1.3
- Android bağdaştırıcısı 6.3.24.1 sürümünü destekler.
- iOS bağdaştırıcısı 6.3.2.2 sürümünü destekler.
3.1.2 sürümü
- Eklenti, yeni açık beta Ödüllü API'yi destekleyecek şekilde güncellendi.
- Android bağdaştırıcısı 6.3.24.1 sürümünü destekler.
- iOS bağdaştırıcısı 6.3.2.1 sürümünü destekler.
Sürüm 3.1.1
- Android bağdaştırıcısı 6.3.24.0 sürümünü destekler.
- iOS bağdaştırıcısı 6.3.2.0 sürümünü destekler.
Vungle.UpdateConsentStatus()
yöntemi,consentMessageVersion
parametresini isteğe bağlı hale getirecek şekilde güncellendi.consentMessageVersion
değeri artık iOS için yoksayılıyor.Vungle.GetCurrentConsentMessageVersion()
, iOS için kullanımdan kaldırıldı.
Sürüm 3.1.0
- Android bağdaştırıcısı 6.3.17.0 sürümünü destekler.
- iOS bağdaştırıcısı 6.3.0.0 sürümünü destekler.
Vungle.UpdateConsentStatus()
yöntemi, yayıncı tarafından sağlanan kullanıcı rızası alma mesajı sürümü için ek birString
parametresi alacak şekilde güncellendi.- Yayıncı tarafından sağlanan kullanıcı rızası alma mesajı sürümünü almak için
Vungle.GetCurrentConsentMessageVersion()
yöntemi eklendi.
Sürüm 3.0.1
- Android bağdaştırıcısı 6.2.5.1 sürümünü destekler.
- iOS adaptörünün 6.2.0.3 sürümünü destekler.
Sürüm 3.0.0
- Android bağdaştırıcısı 6.2.5.0 sürümünü destekler.
- iOS bağdaştırıcısı 6.2.0.2 sürümünü destekler.
- Aşağıdaki yöntemler eklendi:
Vungle.UpdateConsentStatus()
yöntemini kullanın.Vungle.GetCurrentConsentStatus()
yöntemini kullanarak kullanıcının mevcut izin durumunu öğrenin.
Sürüm 2.0.0
- Android adaptörünün 5.3.2.1 sürümünü destekler.
- iOS bağdaştırıcısı 6.2.0.0 sürümünü destekler.
Sürüm 1.1.0
- Android bağdaştırıcısının 5.3.2.1 sürümünü destekler.
- iOS bağdaştırıcısı 5.4.0.0 sürümünü destekler.
Sürüm 1.0.0
- İlk çıkış tarihi!
- Android bağdaştırıcısı 5.3.0.0 sürümünü destekler.
- iOS bağdaştırıcısı 5.3.0.0 sürümünü destekler.