Mengintegrasikan Liftoff Monetize dengan mediasi

Pilih platform: Android (beta) Android iOS Unity Flutter

Catatan: Vungle kini menjadi Liftoff Monetize.

Panduan ini menunjukkan cara menggunakan GMA Next-Gen SDK untuk memuat dan menampilkan iklan dari Liftoff Monetize menggunakan Mediasi AdMob yang mencakup integrasi bidding dan waterfall. Panduan ini mencakup cara menambahkan Liftoff Monetize ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan Vungle SDK dan adaptor ke dalam aplikasi Android.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk Liftoff Monetize memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Membuka Aplikasi
Banner
Interstisial
Reward
Interstisial Reward
Native

Persyaratan

Level API Android 24 atau yang lebih tinggi

[Untuk bidding]: Untuk mengintegrasikan semua format iklan yang didukung dalam bidding, gunakan adaptor Liftoff Monetize 7.3.0.0 atau yang lebih tinggi (direkomendasikan versi terbaru)

• GMA Next-Gen SDK terbaru.

• Selesaikan Panduan memulai mediasi.

Langkah 1: Siapkan konfigurasi di UI Monetize 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.

Setelah aplikasi Anda dibuat, pilih aplikasi Anda dari dasbor Aplikasi Monetisasi Liftoff.

Catat ID Aplikasi.

Menambahkan penempatan baru

Untuk membuat penempatan baru yang akan digunakan dengan Mediasi AdMob, buka dasbor Penempatan Monetisasi Liftoff, klik tombol Tambahkan Penempatan dan pilih aplikasi Anda dari daftar drop-down.

Catatan: Meskipun Liftoff Monetize otomatis membuat penempatan "default" saat Anda pertama kali membuat aplikasi, sebaiknya buat penempatan baru untuk mediasi dengan AdMob.

Detail untuk menambahkan penempatan baru disertakan di bawah:

Membuka Aplikasi

Pilih Interstitial dan masukkan Nama Penempatan. Kemudian, pilih Ya untuk Dapat dilewati dan isi bagian formulir lainnya. [Khusus bidding] Di bagian Monetisasi, aktifkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.

Banner

Pilih Banner, masukkan Nama Penempatan, dan isi formulir lainnya. [Khusus Bidding] Di bagian Monetisasi, aktifkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.

Banner 300x250

Pilih MREC, masukkan Nama Penempatan, dan isi formulir lainnya. [Khusus Bidding] Di bagian Monetisasi, aktifkan 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 formulir lainnya. [Khusus Bidding] Di bagian Monetisasi, aktifkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.

Reward

Pilih Rewarded, masukkan Nama Penempatan, lalu isi formulir lainnya. [Khusus Bidding] Di bagian Monetisasi, aktifkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.

Interstisial Reward

Catatan: Iklan interstisial yang di-reward memerlukan bantuan untuk penyiapannya. Hubungi Account Manager Anda di Liftoff Monetize atau [e-mail].

Pilih Bonus. Masukkan Nama Penempatan, aktifkan Dapat Dilewati, dan isi bagian formulir lainnya. [Khusus bidding] Di bagian Monetisasi, alihkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.

Penting: Untuk iklan interstisial bersedia menonton, waktu dapat dilewati tidak boleh 0. Hubungi Account Manager Liftoff Monetize Anda untuk menyesuaikannya.

Native

Pilih Native, masukkan Nama Penempatan, lalu isi formulir lainnya. [Khusus Bidding] Di bagian Monetisasi, aktifkan tombol Bidding Dalam Aplikasi ke Aktif. Klik tombol Lanjutkan di bagian bawah halaman untuk membuat penempatan.

Catatan: Tombol Bidding Dalam Aplikasi tidak tersedia untuk iklan native secara default. Untuk mengaktifkannya, hubungi Account Manager Liftoff Monetize Anda.

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 API Pelaporan Liftoff Monetize untuk menyiapkan ID unit iklan AdMob. Buka dasbor Laporan Liftoff Monetize, lalu klik tombol Reporting API Key untuk melihat Reporting API Key Anda.

Memperbarui app-ads.txt

