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

Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl Liftoff Monetize'daki reklamları kullanarak uyumlulaştırma özellikleri şelale entegrasyonları. Bu, Liftoff Monetize'ın bir reklam biriminin ve Vungle SDK ile bağdaştırıcısının bir kampanyaya nasıl entegre edileceği Flutter uygulamasını kullanın.

Desteklenen entegrasyonlar ve reklam biçimleri

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

1 Teklifli sistem bu biçim için entegrasyonu kapalı beta sürümündedir.

2 Teklifli sistem bu biçim için entegrasyonu açık beta sürümündedir.

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

Şartlar

  • En son Google Mobile Ads SDK'sı
  • Flutter 3.7.0 veya sonraki sürümler
  • Android'de dağıtmak için
    • Android API düzeyi 21 veya üstü
  • 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ış Flutter çalışan bir proje. Görüntüleyin Ayrıntılı bilgi için Başlarken.
  • Arabuluculuğu tamamlama Başlangıç kılavuzu

1. adım: Liftoff Monetize kullanıcı arayüzünde yapılandırmaları ayarlayın

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

pub.dev aracılığıyla entegrasyon

Aşağıdaki bağımlılığı Liftoff Monetize Paketinizdeki SDK ve bağdaştırıcı pubspec.yaml dosyası:

dependencies:
  gma_mediation_liftoffmonetize: ^1.0.0

Manuel Entegrasyon

Şu hesap için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin: Liftoff Monetize indirilen dosyayı çıkarın ve ayıklanan eklenti klasörünü ekleyin. (ve içeriklerini) Flutter projenize ekleyin. Ardından, pubspec.yaml dosyasını yüklemek için şu bağımlılığı ekleyin:

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

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

Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.

Liftoff Monetize için Google Mobil Reklamlar uyumlulaştırma eklentisi GmaMediationLiftoffmonetize.setGDPRStatus() yöntemini içerir. Aşağıdaki örnek kod . Bir bu yöntemi çağırdığınızda, Google Mobile Ads SDK'sı.

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");

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, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.

Liftoff Monetize için Google Mobil Reklamlar uyumlulaştırma eklentisi GmaMediationLiftoffmonetize.setCCPAStatus() yöntemini çağırın. Aşağıdaki örnek kod . Bir bu yöntemi çağırdığınızda, Google Mobile Ads SDK'sı.

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setCCPAStatus(true);

Şunlar için CCPA tarafından önerilen uygulama talimatlarını inceleyin: Daha fazla ayrıntı için Android ve iOS yöntemde eklenebilecek değerleri ifade eder.

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'in dokümanlarını inceleyin.

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 reklam yanıtındaki temel hatayı kontrol etmek için ResponseInfo (aşağıdaki sınıflarda):

Android

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

Liftoff Monetize tarafından oluşturulan kodlar ve beraberindeki mesajlar bağdaştırıcısını kontrol etmek için aşağıdaki adımları uygulayın:

Android

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ıyla eşleşmiyor seçin.
103 Liftoff Monetize'ın isteği için Activity bağlamı gerekir. reklam.
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 başarılı bir yükleme geri çağırması döndürdü, ancak Banners.getBanner() veya Vungle.getNativeAd() 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 istekle eşleşmiyor banner boyutu.
104 Vungle SDK'sı banner reklamı oluşturamadı.
105 Vungle SDK'sı aynı anda yalnızca 1 banner reklam yüklemeyi destekler. yerleşim kimliği.
106 Vungle SDK'sı, reklamın oynatılamayacağını belirten 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 Flutter Uyumlulaştırma Bağdaştırıcısı Değişiklik Günlüğü

Sürüm 1.0.0

  • İlk sürüm.
  • Liftoff Monetize Android adaptörünün 7.3.1.0 sürümüyle uyumluluğu doğrulandı
  • LiftoffMonetize iOS bağdaştırıcının 7.3.2.0 sürümü ile uyumluluk doğrulandı
  • Google Mobile Ads Flutter Eklentisi sürüm 5.1.0 ile geliştirilmiş ve test edilmiştir.