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 birFlutter uygulamaya entegre edilmesi 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.
Bu biçim için 2 şelale 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ğıtım yapmak için
- Android API düzeyi 21 veya sonraki sürümler
- 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ış Flutter çalışan bir 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 kontrol paneline ekleyin.
Gerekli tüm bilgileri girerek formu doldurun.
Yapay Zeka
iOS
Uygulamanız oluşturulduktan sonra Liftoff Monetize Applications kontrol panelinden uygulamanızı seçin.
Yapay Zeka
iOS
Uygulama kimliğini not edin.
Yapay Zeka
iOS
Yeni yerleşimler ekleme
AdMob uyumlulaştırması ile kullanılacak yeni bir yerleşim oluşturmak için Liftoff Monetize anlaşılır 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 bölümünde, Uygulama İçi Teklif Verme anahtarını Etkin konumuna getirin. Yerleşimi oluşturmak için sayfanın altındaki Devam düğmesini tıklayın.
Banner
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.
300x250 Banner
MREC'yi 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ı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. Yerleşim oluşturmak için sayfanın alt kısmındaki Devam düğmesini tıklayın.
Ö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 anahtarı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 özelliğini 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 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ındaki Devam düğmesini tıklayın.
Referans Kimliği'ni not edin ve Sesler İyi'yi tıklayın.
Uygulama Açma
Banner
300x250 Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı
Yerel biçim
Reporting API 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ğine ve Referans Kimliğine ek olarak 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ı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ünde Test Modu'nu Yalnızca test reklamlarını göster olarak seçilerek etkinleştirilebilir.
Yapay Zeka
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
AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Liftoff'u eklemek için GDPR ayarları ve ABD eyalet düzenlemeleri ayarlarında belirtilen adımları uygulayın.
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, 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'da gizlilik ayarlarını uygulayın
AB Kullanıcı Rızası ve GDPR
Google AB Kullanıcı Rızası Politikası uyarınca, cihaz tanımlayıcılarını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) şartlarını 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 bir 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 Mobil Reklamlar uyumlulaştırma eklentisi GmaMediationLiftoffmonetize.setGDPRStatus() yöntemini 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 Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce bu yöntemi çağırmanız önerilir.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
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ışı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 Mobil Reklamlar uyumlulaştırma eklentisi GmaMediationLiftoffmonetize.setCCPAStatus() yöntemini içerir. Aşağıdaki örnek kod, izin bilgilerinin Vungle SDK'ya nasıl iletileceğini göstermektedir. Bu yöntemi çağırmayı seçerseniz Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce bu yöntemi çağırmanız önerilir.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.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
Yapay Zeka
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:
Yapay Zeka
| 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ı (Teklifli sistem) | 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ı (Teklifli Sistem) | 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ü (Teklifli Sistem) | GADMediationAdapterVungle |
| Ödüllü (Şelale) | GADMAdapterVungleRewardBasedVideoAd |
| Ödüllü Geçiş Reklamı (Teklifli Sistem) | 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:
Yapay Zeka
| 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, 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, 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. |
| 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 Bağdaştırıcısı Değişiklik Günlüğü
Sonraki Sürüm
- Google Mobile Ads Flutter Eklentisi sürüm 5.2.0 ile geliştirilmiş ve test edilmiştir.
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 bağdaştırıcısı sürüm 7.3.1.0 ile uyumluluk 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üyle geliştirilip test edilmiştir.