Authorized Sellers for Apps app-ads.txt adalah inisiatif IAB Tech Lab yang membantu memastikan inventaris iklan aplikasi Anda hanya dijual melalui saluran yang telah Anda identifikasi sebagai resmi. Untuk mencegah kerugian pendapatan iklan yang signifikan, Anda harus menerapkan file app-ads.txt. Jika Anda belum melakukannya, siapkan file app-ads.txt untuk aplikasi Anda.

Untuk menerapkan app-ads.txt untuk Liftoff Monetize, download dan tambahkan entri app-ads.txt Liftoff Monetize ke file app-ads.txt yang ada. Untuk informasi selengkapnya, lihat app-ads.txt.

Mengaktifkan mode pengujian

Untuk mengaktifkan iklan percobaan, buka dasbor Liftoff Monetize Anda dan buka Aplikasi.

Pilih aplikasi yang ingin Anda aktifkan iklan percobaannya di bagian ID Referensi Penempatan aplikasi Anda. Iklan percobaan dapat diaktifkan dengan memilih Mode Pengujian ke Tampilkan iklan percobaan saja di bagian Status.

Langkah 2: Siapkan permintaan Liftoff Monetize di UI AdMob

Mengonfigurasi setelan mediasi untuk unit iklan

Anda perlu menambahkan Liftoff Monetize ke konfigurasi mediasi untuk unit iklan Anda.

Pertama, login ke akun AdMob Anda. Selanjutnya, buka tab Mediasi. Jika Anda memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, lalu lanjutkan ke Menambahkan Liftoff Monetize sebagai sumber iklan.

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.

Beri nama grup mediasi Anda, lalu pilih lokasi yang akan ditargetkan. Selanjutnya, tetapkan status grup mediasi ke Diaktifkan, lalu klik Tambahkan Unit Iklan.

Kaitkan grup mediasi ini dengan satu atau beberapa unit iklan AdMob yang ada. Kemudian, klik Done.

Sekarang Anda akan melihat kartu unit iklan yang diisi dengan unit iklan yang Anda pilih:

Menambahkan Liftoff Monetize sebagai sumber iklan

Bidding

Di bagian Sumber Iklan, di kartu Bidding, pilih Tambahkan sumber iklan. Kemudian, pilih Liftoff Monetize .

Klik Cara menandatangani perjanjian kemitraan dan siapkan kemitraan bidding dengan Liftoff Monetize.



Klik Pahami & setujui, lalu klik Lanjutkan.



Jika sudah memiliki pemetaan untuk Liftoff Monetize, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.



Selanjutnya, masukkan ID Aplikasi dan ID Referensi Penempatan yang diperoleh di bagian sebelumnya. Kemudian, klik Selesai.

Penting: ID Aplikasi harus dikaitkan dengan aplikasi target seperti di UI Monetisasi Liftoff.

Air Terjun

Di bagian kartu Waterfall di bagian Sumber Iklan, pilih Tambahkan Sumber Iklan.

Pilih Liftoff Monetize dan aktifkan tombol Optimize. Masukkan Kunci API Pelaporan yang diperoleh di bagian sebelumnya untuk menyiapkan pengoptimalan sumber iklan untuk Liftoff Monetize. Kemudian, masukkan nilai eCPM untuk Liftoff Monetize, lalu klik Lanjutkan.

Catatan: Anda hanya perlu menyiapkan pengoptimalan sumber iklan satu kali per jaringan.

Jika sudah memiliki pemetaan untuk Liftoff Monetize, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.

Selanjutnya, masukkan ID Aplikasi dan ID Referensi Penempatan yang diperoleh di bagian sebelumnya. Kemudian, klik Selesai.

Penting: ID Aplikasi harus dikaitkan dengan aplikasi yang ditargetkan seperti di UI Monetisasi Liftoff.

Catatan: Pengoptimalan sumber iklan memerlukan waktu beberapa hari untuk mengumpulkan data yang cukup guna menghitung eCPM secara akurat untuk jaringan mediasi. Sementara itu, status pengoptimalan sumber iklan adalah PENDING, jadi Anda harus menetapkan nilai eCPM secara manual untuk jaringan. Setelah eCPM dapat dihitung, sumber iklan akan otomatis mulai memperbarui eCPM atas nama Anda.

