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 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 birFlutter uygulamasına nasıl entegre edileceği ele alınmaktadı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 |
Yerel biçim | 1 2 |
1 Bu biçim için teklifli sistem entegrasyonu açık beta sürümündedir.
2 Şelale bu biçim için entegrasyonu açık 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. 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'unuza kaydolun veya giriş yapın Hesaptan para kazanın.
Uygulamanızı Liftoff Monetize kontrol paneline ekleyin Uygulama Ekle düğmesini tıklayarak.
Gerekli tüm ayrıntıları girerek formu doldurun.
Android
iOS
Uygulamanız oluşturulduktan sonra Liftoff Monetize Applications kontrol paneli.
Android
iOS
Uygulama kimliğini not edin.
Android
iOS
Yeni yerleşimler ekleme
AdMob ile kullanılacak yeni bir yerleşim oluşturmak için uyumlulaştırmasından yararlanmak için Liftoff Monetize Yerleşimler kontrol paneli Yerleşim Ekle düğmesini tıklayın ve açılır menüden uygulamanızı seçin liste'ye dokunun.
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] Altında Para kazanma, Uygulama İçi Teklif Verme anahtarını Etkin durumuna getirin. Sayfanın altındaki Devam düğmesini tıklayarak yerleşim.
Banner
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'yi açın/kapatın Etkin durumuna getirin. Ekranın altındaki Devam düğmesini tıklayın sayfasını ziyaret ederek yerleşim oluşturabilirsiniz.
300x250 Banner
MREC'yi seçin, bir Yerleşim Adı girin ve formunu 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. Şu adreste bulunan Devam düğmesini tıklayın: sayfanın alt kısmına gidin.
Ödüllü
Ö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'yi açın/kapatın Etkin durumuna 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 altında, Uygulama İçi Teklif Verme anahtarını Etkin yapın. Devam düğmesini tıklayın. tıklayın.
Yerel biçim
Yerel'i seçin, bir Yerleşim Adı girin ve formunu doldurun. [Yalnızca teklif verme] Para kazanma bölümünde Uygulama İçi Teklif Verme anahtarını Etkin konumuna getirin. Ekranın altındaki Devam düğmesini tıklayın sayfasını ziyaret ederek yerleşim oluşturabilirsiniz.
Referans kimliğini not edin ve Tamam'ı tıklayın.
Uygulama Açma
Banner
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, teklif 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 aç
Test reklamları etkinleştirmek için Liftoff Monetize kontrol panelinize gidin ve Uygulamalar'a gidin.
Test reklamlarını etkinleştirmek istediğiniz uygulamanızı Yerleşim Referans Kimliği bölümü Test reklamları, Durum bölümünde Yalnızca test reklamlarını göster olarak Test Modu'nu seçerek.
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.
Liftoff 'i GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme
.3. Adım: Vungle SDK'sını 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, aşağıdaki bağımlılığı ekleyerek pubspec.yaml
dosyanızdaki eklentiye referans verin:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
4. adım: Liftoff Monetize SDK'sında gizlilik ayarlarını uygulayın
AB Kullanıcı Rızası ve GDPR
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 şartları Düzenleme (GDPR). 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 çağırın. Aşağıdaki örnek kodda, izin bilgilerinin Vungle SDK'sına nasıl iletileceği gösterilmektedir. Bu yöntemi çağırmayı seçerseniz Google Mobile Ads SDK'sı üzerinden reklam istemeden önce çağırmanız önerilir.
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, 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. İ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, 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 Mobil Reklamlar uyumlulaştırma eklentisi
GmaMediationLiftoffmonetize.setCCPAStatus()
yöntemini çağırın. Aşağıdaki örnek kod
. Bu yöntemi çağırmayı seçerseniz Google Mobile Ads SDK'sı üzerinden reklam istemeden önce çağırmanız önerilir.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.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
Liftoff Monetize entegrasyonu için ek kod gerekmez.
iOS
SKAdNetwork entegrasyonu
Liftoff Monetize'ın
belgeleri
kullanarak projenizin Info.plist
dosyasına SKAdNetwork tanımlayıcılarını ekleyin.
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ış 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ü (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ış Reklamı (Teklifli Sistem) | GADMediationAdapterVungle |
Uygulama açılışı (şelale) | GADMediationAdapterVungle |
Banner (Teklif Verme) | GADMediationAdapterVungle |
Banner (Şelale) | GADMAdapterVungleInterstitial |
Geçiş reklamı (Teklifli sistem) | GADMediationAdapterVungle |
Geçiş reklamı (Şelale) | GADMAdapterVungleInterstitial |
Ödüllü (Teklif) | 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 ilişkili mesajlar aşağıda verilmiştir:
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 boyutuyla eşleşmiyor. |
103 | Liftoff Monetize'ın isteği için bir Activity bağlamı olması 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'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ılamayacağını belirten 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 Flutter Uyumlulaştırma Adaptörü Değişiklik Günlüğü
Sürüm 1.1.0
- Liftoff Monetize Android adaptörünün 7.4.0.1 sürümüyle uyumluluğu doğrulandı
- LiftoffMonetize iOS bağdaştırıcının 7.4.0.1 sürümü ile uyumluluk doğrulandı
- Google Mobile Ads Flutter eklentisi 5.1.0 sürümüyle geliştirilip test edilmiştir.
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 5.1.0 sürümü ile oluşturulup test edilmiştir.