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

Bu kılavuzda, hem teklifli sistem hem de şelale entegrasyonlarını kapsayan uyumlulaştırma yöntemini kullanarak Liftoff Monetize'dan reklamları 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 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 bir Unity uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

Entegrasyon
Teklif
Şelale
Formatlar
Banner 1
Geçişli
Ödül olarak verildi
Ödüllü Geçiş Reklamı 1, 2

1 Bu biçim için teklifli sistem entegrasyonu açık beta sürümündedir.

2 Ödüllü geçiş reklamı kurulum için yardım gerektirir. Liftoff Monetize'dan veya monetize@liftoff.io adresinden hesap yöneticinizle iletişime geçebilirsiniz.

Koşullar

  • En yeni 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 üstü iOS dağıtım hedefi
  • Google Mobile Ads SDK'sı ile yapılandırılmış, çalışan bir Unity proje. Ayrıntılar için Başlarken bölümüne bakın.
  • Uyumlulaştırmayı tamamlayın Başlangıç kılavuzunu

1. Adım: Liftoff Para Kazanma kullanıcı arayüzünde yapılandırmaları ayarlayın

LiftoffMonetize hesabınıza kaydolun veya giriş yapın.

Uygulama Ekle düğmesini tıklayarak uygulamanızı Liftoff Monetize hesap özetine ekleyin.

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

Android

iOS

Uygulamanız oluşturulduktan sonra Liftoff Monetize Applications gösterge tablosundan uygulamanızı seçin.

Android

iOS

Uygulama kimliğini not edin.

Android

iOS

Yeni yerleşimler ekleme

Uyumlulaştırma AdMob ile kullanılacak yeni bir yerleşim oluşturmak için, Liftoff Monetize Placements 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:

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 anahtarını Etkin durumuna getirin. Yerleşimi oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.

300x250 Şerit

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

Geçişli

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

Ödül olarak verildi

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

Referans Kimliği'ni not edin ve Sounds Good'u tıklayın.

300x250 Şerit

Geçişli

Ödül olarak verildi

Ödüllü Geçiş Reklamı

Yerel biçim

Raporlama API'sı Anahtarınızı Bulma

Teklif

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

Şelale

AdMob reklam birimi kimliğinizi oluşturmak için Uygulama Kimliği ve Referans Kimliği'ne ek olarak Liftoff Monetize Reporting API Key'inize ihtiyacınız olacaktır. Liftoff Monetize Reports kontrol paneline gidin ve Reporting API Anahtarı düğmesini tıklayarak Raporlama API'sı Anahtarınızı görüntüleyin.

Test modunu aç

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ünün altında Test Modu'nu Yalnızca test reklamlarını göster'i seçtikten sonra etkinleştirilebilir.

Android

iOS

2. Adım: Kullanıcı arayüzünde Liftoff Para Kazanma talebi özelliğini AdMob ayarlayın

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 ekle

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'sını ve Liftoff Monetize bağdaştırıcısını içe aktarın

Changelog'daki indirme bağlantısından LiftoffMonetize için Google Mobile Ads 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 > Paketi İç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ümleyicisi > Android Çözümleyici > Çözücüye Zorla'yı seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemeyi sıfırdan gerçekleştirecek ve beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalayacaktır.

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ı'ndaki (AEA) kullanıcılara cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken, uyumlulaştırma zincirinizde kişisel verileri toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

Liftoff Monetize 4.0.0 sürümü için Google Mobile Ads uyumlulaştırma eklentisi, izin bilgilerini Vungle SDK'sına geçirmeye yönelik yöntemler içerir.

Android

İzin durumunu güncellerken belirtebileceğiniz iki olası değer vardır:

  • VungleConsentStatus.OPTED_IN
  • VungleConsentStatus.OPTED_OUT

Aşağıdaki örnek kod, izin durumunu VungleConsentStatus.OPTED_IN olarak günceller. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sını kullanarak reklam isteğinde bulunmadan önce yapmanız önerilir.

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.UpdateConsentStatus(VungleConsentStatus.OPTED_IN, "1.0.0");

Daha fazla ayrıntı ve yöntemde sağlanabilen değerler için GDPR önerilen uygulama talimatlarına bakın.

iOS

Aşağıdaki örnek kod, izin bilgilerini Vungle iOS SDK'sına yönlendirir. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sını kullanarak reklam istemeden önce yapmanız önerilir.

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetGDPRStatus(true);
LiftoffMonetize.SetGDPRMessageVersion("1.0.0");

Daha fazla bilgi ve yöntemde sağlanabilen değerler için GDPR önerilen uygulama talimatlarına bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını 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 dahil olabilecek tüm reklam ağlarını belirlemeniz ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

Liftoff Monetize 4.0.0 sürümü için Google Mobile Ads uyumlulaştırma eklentisi, izin bilgilerini Vungle SDK'sına geçirmeye yönelik yöntemler içerir.

Android

İzin durumunu güncellerken belirtebileceğiniz iki olası değer vardır:

  • VungleCCPAStatus.OPTED_IN
  • VungleCCPAStatus.OPTED_OUT