Menambahkan Liftoff ke daftar partner iklan GDPR dan peraturan negara bagian Amerika Serikat

Penting: Pastikan Anda memiliki izin Pengelolaan Akun untuk menyelesaikan konfigurasi untuk Izin dan GDPR Uni Eropa, peraturan Negara Bagian AS, dan Platform Pesan Pengguna. Lihat Mengelola akses pengguna ke akun Anda untuk mengetahui detailnya.

Ikuti langkah-langkah di Setelan peraturan Eropa dan Setelan peraturan negara bagian AS untuk menambahkan Liftoff ke daftar partner iklan peraturan Eropa dan negara bagian AS di UI AdMob.

Langkah 3: Impor Vungle SDK dan adaptor Liftoff Monetize

Catatan: Kegagalan mengintegrasikan versi SDK Vungle dan Google Mobile Ads yang kompatibel dapat menyebabkan masalah build.

Integrasi Android Studio (direkomendasikan)

Dalam file gradle level aplikasi, tambahkan implementasi dependencies dan konfigurasi berikut:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:vungle:7.7.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:vungle:7.7.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integrasi manual

• Download Vungle Android SDK terbaru dan ekstrak file .aar dan JAR di folder libs, lalu tambahkan ke project Anda.

• Buka artefak adapter Liftoff Monetize di Repositori Maven Google. Pilih versi terbaru, download file .aar adapter Vungle, lalu tambahkan ke project Anda.

Langkah 4: Terapkan setelan privasi di Vungle SDK

Izin Uni Eropa dan GDPR

Untuk mematuhi Kebijakan Izin Pengguna Uni Eropa Google, Anda harus membuat pengungkapan tertentu kepada pengguna di Wilayah Ekonomi Eropa (EEA), Inggris Raya, dan Swiss, serta mendapatkan izin mereka untuk penggunaan cookie atau penyimpanan lokal lainnya jika diwajibkan secara hukum, dan untuk pengumpulan, pembagian, serta penggunaan data pribadi untuk personalisasi iklan. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Regulation (GDPR) Uni Eropa. Anda bertanggung jawab untuk memverifikasi bahwa izin diteruskan ke setiap sumber iklan dalam rantai mediasi Anda. Google tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.

Mulai Vungle SDK versi 7.4.1, Liftoff Monetize secara otomatis membaca izin GDPR yang ditetapkan oleh platform pengelolaan izin yang mendukung spesifikasi Izin Tambahan Google, termasuk UMP SDK. Untuk mengetahui informasi selengkapnya, lihat Petunjuk Penerapan yang Direkomendasikan untuk GDPR.

Hukum privasi negara bagian Amerika Serikat

Hukum privasi negara bagian AS mewajibkan pemberian 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 rangkaian mediasi yang mungkin berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

Liftoff Monetize menyertakan API yang memungkinkan Anda meneruskan izin ke Vungle SDK. Contoh kode berikut menunjukkan cara meneruskan informasi izin ini ke Vungle SDK. Jika Anda memilih untuk memanggil metode ini, sebaiknya Anda melakukannya sebelum meminta iklan melalui GMA Next-Gen SDK.

Java

VunglePrivacySettings.setCCPAStatus(true);
LiftoffMonetizeMediationSnippets.java

Kotlin

VunglePrivacySettings.setCCPAStatus(true)
LiftoffMonetizeMediationSnippets.kt

Lihat penerapan CCPA untuk mengetahui detail selengkapnya dan nilai yang dapat diberikan dalam metode ini.

Langkah 5: Tambahkan kode yang diperlukan

Tidak ada kode tambahan yang diperlukan untuk integrasi Liftoff Monetize.

Langkah 6: Uji penerapan Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob dan mengaktifkan mode pengujian di UI Monetize Liftoff.

Penting: Nonaktifkan mode pengujian untuk AdMob dan Liftoff Monetize sebelum merilis aplikasi Anda.

Memverifikasi iklan percobaan

