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

Bu kılavuzda, hem teklifli sistem hem de şelale entegrasyonlarını kapsayan arabuluculuk kullanarak Liftoff Monetize'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, Liftoff Monetize'ın bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Vungle SDK ile bağdaştırıcısının birUnity uygulamaya entegre edilmesi 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 sonraki sürümler
  • 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şlarken 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 Monetize hesabınıza kaydolun veya oturum açın.

Uygulama Ekle düğmesini tıklayarak uygulamanızı Liftoff Para Kazanma kontrol paneline ekleyin.

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

Yapay Zeka

iOS

Uygulamanız oluşturulduktan sonra Liftoff Monetize Applications kontrol panelinden uygulamanızı seçin.

Yapay Zeka

iOS

Uygulama kimliğini not edin.

Yapay Zeka

iOS

Yeni yerleşimler ekleme

AdMob uyumlulaştırması ile kullanılacak yeni bir yerleşim oluşturmak için Liftoff Monetize anlaşılır kontrol paneline gidin, Yerleşim Ekle düğmesini tıklayın ve açılır listeden uygulamanızı seçin.

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] 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.

Banner'ı 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. Yerleşimi oluşturmak için sayfanın altındaki Devam düğmesini tıklayın.

300x250 Banner

MREC'yi 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. 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 altında, Uygulama İçi Teklif Verme anahtarını Etkin durumuna getirin. Yerleşim oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.

Ö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 anahtarı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 özelliğini etkinleştirin 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. Yerleşim oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.

Yerel biçim

Yerel'i 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. Yerleşim oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.

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

Reporting API 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ğine ve Referans Kimliğine ek olarak 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 etkinleştirme

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

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

Yapay Zeka

iOS

2. adım: Ad Manager kullanıcı arayüzünde Liftoff Talepten Para Kazanma'yı ayarlayın

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

AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Liftoff'u eklemek için GDPR ayarları ve ABD eyalet düzenlemeleri ayarlarında belirtilen adımları uygulayın.

3. Adım: Vungle SDK'sını ve Liftoff Monetize bağdaştırıcısını içe aktarın

Güncelleme Günlüğü'ndeki indirme bağlantısından Liftoff Para Kazanma için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsVungleMediation.unitypackage dosyasını çıkarın.

Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsVungleMediation.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 > Çözümü Zorla'yı seçin. 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'sında gizlilik ayarlarını uygulayın

Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcılarını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) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.

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, izin bilgilerinin Vungle SDK'ya nasıl iletileceğini gösterir. 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. ABD eyalet gizlilik yasaları 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 her reklam ağı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.

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 isteğinde bulunmadan önce yapmanız önerilir.

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

Yapay Zeka

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ştirme

AdMob için test cihazınızı kaydettiğinizden ve Liftoff Para Kazanma kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.

Test reklamlarını doğrulama

Liftoff Monetize'den test reklamları aldığınızı doğrulamak için Liftoff Monetize (Teklif Verme) ve Liftoff Monetize (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

Hata kodları

Adaptör, Liftoff Monetize'den reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

Yapay Zeka

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ışı (Teklifli Sistem) GADMediationAdapterVungle
Uygulama açılışı (şelale) GADMediationAdapterVungle
Banner (Teklif Verme) GADMediationAdapterVungle
Banner (Şelale) GADMAdapterVungleInterstitial
Geçiş reklamı (Teklif Verme) GADMediationAdapterVungle
Geçiş Reklamı (Şelale) GADMAdapterVungleInterstitial
Ödüllü (Teklifli Sistem) 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:

Yapay Zeka

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'da reklam isteğinde bulunmak için Activity bağlamı gerekir.
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'ın desteklediği bir banner boyutuyla eşleşmiyor.
104 Vungle SDK, 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ılamadığına dair 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 Monetize Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü

Sürüm 5.2.1

Sürüm 5.2.0

5.1.1 sürümü

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ı 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

Sürüm 4.0.0

  • Unity uyumlulaştırma eklentisinin adı Vungle'den Liftoff Monetize olarak değiştirildi.
  • Adaptör içeriği GoogleMobileAds/Mediation/LiftoffMonetize/ konumuna 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

3.9.1 sürümü

3.9.0 sürümü

3.8.2 sürümü

3.8.1 sürümü

Sürüm 3.8.0

3.7.5 sürümü

3.7.4 sürümü

Sürüm 3.7.3

3.7.2 sürümü

3.7.1 sürümü

Sürüm 3.7.0

3.6.0 sürümü

3.5.1 sürümü

3.5.0 sürümü

3.4.1 sürümü

3.4.0 sürümü

3.3.1 sürümü

3.3.0 sürümü

3.2.0 sürümü

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.

Sürüm 3.1.2

  • Eklenti, yeni açık beta Rewarded 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 adaptörünün 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.
  • Vungle.GetCurrentConsentMessageVersion(), iOS için kullanımdan kaldı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.
  • Vungle.UpdateConsentStatus() yöntemi, yayıncı tarafından sağlanan kullanıcı rızası alma mesajı sürümü için ek bir String 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 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 alın.

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.

1.1.0 sürümü

  • Android adaptörü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 sürüm!
  • 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.