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

Bu kılavuzda, Liftoff Monetize'dan reklam yüklemek ve uyumlulaştırmayı kullanarak hem teklifli sistem hem de şelale entegrasyonlarını kapsayan 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 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
Şelale
Formatlar
Uygulama Açma 1, 3
Banner 2
Geçişli
Ödül olarak verildi
Ödüllü geçiş reklamı 2

1 Bu biçim için teklif entegrasyonu kapalı beta sürümündedir.

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

3 Bu biçim için şelale entegrasyonu kapalı beta sürümündedir.

Koşullar

  • En son Google Mobile Ads SDK'sı
  • Unity 4 veya sonraki sürümler
  • (Teklif verme için): Liftoff Monetize 3.8.2 veya sonraki sürümler için Google Mobile Ads uyumlulaştırma eklentisi (en son sürüm önerilir)
  • Android'de dağıtım yapmak için
    • Android API düzeyi 21 veya üstü
  • iOS'te dağıtım yapmak 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 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

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:

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

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.

Uygulama Açma

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 Raporlama API'sı Anahtarınızı görüntülemek için Reporting API Anahtarı düğmesini tıklayın.

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 Monetize talebini ayarlayın AdMob

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 ekleyin

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 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 yeni sürümünü Değişiklik günlüğündeki indirme bağlantısından indirin ve zip dosyasından GoogleMobileAdsVungleMediation.unitypackage öğesini çıkarın.

Unity proje düzenleyicinizde Assets > Import Package > Custom Package'ı (Öğeler > Paketi İçe Aktar > Özel Paket) 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.

Sonra, Öğeler > Play Hizmetleri Çözümleyici > Android Çözümleyici > Zorla Çöz'ü seçin. Unity Play Hizmetleri Çözümleyici kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve beyan edilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android dizinine kopyalar.

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

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

Liftoff Monetize için Google Mobile Ads uyumlulaştırma 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 isteğinde bulunmadan ö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 ayrıntı ve yöntemde sağlanabilecek değerler için Android ve iOS için GDPR tarafından önerilen uygulama talimatlarına bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerinin" "satılmasını" (yasaların bu terimlerin tanımladığı şekilde) devre dışı bırakma seçeneği sunmasını gerektirir. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" bağlantısıyla sunulur. ABD eyalet gizlilik yasalarına 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 tüm reklam ağları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ırma 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 isteğinde bulunmadan önce yapmanız önerilir.

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

LiftoffMonetize.SetCCPAStatus(true);

Daha ayrıntılı bilgi ve yöntemde sağlanabilecek değerler için Android ve iOS için CCPA tarafından ö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 edin

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ından temel alınan 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 adaptörü tarafından gönderilen kodlar ve beraberindeki mesajlar şunlardır:

iOS

Hata kodu Neden
1-100 Vungle SDK'sı hata döndürdü. Daha fazla bilgi için koda bakın.
101 Kullanıcı arayüzünde yapılandırılan Liftoff Monetize sunucu parametreleri AdMob eksik/geçersiz.
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 tek seferde yalnızca 1 banner reklam yüklemeyi destekler.
106 Vungle SDK'sı, reklamın oynatılamayacağını belirten bir geri çağırma gönderdi.

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

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 sıralamaları 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 9.1.0 sürümüyle geliştirilip test edilmiştir.

Sürüm 5.0.0

Sürüm 4.0.0

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

Sürüm 3.1.3

  • 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.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 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 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 getirecek şekilde 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 bağdaştırıcısı 6.3.17.0 sürümünü destekler.
  • iOS bağdaştırıcısı 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 bağdaştırıcısı 6.2.0.3 sürümünü destekler.

Sürüm 3.0.0

  • Android bağdaştırıcısı 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 kullanı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ı 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.

Sürüm 1.1.0

  • Android bağdaştırıcısı 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 çıkış tarihi!
  • Android bağdaştırıcısı 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.