Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Liftoff Monetize menggunakan mediasi, yang mencakup integrasi bidding dan waterfall. Panduan ini membahas cara menambahkan Monetisasi Liftoff ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan SDK dan adaptor Vungle ke aplikasiFlutter .
Integrasi dan format iklan yang didukung
| Integrasi | |
|---|---|
| Bidding | 1 |
| Air Terjun | |
| Format | |
| Membuka Aplikasi | 2 |
| Banner | |
| Interstisial | |
| Reward | |
| Interstisial Reward | |
| Native | 2 |
1 Integrasi bidding berada dalam versi beta terbuka.
2 Integrasi waterfall untuk format ini masih dalam versi beta terbuka.
Persyaratan
- Google Mobile Ads SDK terbaru
- Flutter 3.7.0 atau yang lebih tinggi
- Untuk men-deploy di Android
- Android API level 21 atau yang lebih tinggi
- Untuk men-deploy di iOS
- Target deployment iOS 12.0 atau yang lebih tinggi
- Project Flutter yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK. Lihat Memulai untuk mengetahui detailnya.
- Selesaikan Panduan memulai mediasi
Langkah 1: Siapkan konfigurasi di UI Monetisasi Liftoff
Daftar atau login ke akun Liftoff Monetize Anda.
Tambahkan aplikasi Anda ke dasbor Monetisasi Liftoff dengan mengklik tombol Tambahkan Aplikasi.
Isi formulir dengan memasukkan semua detail yang diperlukan.
Android
iOS
Setelah aplikasi dibuat, pilih aplikasi dari dasbor Aplikasi Liftoff Monetize.
Android
iOS
Catat ID Aplikasi.
Android
iOS
Menambahkan penempatan baru
Untuk membuat penempatan baru yang akan digunakan dengan mediasi AdMob, buka dasbor Monetisasi Penempatan Liftoff, klik tombol Tambahkan Penempatan, lalu pilih aplikasi Anda dari daftar drop-down.
Detail untuk menambahkan penempatan baru disertakan di bawah ini:
Membuka Aplikasi
Pilih Interstisial, lalu masukkan Nama Penempatan. Kemudian, pilih Ya untuk Dapat dilewati dan isi formulir lainnya. [Khusus bidding] Di bagian Monetisasi, alihkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.
Banner
Pilih Banner, masukkan Nama Penempatan, lalu isi kolom lainnya. [Khusus bidding] Di bagian Monetisasi, alihkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.
Banner 300x250
Pilih MREC, masukkan Nama Penempatan, lalu isi kolom lainnya. [Khusus bidding] Di bagian Monetisasi, alihkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.
Interstisial
Pilih Interstisial, masukkan Nama Penempatan, lalu isi bagian lainnya dari formulir. [Khusus bidding] Di bagian Monetisasi, alihkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.
Reward
Pilih Rewarded, masukkan Placement Name, lalu isi kolom lainnya. [Khusus bidding] Di bagian Monetisasi, alihkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.
Interstisial Reward
Pilih Berhadiah. Masukkan Nama Penempatan, aktifkan Dapat Dilewati, lalu isi formulir lainnya. [Khusus bidding] Di bagian Monetisasi, alihkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.
Native
Pilih Native, masukkan Placement Name, lalu isi kolom lainnya dalam formulir. [Khusus bidding] Di bagian Monetisasi, alihkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.
Catat ID Referensi, lalu klik Oke.
Membuka Aplikasi
Banner
Banner 300x250
Interstisial
Reward
Interstisial Reward
Native
Menemukan Kunci API Pelaporan
Bidding
Langkah ini tidak diperlukan untuk integrasi bidding.
Air Terjun
Selain ID Aplikasi dan ID Referensi, Anda juga memerlukan Kunci Reporting API Liftoff Monetize untuk menyiapkan ID unit iklan AdMob. Buka dasbor Laporan Monetisasi Liftoff, lalu klik tombol Kunci Reporting API untuk melihat Kunci Reporting API Anda.
Mengaktifkan mode pengujian
Untuk mengaktifkan iklan pengujian, buka dasbor Liftoff Monetize dan buka Aplikasi.
Pilih aplikasi yang iklan percobaannya ingin Anda aktifkan di bagian ID Referensi Penempatan aplikasi Anda. Iklan percobaan dapat diaktifkan dengan memilih Mode Pengujian ke Tampilkan iklan percobaan saja di bagian Status.
Android
iOS
Langkah 2: Siapkan permintaan Monetisasi Liftoff di Ad Manager UI
Mengonfigurasi setelan mediasi untuk unit iklan
Android
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk Android.
iOS
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk iOS.
Menambahkan Liftoff ke daftar partner iklan GDPR dan peraturan negara bagian AS
Ikuti langkah-langkah di setelan GDPR dan setelan peraturan negara bagian AS untuk menambahkan Liftoff ke daftar partner iklan GDPR dan peraturan negara bagian AS di UI AdMob.
Langkah 3: Impor Vungle SDK dan adaptor Monetisasi Liftoff
Integrasi melalui pub.dev
Tambahkan dependensi berikut dengan versi terbaru
Liftoff Monetize SDK dan adaptor dalam file
pubspec.yaml paket Anda:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
Integrasi Manual
Download plugin mediasi Google Mobile Ads versi terbaru untuk
Liftoff Monetize,
ekstrak file yang didownload, dan tambahkan folder plugin yang diekstrak
(dan kontennya) ke project Flutter Anda. Kemudian, referensikan plugin di
file pubspec.yaml dengan menambahkan dependensi berikut:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
Langkah 4: Terapkan setelan privasi di Liftoff Monetize SDK
Izin Uni Eropa dan GDPR
Berdasarkan Kebijakan Izin Pengguna Uni Eropa Google, Anda harus memastikan bahwa pengungkapan tertentu diberikan kepada, dan izin diperoleh dari, pengguna di Wilayah Ekonomi Eropa (EEA) terkait penggunaan ID perangkat dan data pribadi. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Regulation (GDPR) Uni Eropa. Saat meminta izin, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi yang dapat mengumpulkan, menerima, atau menggunakan data pribadi dan memberikan informasi tentang penggunaan setiap jaringan. Saat ini, Google tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.
Plugin mediasi Google Mobile Ads untuk Liftoff Monetize menyertakan
metode GmaMediationLiftoffmonetize.setGDPRStatus(). Kode contoh berikut
menunjukkan cara meneruskan informasi izin ke Vungle SDK. Jika Anda memilih untuk
memanggil metode ini, sebaiknya panggil metode ini sebelum meminta iklan melalui
Google Mobile Ads SDK.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
Lihat petunjuk penerapan yang direkomendasikan GDPR untuk Android dan iOS untuk mengetahui detail selengkapnya dan nilai yang dapat diberikan dalam metode.
Hukum privasi negara bagian Amerika Serikat
Hukum privasi negara bagian Amerika Serikat mewajibkan perusahaan tersebut untuk memberikan hak kepada pengguna untuk memilih tidak ikut "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan oleh hukum), dengan pilihan tidak ikut yang disediakan melalui link "Jangan Jual Informasi Pribadi Saya" yang terlihat jelas di halaman beranda pihak "penjual". Panduan kepatuhan terhadap hukum privasi negara bagian Amerika Serikat menawarkan kemampuan untuk mengaktifkan pemrosesan data yang dibatasi untuk penayangan iklan Google, tetapi Google tidak dapat menerapkan setelan ini ke setiap jaringan iklan dalam rantai mediasi Anda. Oleh karena itu, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi yang dapat berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.
Plugin mediasi Google Mobile Ads untuk Liftoff Monetize menyertakan
metode GmaMediationLiftoffmonetize.setCCPAStatus(). Kode contoh berikut
menunjukkan cara meneruskan informasi izin ke Vungle SDK. Jika Anda memilih untuk
memanggil metode ini, sebaiknya panggil metode ini sebelum meminta iklan melalui
Google Mobile Ads SDK.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setCCPAStatus(true);
Lihat petunjuk penerapan yang direkomendasikan CCPA untuk Android dan iOS guna mengetahui detail selengkapnya dan nilai yang dapat diberikan dalam metode.
Langkah 5: Tambahkan kode yang diperlukan
Android
Tidak diperlukan kode tambahan untuk integrasi Monetisasi Liftoff.
iOS
Integrasi SKAdNetwork
Ikuti dokumentasi
Liftoff Monetize
untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.
Langkah 6: Uji penerapan Anda
Mengaktifkan iklan pengujian
Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob dan mengaktifkan mode pengujian di UI Monetisasi Liftoff.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan pengujian dari Liftoff Monetize, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan Liftoff Monetize (Bidding) dan Liftoff Monetize (Waterfall).
Kode error
Jika adaptor gagal menerima iklan dari Monetisasi Liftoff, penayang dapat
memeriksa error yang mendasarinya dari respons iklan menggunakan
ResponseInfo di bawah class berikut:
Android
| Format | Nama kelas |
|---|---|
| Layar Pembuka Aplikasi (Bidding) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Layar Pembuka Aplikasi (Waterfall) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Banner (Bidding) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Banner (Waterfall) | com.vungle.mediation.VungleInterstitialAdapter |
| Interstisial (Bidding) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Interstisial (Waterfall) | com.vungle.mediation.VungleInterstitialAdapter |
| Reward (Bidding) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Reward (Waterfall) | com.vungle.mediation.VungleAdapter |
| Interstisial Reward (Bidding) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Interstisial Reward (Waterfall) | com.google.ads.mediation.vungle.VungleMediationAdapter |
iOS
| Format | Nama kelas |
|---|---|
| Layar Pembuka Aplikasi (Bidding) | GADMediationAdapterVungle |
| Layar Pembuka Aplikasi (Waterfall) | GADMediationAdapterVungle |
| Banner (Bidding) | GADMediationAdapterVungle |
| Banner (Waterfall) | GADMAdapterVungleInterstitial |
| Interstisial (Bidding) | GADMediationAdapterVungle |
| Interstisial (Waterfall) | GADMAdapterVungleInterstitial |
| Reward (Bidding) | GADMediationAdapterVungle |
| Reward (Waterfall) | GADMAdapterVungleRewardBasedVideoAd |
| Interstisial Reward (Bidding) | GADMediationAdapterVungle |
| Interstisial Reward (Waterfall) | GADMediationAdapterVungle |
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor Monetisasi Liftoff saat iklan gagal dimuat:
Android
| Kode error | Alasan |
|---|---|
| 101 | Parameter server tidak valid (misalnya, ID aplikasi atau ID penempatan). |
| 102 | Ukuran banner yang diminta tidak dipetakan ke ukuran iklan Liftoff Monetize yang valid. |
| 103 | Liftoff Monetize memerlukan konteks Activity untuk meminta
iklan. |
| 104 | Vungle SDK tidak dapat memuat beberapa iklan untuk ID penempatan yang sama. |
| 105 | Vungle SDK gagal diinisialisasi. |
| 106 | Vungle SDK menampilkan callback pemuatan yang berhasil, tetapi Banners.getBanner() atau Vungle.getNativeAd() menampilkan null. |
| 107 | Vungle SDK belum siap memutar iklan. |
| 108 | Vungle SDK menampilkan token bidding yang tidak valid. |
iOS
| Kode error | Alasan |
|---|---|
| 101 | Parameter server tidak valid (misalnya, ID aplikasi atau ID penempatan). |
| 102 | Iklan sudah dimuat untuk konfigurasi jaringan ini. Vungle SDK tidak dapat memuat iklan kedua untuk ID penempatan yang sama. |
| 103 | Ukuran iklan yang diminta tidak sesuai dengan ukuran banner yang didukung Monetisasi Liftoff. |
| 104 | Vungle SDK tidak dapat merender iklan banner. |
| 105 | Vungle SDK hanya mendukung pemuatan 1 iklan banner dalam satu waktu, terlepas dari ID penempatan. |
| 106 | Vungle SDK mengirim callback yang menyatakan bahwa iklan tidak dapat diputar. |
| 107 | Vungle SDK belum siap memutar iklan. |
Untuk error yang berasal dari Vungle SDK, lihat Kode Error: Vungle SDK untuk iOS dan Android.
Log Perubahan Adaptor Mediasi Flutter Liftoff Monetize
Versi Berikutnya
- Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.2.0.
Versi 1.1.0
- Kompatibilitas terverifikasi dengan adaptor Android Monetisasi Liftoff versi 7.4.0.1
- Kompatibilitas terverifikasi dengan adaptor iOS LiftoffMonetize versi 7.4.0.1
- Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.1.0.
Versi 1.0.0
- Rilis awal.
- Kompatibilitas terverifikasi dengan adaptor Android Monetisasi Liftoff versi 7.3.1.0
- Kompatibilitas terverifikasi dengan adaptor iOS LiftoffMonetize versi 7.3.2.0
- Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.1.0.