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

AndroidiOS

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

AndroidiOS

Uygulama kimliğini not edin.

AndroidiOS

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:

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.

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ı'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ü'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ü'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'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.

Raporlama API'si anahtarınızı bulma

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

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.

AndroidiOS

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

AndroidiOS

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

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 AB ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Liftoff'u eklemek için AB düzenlemeleri ayarlarında ve ABD eyalet düzenlemeleri ayarlarında yer alan 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 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

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

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 dosyayı 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, cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili olarak Avrupa Ekonomik Alanı (AEA)'daki kullanıcılara 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ı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 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

Android iOS

Liftoff Monetize entegrasyonu için ek kod gerekmez.

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:

AndroidiOS
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 (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
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 birlikte gönderilen mesajlar aşağıda verilmiştir:

AndroidiOS
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 bir teklif jetonu döndürdü.
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.4 sürümü

5.2.3 sürümü

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 derlenmiş ve 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 adaptörünün 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.