Liftoff Monetize'ı uyumlulaştırma ile entegre etme

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 makalede, Liftoff Monetize'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Vungle SDK'sının ve bağdaştırıcının birUnity uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Entegrasyon
Teklif verme 1
Şelale
Formatlar
Uygulama Açma 2
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı

1 Teklif entegrasyonu açık beta sürümündedir.

Bu biçim için 2 şelale entegrasyonu açık beta sürümündedir.

Şartlar

  • En son Google Mobile Ads SDK'sı .
  • Unity 4 veya üzeri
  • (Teklif verme için): Liftoff Monetize için Google Mobile Ads uyumlulaştırma eklentisi 3.8.2 veya daha yeni sürüm (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. Ayrıntılar için Başlayın bölümüne bakın.
  • Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu

1. adım: Liftoff Monetize kullanıcı arayüzünde yapılandırmaları ayarlayın

Liftoff'unuza kaydolun veya giriş yapın Hesaptan para kazanın.

Uygulamanızı Liftoff Monetize kontrol paneline ekleyin Uygulama Ekle düğmesini tıklayarak.

Gerekli tüm ayrıntıları girerek formu doldurun.

Android

iOS

Uygulamanız oluşturulduktan sonra Liftoff Monetize Applications kontrol paneli.

Android

iOS

Uygulama kimliğini not edin.

Android

iOS

Yeni yerleşimler ekleme

AdMob ile kullanılacak yeni bir yerleşim oluşturmak için uyumlulaştırmasından yararlanmak için Liftoff Monetize Yerleşimler kontrol paneli Yerleşim Ekle düğmesini tıklayın ve açılır menüden uygulamanızı seçin liste'ye dokunun.

Yeni yerleşim eklemeyle ilgili ayrıntılar aşağıda verilmiştir:

Uygulama Açma

Geçiş reklamı'nı seçin ve bir Yerleşim Adı girin. Ardından, Atlanabilir için Evet'i seçin ve formun geri kalanını doldurun. [Yalnızca teklif verme] Altında Para kazanma, Uygulama İçi Teklif Verme anahtarını Etkin durumuna getirin. Sayfanın altındaki Devam düğmesini tıklayarak yerleşim.

Banner'ı seçin, bir Yerleşim Adı girin ve formun geri kalanını doldurun. [Yalnızca teklif verme] Para kazanma altında, Uygulama İçi Teklif Verme'yi açın/kapatın Etkin durumuna getirin. Ekranın altındaki Devam düğmesini tıklayın sayfasını ziyaret ederek yerleşim oluşturabilirsiniz.

300x250 Banner

MREC'yi seçin, bir Yerleşim Adı girin ve formunu doldurun. [Yalnızca teklif verme] Para kazanma bölümünde Uygulama İçi Teklif Verme anahtarını Etkin konumuna getirin. Yerleşim oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.

Geçiş reklamı

Geçiş reklamı'nı seçin, bir Yerleşim Adı girin ve formun geri kalanını doldurun. [Yalnızca teklif verme] Para kazanma bölümünde, Uygulama İçi Teklif Verme anahtarını Etkin konumuna getirin. Şu adreste bulunan Devam düğmesini tıklayın: sayfanın alt kısmına gidin.

Ödüllü

Ödüllü'yü seçin, bir Yerleşim Adı girin ve formun geri kalanını doldurun. [Yalnızca teklif verme] Para kazanma altında, Uygulama İçi Teklif Verme'yi açın/kapatın Etkin durumuna getirin. Yerleşim oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.

Ödüllü geçiş reklamı

Ödüllü'yü seçin. Bir Yerleşim Adı girin, Atlanabilir'i etkinleştirin ve formun geri kalanını doldurun. [Yalnızca teklif verme] Para kazanma altında, Uygulama İçi Teklif Verme anahtarını Etkin yapın. Devam düğmesini tıklayın. tıklayın.

Yerel biçim

Yerel'i seçin, bir Yerleşim Adı girin ve formunu doldurun. [Yalnızca teklif verme] Para kazanma bölümünde Uygulama İçi Teklif Verme anahtarını Etkin konumuna getirin. Ekranın altındaki Devam düğmesini tıklayın sayfasını ziyaret ederek yerleşim oluşturabilirsiniz.

Referans kimliğini not edin ve Tamam'ı tıklayın.

Uygulama Açma

300x250 Banner

Geçiş reklamı

Ödüllü

Ödüllü geçiş reklamı

Yerel biçim

Raporlama API'si anahtarınızı bulma

Teklif verme

Bu adım, teklif entegrasyonları için gerekli değildir.

Şelale

AdMob reklam birimi kimliğinizi ayarlamak için uygulama kimliğinin ve Referans Kimliğinin yanı sıra Liftoff Monetize Reporting API Anahtarınızın da olması gerekir. Reporting API anahtarınızı görüntülemek için Liftoff Monetize raporları kontrol paneline gidin ve Reporting API anahtarı düğmesini tıklayın.

Test modunu aç

Test reklamları etkinleştirmek için Liftoff Monetize kontrol panelinize gidin ve Uygulamalar'a gidin.

Test reklamlarını etkinleştirmek istediğiniz uygulamanızı Yerleşim Referans Kimliği bölümü Test reklamları, Durum bölümünde Yalnızca test reklamlarını göster olarak Test Modu'nu seçerek.

Android

iOS

2. adım: Kullanıcı arayüzünde Liftoff Monetize talebini ayarlayın Ad Manager

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

Android

Talimatlar için Android Android.

iOS

Talimatlar için iOS rehberinin 2. adımına göz atın. iOS.

Liftoff 'i GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

3. Adım: Vungle SDK'sını 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 > Çözümü Zorla'yı seçin. Unity Play Hizmetleri Çözümleyici kitaplığı çalışacak ve beyan edilen bağımlılıkları kopyalayıp Unity uygulamanızın Assets/Plugins/Android dizini.

4. adım: Liftoff Monetize SDK'sında gizlilik ayarlarını uygulayın

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.

Liftoff Monetize için Google Mobile Ads uyumlulaştırması eklentisi, izin bilgilerini Vungle SDK'sına iletme yöntemleri içerir. Aşağıdaki örnek kodda, izin bilgilerinin Vungle SDK'sına nasıl iletileceği gösterilmektedir. Bu yöntemi çağırmayı seçerseniz bunu Google Mobile Ads SDK'sı üzerinden reklam istemeden önce yapmanız önerilir.

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, kişisel bilgilerinin "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılıyor. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantıyla sunulur. İ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, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilir her reklam ağını tanımlamanız ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

Liftoff Monetize için Google Mobile Ads uyumlulaştırması eklentisi, izin bilgilerini Vungle SDK'sına iletme yöntemleri içerir. 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);

Daha fazla bilgi ve yöntemde sağlanabilecek değerler için Android ve iOS için CCPA'nın önerdiği uygulama talimatlarını inceleyin.

5. Adım: Gerekli kodu ekleyin

Android

Liftoff Monetize entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

Liftoff Monetize'ın belgeleri 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 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ış Reklamı (Teklifli Sistem) com.google.ads.mediation.vungle.VungleMediationAdapter
Uygulama açılışı (şelale) com.google.ads.mediation.vungle.VungleMediationAdapter
Banner (Teklif Verme) 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ış Reklamı (Teklifli Sistem) GADMediationAdapterVungle
Uygulama açılışı (şelale) GADMediationAdapterVungle
Banner (Teklif Verme) GADMediationAdapterVungle
Banner (Şelale) GADMAdapterVungleInterstitial
Geçiş reklamı (Teklifli sistem) GADMediationAdapterVungle
Geçiş reklamı (Şelale) GADMAdapterVungleInterstitial
Ödüllü (Teklif) GADMediationAdapterVungle
Ödüllü (Şelale) GADMAdapterVungleRewardBasedVideoAd
Ödüllü Geçiş Reklamı (Teklif Verme) GADMediationAdapterVungle
Ödüllü Geçiş Reklamı (Şelale) GADMediationAdapterVungle

Bir reklam yüklenemezse Liftoff Monetize bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

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 boyutuyla eşleşmiyor.
103 Liftoff Monetize'ın isteği için bir Activity bağlamı olması 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'sı başarılı bir yükleme geri çağırma işlevi döndürdü ancak Banners.getBanner() veya Vungle.getNativeAd() işlevi 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 tarafından desteklenen bir banner boyutuyla eşleşmiyor.
104 Vungle SDK'sı banner reklamı oluşturamadı.
105 Vungle SDK'sı, yerleşim kimliğinden bağımsız olarak aynı anda yalnızca 1 banner reklam yüklemeyi destekler.
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 kaynaklanan hatalar için Hata Kodları: iOS ve Android için Vungle SDK'sı başlıklı makaleyi inceleyin.

Liftoff Monetize Unity Uyumlulaştırması Eklentisi Değişiklik Günlüğü

Sürüm 5.2.1

5.2.0 sürümü

Sürüm 5.1.1

Sürüm 5.1.0

  • Android projesi olarak dışa aktarılırken derleme hatasına neden olan bir NullPointerException düzeltildi.
  • Gizlilik API'leri güncellendi:
    • UpdateConsentStatus() ve UpdateCCPAStatus() yöntemleri kaldırıldı.
    • VungleConsentStatus ve VungleCCPAStatus enum'ları kaldırıldı.
    • SetGDPRStatus(bool) yöntemi SetGDPRStatus(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ının 7.3.1.0 sürümünü destekler.
  • Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.

Sürüm 5.0.0

Sürüm 4.0.0

  • Unity uyumlulaştırma eklentisinin adı Vungle'den Liftoff Monetize olarak değiştirildi.
  • 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ı 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.

3.9.2 sürümü

Sürüm 3.9.1

3.9.0 sürümü

3.8.2 sürümü

Sürüm 3.8.1

Sürüm 3.8.0

3.7.5 sürümü

3.7.4 sürümü

3.7.3 sürümü

Sürüm 3.7.2

Sürüm 3.7.1

Sürüm 3.7.0

3.6.0 sürümü

Sürüm 3.5.1

3.5.0 sürümü

3.4.1 sürümü

3.4.0 sürümü

3.3.1 sürümü

Sürüm 3.3.0

Sürüm 3.2.0

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.

3.1.3 sürümü

  • Android bağdaştırıcısı 6.3.24.1 sürümünü destekler.
  • iOS adaptörünün 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 adaptör sürüm 6.3.2.0'ı destekler.
  • Vungle.UpdateConsentStatus() yöntemi, consentMessageVersion parametresini isteğe bağlı hale getirmek için güncellendi. consentMessageVersion değeri artık iOS için yoksayılıyor.
  • iOS için Vungle.GetCurrentConsentMessageVersion() desteği sonlandırıldı.

Sürüm 3.1.0

  • Android adaptörünün 6.3.17.0 sürümünü destekler.
  • iOS adaptörünün 6.3.0.0 sürümünü destekler.
  • Yayıncı tarafından sağlanan izin mesajı sürümü için ek bir String parametresi alacak şekilde Vungle.UpdateConsentStatus() yöntemi 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 bağdaştırıcısı 6.2.0.3 sürümünü destekler.

Sürüm 3.0.0

  • Android adaptör 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 kullanarak Vungle SDK'sına kaydedilecek izin durumunu ayarlayın.
    • Vungle.GetCurrentConsentStatus() yöntemini kullanarak kullanıcının mevcut izin durumunu öğrenin.

Sürüm 2.0.0

  • Android bağdaştırıcısının 5.3.2.1 sürümünü destekler.
  • iOS adaptörünün 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 adaptörünün 5.4.0.0 sürümünü destekler.

Sürüm 1.0.0

  • İlk çıkış tarihi!
  • Android adaptörünün 5.3.0.0 sürümünü destekler.
  • iOS adaptörünün 5.3.0.0 sürümünü destekler.