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'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 bir Unity uygulamasına nasıl entegre edileceği açıklanmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

1 Bu biçim için teklifli sistem 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]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek amacıyla AppLovin 5.1.0 veya sonraki sürümler için Google Mobile Ads uyumlulaştırma eklentisini kullanın (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ış çalışan bir Unity projesi. 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 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 Uygulamalar 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ıyla kullanılacak yeni bir yerleşim oluşturmak için Liftoff Para Kazanma Yerleşimleri 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şim oluşturmak için sayfanın alt kısmı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 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.

Ödüllü

Ödüllü'yü 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.

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

Raporlama API'si anahtarınızı bulma

Teklif verme

Bu adım, teklifli sistem 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 etkinleştirme

Test reklamları etkinleştirmek için Liftoff Monetize kontrol panelinize gidin 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 Yalnızca test reklamlarını göster'i seçerek Test Modu'nda etkinleştirilebilir.

Yapay Zeka

iOS

2. adım: AdMob kullanıcı arayüzünde Liftoff Monetize demand'ı ayarlayın

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

Yapay Zeka

Talimatlar için Android kılavuzundaki 2. adıma bakın.

iOS

Talimatlar için iOS kılavuzunun 2. adımına bakın.

Liftoff'u 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ındaki ve ABD eyalet düzenlemeleri ayarlarındaki 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

OpenUPM-CLI

OpenUPM-CLI yüklüyse projenizin kök dizininden aşağıdaki komutu çalıştırarak Unity için Google Mobil Reklamlar Liftoff Para Kazanma Uyumlulaştırma Eklentisi'ni projenize yükleyebilirsiniz:

openupm add com.google.ads.mobile.mediation.liftoffmonetize

OpenUPM

Unity Paket Yöneticisi Ayarlarını açmak için Unity proje düzenleyicinizde Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçin.

Kapsamlı Kayıt Daireleri sekmesinde, OpenUPM'yi aşağıdaki ayrıntılarla kapsamlı bir kayıt dairesi olarak ekleyin:

  • Ad: OpenUPM
  • URL: https://package.openupm.com
  • Kapsamlar: com.google

OpenUPM Ayrıntıları

Ardından, Unity Paket Yöneticisi'ni açmak için pencere > Paket Yöneticisi'ne gidin ve açılır menüden Kayıt Dairelerim'i seçin.

Unity Kayıt Daireleri

Google Mobil Reklamlar Liftoff Para Kazanma Uyumlulaştırma paketini seçin ve Yükle'yi tıklayın.

OpenUPM'den yükleme

Unity Paketi

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

Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsLiftoffMonetizeMediation.unitypackage dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.

Unity'den içe aktarma

Ardından Öğeler > Harici Bağımlılık Yöneticisi > Android Çözücü > Çözümü Zorla'yı seçin. Harici Bağımlılık Yöneticisi kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

Çözümü Zorla Uygula

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

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanı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 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ımına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılar. Bu 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 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 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.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ü (Teklif Verme) 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ı (Teklif Verme) GADMediationAdapterVungle
Geçiş reklamı (Şelale) GADMAdapterVungleInterstitial
Ödüllü (Teklif Verme) 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 birlikte gönderilen 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, reklam isteğinde bulunmak için Activity bağlamı gerektirir.
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ılamadığına dair 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ırma Eklentisi Değişiklik Günlüğü

5.2.2 sürümü

5.2.1 sürümü

5.2.0 sürümü

5.1.1 sürümü

Sürüm 5.1.0

  • Android projesi olarak dışa aktarırken derleme hatasına neden olan 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ü 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.
  • Adaptör içeriği GoogleMobileAds/Mediation/LiftoffMonetize/ konumuna taşındı.
  • Bağdaştırıcı ad alanı, GoogleMobileAds.Mediation.LiftoffMonetize kullanacak ş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ü ile oluşturulup test edilmiştir.

3.9.2 sürümü

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ü

3.7.3 sürümü

3.7.2 sürümü

3.7.1 sürümü

3.7.0 sürümü

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 adaptörünün 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 Rewarded API'yi destekleyecek şekilde güncellendi.
  • Android bağdaştırıcısı 6.3.24.1 sürümünü destekler.
  • iOS adaptörünün 6.3.2.1 sürümünü destekler.

3.1.1 sürümü

  • 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.
  • 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 adaptör 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 adaptörünün 6.2.0.0 sürümünü destekler.

Sürüm 1.1.0

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