Aşağıdaki örnek kod, izin durumunu VungleCCPAStatus.OPTED_IN olarak günceller. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sını kullanarak reklam isteğinde bulunmadan önce yapmanız önerilir.

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.UpdateCCPAStatus(VungleCCPAStatus.OPTED_IN);

Daha fazla ayrıntı ve yöntemde sağlanabilecek değerler için CCPA önerilen uygulama talimatlarını inceleyin.

iOS

Aşağıdaki örnek kod, izin bilgilerini Vungle iOS SDK'sına yönlendirir. Bu yöntemi çağırmayı seçerseniz bunu, Google Mobile Ads SDK'sını kullanarak reklam istemeden önce yapmanız önerilir.

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetCCPAStatus(true);

Daha fazla ayrıntı ve yöntemde sağlanabilecek değerler için CCPA önerilen uygulama talimatlarını inceleyin.

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'ın belgelerini uygulayın.

6. Adım: Uygulamanızı test etme

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 aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

iOS

Biçim Sınıf adı
Banner GADMAdapterVungleInterstitial
Geçişli GADMAdapterVungleInterstitial
Ödül olarak verildi GADMAdapterVungleÖdül TabanlıVideoReklam

Bir reklam yüklenemediğinde Liftoff Monetize bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajlar aşağıda verilmiştir:

iOS

Hata kodu Neden
1-100 Vungle SDK'sı bir hata döndürdü. Daha fazla bilgi için kodu inceleyin.
101 AdMob Kullanıcı arayüzünde yapılandırılan Liftoff Para Kazanma sunucu parametreleri eksik/geçersiz.
102 Bu ağ yapılandırması için zaten bir reklam yüklendi. Vungle SDK'sı, aynı yerleşim kimliği için ikinci bir reklam yükleyemez.
103 İstenen reklam boyutu, Liftoff Monetize'ın desteklediği 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 tek seferde yalnızca 1 banner reklam yüklemeyi destekler.
106 Vungle SDK'sı, reklamın oynatılamadığını söyleyen bir geri çağırma gönderdi.

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

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 numaralandırmaları kaldırıldı.
    • SetGDPRStatus(bool) yöntemi SetGDPRStatus(bool, String) olarak güncellendi.
  • Aşağıdaki yöntemler LiftoffMonetizeMediationExtras sınıfından 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 sürüm 9.1.0 ile geliştirilip test edilmiştir.

Sürüm 5.0.0

Sürüm 4.0.0

  • Unity uyumlulaştırma eklentisi Vungle'dan Liftoff Monetize olarak yeniden adlandırıldı.
  • Bağdaştırıcı içeriği GoogleMobileAds/Mediation/LiftoffMonetize/ klasörüne taşındı.
  • Bağdaştırıcı ad alanı, GoogleMobileAds.Mediation.LiftoffMonetize kullanılacak şekilde yeniden düzenlendi.
  • Aşağıdaki yöntemler LiftoffMonetize sınıfına eklendi:
    • SetGDPRStatus(bool)
    • SetGDPRMessageVersion(String)
    • SetCCPAStatus(bool)
  • Liftoff Monetize Android adaptörü sürüm 6.12.1.1'i 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 sürüm 8.4.1 ile geliştirilip test edilmiştir.

Sürüm 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 3.8.0

Sürüm 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

  • Android adaptör 6.3.24.1 sürümünü destekler.
  • iOS bağdaştırıcısının 6.3.2.3 sürümünü destekler.

Sürüm 3.1.3

  • Android adaptör 6.3.24.1 sürümünü destekler.
  • iOS bağdaştırıcısının 6.3.2.2 sürümünü destekler.

Sürüm 3.1.2

  • Eklenti, yeni açık beta Ödüllü API'yi destekleyecek şekilde güncellendi.
  • Android adaptör 6.3.24.1 sürümünü destekler.
  • iOS bağdaştırıcısının 6.3.2.1 sürümünü destekler.

Sürüm 3.1.1

  • Android adaptör 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 getirmek için güncellendi. consentMessageVersion değeri artık iOS için yoksayılır.
  • Vungle.GetCurrentConsentMessageVersion(), iOS için kullanımdan kaldırıldı.

Sürüm 3.1.0

  • Android adaptör 6.3.17.0 sürümünü destekler.
  • iOS bağdaştırıcısı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 almak üzere 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ının 6.2.5.1 sürümünü destekler.
  • iOS bağdaştırıcısı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ının 6.2.0.2 sürümünü destekler.
  • Aşağıdaki yöntemler eklendi:
    • Vungle.UpdateConsentStatus() yöntemini kullanabilirsiniz.
    • Kullanıcının mevcut izin durumunu öğrenmek için Vungle.GetCurrentConsentStatus() yöntemini kullanın.

Sürüm 2.0.0

  • Android adaptör 5.3.2.1 sürümünü destekler.
  • iOS bağdaştırıcısının 6.2.0.0 sürümünü destekler.

Sürüm 1.1.0

  • Android adaptör 5.3.2.1 sürümünü destekler.
  • iOS bağdaştırıcısının 5.4.0.0 sürümünü destekler.

Sürüm 1.0.0

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