Alat pratinjau dan penayangan materi iklan

Panduan ini menunjukkan cara men-debug penayangan iklan menggunakan pratinjau dalam aplikasi dan alat penayangan Ad Manager.

Pratinjau dalam aplikasi memungkinkan Anda memeriksa materi iklan Anda sendiri yang dirender dalam aplikasi seluler Anda. Pratinjau ini sangat berguna jika Anda memiliki materi iklan yang berinteraksi dengan aplikasi, memiliki perilaku unik, atau mengandalkan aplikasi untuk beberapa rendering (termasuk materi iklan native dan MRAID).

Alat penayangan Ad Manager memberikan informasi tentang iklan yang ditayangkan. Jadi, jika iklan yang tidak diharapkan ditayangkan, gunakan alat penayangan untuk mengetahui alasannya.

Prasyarat

Menyiapkan aplikasi

Proses debug memerlukan interaksi dengan menu opsi debug SDK. Cara yang direkomendasikan untuk membuka menu ini adalah dengan menyertakan fungsi berikut di aplikasi Anda, dan memicunya berdasarkan tindakan pengguna:

Kotlin

// Opens a debug menu. Call this method based on a user action.
// Pass any Ad Manager ad unit ID associated with the app that you want to debug.
MobileAds.openDebugMenu(activity, "AD_UNIT_ID")

Java

// Opens a debug menu. Call this method based on a user action.
// Pass any Ad Manager ad unit ID associated with the app that you want to debug.
MobileAds.openDebugMenu(activity, "AD_UNIT_ID");

Unit iklan valid dari akun Ad Manager Anda sudah cukup untuk membuka menu opsi debug.

Cara lain untuk membuka menu ini adalah dengan melakukan tekanan dua jari yang lama pada materi iklan, tetapi cara ini tidak berfungsi untuk semua format iklan, seperti iklan native, dan Anda harus berhati-hati agar tidak mengklik iklan saat mencoba menggeser. Memanggil metode sebelumnya jauh lebih efektif.

Setelah menambahkan kemampuan untuk membuka menu opsi debug, jalankan aplikasi Anda dan picu fungsi tersebut. Menu berikut akan terbuka:

Pilih Creative Preview untuk menautkan perangkat Anda. Browser akan terbuka dan otomatis mengarahkan Anda ke browser untuk login ke Ad Manager. Setelah login, beri nama perangkat Anda untuk mendaftarkannya ke akun Ad Manager Anda. Kemudian, klik Verify.

Pada tahap ini, Anda dapat memverifikasi bahwa perangkat Anda telah ditautkan di Ad Manager UI. Anda juga dapat mengizinkan orang lain mengakses perangkat.

Pratinjau dalam aplikasi

Ikuti langkah-langkah untuk mengirim materi iklan ke perangkat tertaut Anda. Pastikan materi iklan yang dikirim adalah bagian dari item baris aktif yang ditargetkan ke slot iklan tempat Anda ingin menayangkan materi iklan.

Setelah mengirim materi iklan dari UI, picu menu opsi debug di perangkat Anda lagi dan pilih Creative Preview sekali lagi. Langkah ini memungkinkan SDK memeriksa Ad Manager untuk memverifikasi bahwa penautan perangkat berhasil dan mendapatkan beberapa informasi tentang materi iklan yang Anda kirim. Jika penautan perangkat sebelumnya berhasil, menu debug akan segera ditutup. Jika tidak berhasil, Anda akan diminta untuk menautkan akun Anda lagi.

Terakhir, muat iklan untuk slot yang ingin Anda lihat pratinjaunya untuk melihat materi iklan Anda.

Alat penayangan

Ikuti langkah-langkah di Memeriksa penayangan di Ad Manager untuk memecahkan masalah penayangan iklan Anda. Jika Anda telah menyelesaikan langkah-langkah tersebut dengan berhasil, permintaan akan muncul di UI Ad Manager dan Anda dapat melihat info selengkapnya tentang iklan yang ditayangkan.