Mengintegrasikan Liftoff Monetize dengan mediasi

Pilih platform: Android (beta) Android iOS Unity Flutter

Panduan ini menunjukkan cara menggunakan GMA Next-Gen SDK untuk memuat dan menampilkan iklan dari Liftoff Monetize menggunakan mediasi 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:

Persyaratan

• 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, buka dasbor Penempatan Monetisasi Liftoff, klik tombol Tambahkan Penempatan dan pilih aplikasi Anda dari daftar drop-down.

Detail untuk menambahkan penempatan baru disertakan di bawah:

Catat ID Referensi, lalu klik Oke.

Menemukan Kunci API Pelaporan

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, buat file app-ads.txt untuk Ad Manager.

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 Ad Manager

Login ke akun Ad Manager Anda.

Menambahkan Liftoff Monetize di Perusahaan

Mengaktifkan berbagi sinyal aman

Membagikan sinyal aman pada permintaan bid

Mengizinkan berbagi sinyal aman untuk Bidding dengan SDK

Mengonfigurasi bidding Liftoff Monetize

Mengonfigurasi pemetaan unit iklan

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

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 Ad Manager.

Langkah 3: Impor Vungle SDK dan adaptor Liftoff Monetize

Integrasi Android Studio (direkomendasikan)

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

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")
}

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.

VunglePrivacySettings.setCCPAStatus(true);
LiftoffMonetizeMediationSnippets.java

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 Ad Manager dan mengaktifkan mode pengujian di UI Liftoff Monetize.

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:

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

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 berikut diisi untuk kolom NativeAd.

¹ 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:

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

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