Bu kılavuzda, hem teklifli sistem hem de şelale entegrasyonlarını kapsayan arabuluculuk kullanarak Liftoff Monetize'den reklam 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'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 bir Flutter 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.
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
- [Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek amacıyla AppLovin 5.1.0 veya sonraki sürümler için Google Mobile Ads uyumlulaştırma eklentisini kullanın (son sürüm önerilir).
- Android'de dağıtmak için
- Android API düzeyi 21 veya sonraki sürümler
- 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ış çalışan bir Flutter projesi. 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 Monetize hesabınıza kaydolun veya oturum açın.
Uygulama Ekle düğmesini tıklayarak uygulamanızı Liftoff Para Kazanma kontrol paneline ekleyin.
Gerekli tüm ayrıntıları girerek formu doldurun.
Yapay Zeka
iOS
Uygulamanız oluşturulduktan sonra Liftoff Monetize Uygulamalar 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ıyla kullanılacak yeni bir yerleşim oluşturmak için Liftoff Para Kazanma Yerleşimleri 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şim oluşturmak için sayfanın alt kısmı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 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. 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 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ü 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 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 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.
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, teklifli sistem 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 etkinleştirme
Test reklamları etkinleştirmek için Liftoff Monetize kontrol panelinize gidin 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 Yalnızca test reklamlarını göster'i seçerek Test Modu'nda etkinleştirilebilir.
Yapay Zeka
iOS
2. adım: AdMob kullanıcı arayüzünde Liftoff Monetize demand'ı ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
Yapay Zeka
Talimatlar için Android kılavuzundaki 2. adıma bakın.
iOS
Talimatlar için iOS kılavuzunun 2. adımına bakın.
Liftoff'u GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme
AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Liftoff'u eklemek için GDPR ayarlarındaki ve ABD eyalet düzenlemeleri ayarlarındaki adımları uygulayın.
3. Adım: Vungle SDK'sını ve Liftoff Monetize bağdaştırıcısını içe aktarın
pub.dev üzerinden entegrasyon
Paketinizin pubspec.yaml dosyasına Liftoff Monetize SDK'sının ve bağdaştırıcının en son sürümleriyle aşağıdaki bağımlılığı ekleyin:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
Manuel Entegrasyon
Liftoff Monetize için Google Mobil Reklamlar uyumlulaştırma eklentisinin en son sürümünü indirin, indirilen dosyayı ayıklayın ve ayıklanan eklenti klasörünü (ve içeriğini) 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ı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.
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ı ü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ımına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılar. Bu 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 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.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
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'in dokümanlarını inceleyin.
6. adım: Uygulamanızı test edin
Test reklamlarını etkinleştirme
AdMob için test cihazınızı kaydettiğinizden ve Liftoff Para Kazanma kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.
Test reklamlarını doğrulama
Liftoff Monetize'den test reklamları aldığınızı doğrulamak için Liftoff Monetize (Teklif Verme) ve Liftoff Monetize (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
Hata kodları
Adaptör, Liftoff Monetize'den reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:
Yapay Zeka
| 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ü (Teklif Verme) | 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ı (Teklif Verme) | GADMediationAdapterVungle |
| Geçiş reklamı (Şelale) | GADMAdapterVungleInterstitial |
| Ödüllü (Teklif Verme) | 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 birlikte gönderilen 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'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ılamadığına dair 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üğü
Sonraki Sürüm
- Google Mobile Ads Flutter eklentisi 5.2.0 sürümü ile oluşturulup 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 adaptörünün 7.4.0.1 sürümüyle uyumluluğu doğrulandı
- Google Mobile Ads Flutter eklentisi 5.1.0 sürümü ile oluşturulup 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 adaptörünün 7.3.2.0 sürümüyle uyumluluğu doğrulandı
- Google Mobile Ads Flutter eklentisi 5.1.0 sürümü ile oluşturulup test edilmiştir.