Untuk memverifikasi bahwa Anda menerima iklan percobaan dari Liftoff Monetize, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan Liftoff Monetize (Bidding) dan Liftoff Monetize (Waterfall).

Langkah opsional

Parameter khusus jaringan

Adaptor Monetisasi Liftoff mendukung parameter permintaan tambahan berikut yang dapat diteruskan ke adaptor:

userId

String yang merepresentasikan ID Pengguna Insentif Liftoff Monetize.

adOrientation

Integer yang menentukan orientasi presentasi untuk iklan layar penuh.

setBackButtonImmediatelyEnabled

Boolean untuk mengaktifkan atau menonaktifkan tombol kembali pada iklan di Layar Pembuka Aplikasi secara langsung. Setel ke true untuk segera mengaktifkan tombol kembali, atau false. Defaultnya adalah false. Lihat dokumentasi Liftoff Monetize tentang cara mengintegrasikan iklan pembuka aplikasi untuk mengetahui info selengkapnya.

Berikut adalah contoh kode cara membuat permintaan iklan yang menetapkan parameter ini:

Java

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true);

AdRequest request =
    new AdRequest.Builder()
        .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
        .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
        // App Open ads use VungleMediationAdapter
        .addNetworkExtrasBundle(VungleMediationAdapter.class, extras)
        .build();
LiftoffMonetizeMediationSnippets.java

Kotlin

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true)

val request =
  AdRequest.Builder()
    .addNetworkExtrasBundle(VungleAdapter::class.java, extras) // Rewarded.
    .addNetworkExtrasBundle(VungleInterstitialAdapter::class.java, extras) // Interstitial.
    // App Open ads use VungleMediationAdapter
    .addNetworkExtrasBundle(VungleMediationAdapter::class.java, extras)
    .build()
LiftoffMonetizeMediationSnippets.kt

Rendering iklan native

Adaptor Liftoff Monetize menampilkan iklan native-nya sebagai objek NativeAd. Kolom ini akan mengisi deskripsi kolom iklan native untuk NativeAd.

Kolom	Aset yang selalu disertakan oleh adaptor Liftoff Monetize
Judul
Gambar	1
Tampilan media
Isi
Ikon aplikasi
Pesan ajakan (CTA)
Rating bintang
Toko
Harga

¹ Adaptor Liftoff Monetize tidak memberikan akses langsung ke aset gambar utama untuk iklan native-nya. Sebagai gantinya, adaptor mengisi MediaView dengan video atau gambar.

Kode error

Jika adaptor gagal menerima iklan dari Liftoff Monetize, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo.getAdSourceResponses() di bawah class berikut:

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
Native (Bidding)	com.google.ads.mediation.vungle.VungleMediationAdapter
Native (Waterfall)	com.google.ads.mediation.vungle.VungleMediationAdapter

Berikut adalah kode dan pesan yang ditampilkan oleh adaptor Liftoff Monetize saat iklan gagal dimuat:

Kode error	Domain	Alasan
101	com.google.ads.mediation.vungle	Parameter server tidak valid (misalnya, ID aplikasi atau ID penempatan).
102	com.google.ads.mediation.vungle	Ukuran banner yang diminta tidak dipetakan ke ukuran iklan Liftoff Monetize yang valid.
103	com.google.ads.mediation.vungle	Liftoff Monetize memerlukan konteks Activityuntuk meminta iklan.
104	com.google.ads.mediation.vungle	Vungle SDK tidak dapat memuat beberapa iklan untuk ID penempatan yang sama.
105	com.google.ads.mediation.vungle	SDK Vungle gagal diinisialisasi.
106	com.google.ads.mediation.vungle	SDK Vungle menampilkan callback pemuatan yang berhasil, tetapi Banners.getBanner() atau Vungle.getNativeAd() menampilkan null.
107	com.google.ads.mediation.vungle	SDK Vungle belum siap memutar iklan.
108	com.google.ads.mediation.vungle	SDK Vungle menampilkan token bidding yang tidak valid.

Untuk error yang berasal dari Vungle SDK, lihat Kode Error: Vungle SDK untuk iOS dan Android.