Pemeriksa iklan

TIDAK DIGUNAKAN LAGI: Google Mobile Ads C++ SDK tidak digunakan lagi mulai 17 Juni 2024 dan tidak boleh diadopsi dalam project yang belum menggunakannya. Google Mobile Ads C++ SDK akan memasuki Akhir Pemeliharaan (EoM) pada 17 Juni 2025. Perhatikan bahwa versi SDK yang dirilis sebelum tanggal EoM akan terus berfungsi, tetapi tidak ada perbaikan bug atau perubahan lebih lanjut yang akan dirilis setelah tanggal EoM.

Sebagai ganti Google Mobile Ads C++ SDK, sebaiknya gunakan iOS dan Android SDK dari AdMob. Untuk mendapatkan dukungan, hubungi kami melalui formulir kontak.

Pemeriksa iklan adalah overlay dalam aplikasi yang memungkinkan perangkat yang diotorisasi melakukan analisis secara real-time terhadap permintaan iklan percobaan langsung dalam aplikasi seluler. Pemeriksa iklan disertakan dengan Google Mobile Ads SDK versi 9.1.0 dan yang lebih baru, serta dapat diaktifkan tanpa memerlukan coding.

Panduan ini menunjukkan cara meluncurkan dan menggunakan berbagai fitur di pemeriksa iklan.

Prasyarat

Untuk menggunakan pemeriksa iklan, Anda harus:

• Membuat akun AdMob dan menyiapkan aplikasi.

• Menyelesaikan Panduan memulai.

• Menggunakan Google Mobile Ads SDK versi 9.1.0 atau yang lebih baru.

• Menambahkan perangkat Anda sebagai perangkat pengujian. Pemeriksa iklan hanya diluncurkan di perangkat pengujian.

Meluncurkan pemeriksa iklan

Pemeriksa iklan dapat diluncurkan dari mana saja di aplikasi Anda dengan cara berikut:

1. Menggunakan gestur yang dipilih di UI AdMob saat mendaftarkan perangkat pengujian.
2. Secara terprogram menggunakan API yang disediakan.
3. Menggunakan tombol peluncuran dari menu debug.

Meluncurkan menggunakan gestur

Tidak ada perubahan yang diperlukan pada aplikasi Anda untuk meluncurkan pemeriksa iklan dengan gestur. Cukup lakukan gestur (geser dua kali atau goyangkan) yang Anda konfigurasi di AdMob untuk perangkat pengujian tersebut. Pelajari lebih lanjut

Setelah menetapkan gestur di UI AdMob (dan menunggu 15 menit agar gestur tersebut diterapkan), aplikasi Anda harus membuat permintaan iklan agar Google Mobile Ads SDK dapat mempelajari setelan gestur Anda. Jika gestur yang Anda tentukan tidak berfungsi, coba muat iklan, mulai ulang aplikasi, dan uji gestur lagi.

Meluncurkan secara terprogram

Pemeriksa iklan juga dapat diluncurkan secara terprogram:

API ini berfungsi untuk perangkat pengujian yang terdaftar secara terprogram atau di UI AdMob.

Melihat dan memecahkan masalah unit iklan

Setelah diluncurkan, layar utama pemeriksa iklan akan muncul, yang berisi daftar semua unit iklan di UI AdMob yang terkait dengan ID aplikasi AdMob Anda yang memiliki konfigurasi bidding atau mediasi:

Sebaiknya lakukan inisialisasi Google Mobile Ads SDK sebelum menggunakan pemeriksa iklan.

Melihat detail waterfall mediasi untuk unit iklan

Ketuk unit iklan untuk melihat log permintaan SDK-nya, yang memberikan detail tentang waterfall mediasi hingga saat iklan diisi (atau waterfall berakhir tanpa pengisian) untuk permintaan iklan terbaru.

Setiap permintaan dapat diperluas menggunakan indikator pengungkapan untuk menampilkan hasil waterfall mediasi untuk permintaan tersebut, beserta error dan latensi yang berlaku untuk permintaan tersebut.

Untuk sumber iklan pihak ketiga, pesan error dikirim langsung dari sumber iklan tersebut. Jika Anda memerlukan informasi lebih lanjut, lihat dokumentasi sumber iklan pihak ketiga.

Melihat detail bidding untuk unit iklan

Jika Anda baru menggunakan bidding, baca ringkasannya.

Di log permintaan SDK, Anda dapat melihat sumber iklan bidding yang dipanggil dalam permintaan iklan. Ketuk unit iklan di log permintaan SDK untuk melihat detail setiap sumber iklan dalam lelang bidding.

Hasil bidding diurutkan untuk menempatkan item yang dapat ditindaklanjuti lebih dekat ke bagian atas daftar:

• Di bagian atas adalah jaringan iklan yang memenangkan lelang.

• Selanjutnya adalah jaringan iklan yang bermasalah. Anda dapat mengikuti the langkah-langkah pemecahan masalah untuk masalah tersebut.

• Kemudian, ada jaringan iklan yang tidak menampilkan iklan atau tidak mengajukan bid. Hal ini mungkin merupakan indikator dari berbagai masalah dengan sumber iklan karena sumber iklan tersebut mungkin tidak mengajukan bid karena penyiapan atau pengambilan keputusannya. Anda dapat melihat panduan penyiapan sumber iklan atau menghubungi sumber iklan secara langsung untuk mendapatkan dukungan.

• Terakhir, di bagian bawah daftar adalah jaringan iklan yang kalah dalam lelang bidding.

  

Waterfall mediasi dapat menempatkan sumber iklan yang memenangkan lelang bidding sesuai dengan nilai eCPM-nya.

Saat sumber iklan dipanggil di waterfall mediasi, sumber iklan tersebut dapat menayangkan iklan. Untuk mempelajari lebih lanjut cara bidding berfungsi dengan waterfall mediasi, lihat contoh 2 dan contoh 3 sumber iklan bidding dan waterfall dalam grup mediasi.

Proses debug unit iklan lanjutan

Saat memecahkan masalah unit iklan, Anda dapat melihat permintaan dan respons iklan untuk mengidentifikasi penyebab kegagalan, atau membagikannya kepada Dukungan Google untuk membantu proses debug. Ketuk ikon menu di bagian atas rantai waterfall, lalu pilih Bagikan permintaan dan respons iklan untuk mengekspor permintaan dan respons iklan lengkap. Hal ini akan menghemat waktu Anda karena tidak perlu menjalankan pelacakan jaringan di aplikasi Anda sendiri.

Catatan: Anda hanya dapat mengekspor respons iklan setelah Anda menambahkan perangkat pengujian di UI AdMob. {# AdMob/Ad Manager check}

Selain itu, Anda dapat melihat parameter bidding pihak ketiga yang didekodekan dengan mengetuk opsi Parameter bidding pihak ketiga di menu yang sama dengan string permintaan. Hal ini memberikan detail tentang parameter bidding pihak ketiga yang mungkin mengalami masalah, sehingga membantu Anda melakukan debug aplikasi atau memvalidasi bahwa jaringan berhasil mengumpulkan sinyalnya.

Melihat adaptor yang tersedia

Klik tab Adaptor untuk melihat daftar semua adaptor pihak ketiga yang terkait dengan sumber iklan dalam konfigurasi bidding atau mediasi di aplikasi Anda. Kemudian, perluas kartu untuk melihat status inisialisasi dan versi SDK-nya. Selain adaptor pihak ketiga yang didukung, Anda juga dapat melihat adaptor peristiwa kustom.

Peristiwa kustom memungkinkan penayang menggunakan jaringan iklan yang tidak didukung AdMob. Peristiwa kustom dapat dibedakan dari adaptor pihak ketiga standar dalam daftar adaptor berdasarkan nama class uniknya. Selain memberikan informasi nama class dan status, pemeriksa iklan juga menampilkan label yang ditetapkan ke peristiwa kustom tersebut di antarmuka web AdMob.

Jika adaptor tidak ditemukan atau gagal diinisialisasi, lihat Memecahkan masalah yang ditemukan menggunakan pemeriksa iklan untuk mengetahui informasi selengkapnya.

Catatan: Implementasi peristiwa kustom sebelumnya, sebelum API yang merupakan subclass API yang tidak digunakan lagi, tidak mendukung inisialisasi dan muncul sebagai Masalah ditemukan dalam pemeriksa iklan. Jika Anda melihat peringatan tersebut di pemeriksa iklan meskipun integrasi peristiwa kustom Anda tampaknya berfungsi, periksa apakah aplikasi Anda menggunakan antarmuka yang tidak digunakan lagi seperti CustomEventBanner (Android) | GADCustomEventBanner (iOS) dan ganti dengan class Adapter (Android) | GADMediationAdapter (iOS) yang baru.

Menguji unit iklan

Jika Anda ingin menguji unit iklan tanpa harus membuka UI aplikasi, pemeriksa iklan mendukung hal ini langsung dari layar detail unit iklan. Selain itu, Anda dapat menguji beberapa unit iklan sekaligus, memuat dan melihat permintaan iklan pengujian secara asinkron, dan bahkan melakukan pengujian sumber iklan tunggal.

Penting: Saat Anda menjalankan salah satu pengujian pemeriksa iklan ini, permintaan Anda tidak menyertakan sejumlah parameter yang akan disertakan jika dipicu di UI aplikasi Anda, termasuk konfigurasi perlakuan untuk anak-anak, penargetan kustom, fitur tambahan jaringan, berbagai ukuran, dan lainnya. Karena permintaan ini lebih terbatas, sebaiknya lakukan pengujian menggunakan UI aplikasi Anda jika memungkinkan.

Pengujian iklan

Pengujian iklan pemeriksa iklan yang dijelaskan di bagian ini adalah alat yang bagus untuk memverifikasi pengalaman iklan dasar Anda dan untuk memvalidasi konfigurasi mediasi Anda saat digunakan dengan pengujian sumber iklan tunggal.

Jika Anda siap menguji unit iklan, ketuk tombol Minta iklan pengujian di bagian atas layar pemeriksa iklan untuk memicu pengujian iklan pemeriksa iklan. Hasil pengujian kemudian akan muncul di log permintaan SDK di bawah header Diminta dari pemeriksa iklan.

Pelajari cara menggunakan pemeriksa iklan di aplikasi Anda

Pengujian sumber iklan tunggal

Pemeriksa iklan memiliki fitur untuk membatasi permintaan iklan di aplikasi Anda agar hanya menayangkan iklan dari satu sumber iklan bidding atau mediasi waterfall. Dengan demikian, Anda akan dapat memeriksa bahwa adaptor pihak ketiga telah diterapkan dengan benar dan sumber iklan menayangkan iklan seperti yang diharapkan.

Untuk mengaktifkan fitur ini, aktifkan tombol Pengujian sumber iklan tunggal di bagian bawah layar. Dialog pemilihan sumber iklan berikut akan ditampilkan:

Anda harus melakukan inisialisasi Google Mobile Ads SDK sebelum dapat menggunakan pengujian sumber iklan tunggal.

Kemudian, Anda dapat memilih satu sumber iklan untuk diuji. Setelah sumber iklan dipilih, layar berikut akan muncul:

Setelan pengujian sumber iklan tunggal berlaku untuk permintaan iklan mendatang yang Anda buat dalam sesi yang sama. Namun, setelan ini tidak berlaku untuk iklan yang sebelumnya di-cache dalam sesi tersebut yang belum ditampilkan. Sebaiknya mulai ulang aplikasi secara paksa saat menerapkan pengujian sumber iklan tunggal untuk membatalkan iklan yang di-cache yang dapat ditayangkan, bukan sumber iklan pilihan Anda yang menerima permintaan.

Setelah memulai ulang aplikasi, semua penempatan unit iklan akan mencoba menampilkan iklan hanya dari jaringan yang dipilih. Meluncurkan pemeriksa iklan saat pengujian sumber iklan tunggal aktif akan menampilkan sumber iklan pengujian yang aktif:

Dalam mode pengujian sumber iklan tunggal, semua permintaan iklan akan dicoba untuk diisi menggunakan sumber iklan yang dipilih, terlepas dari apakah sumber iklan tersebut dikonfigurasi untuk bidding atau mediasi untuk unit iklan yang diminta. Jika sumber iklan yang Anda uji tidak berada dalam waterfall mediasi untuk unit iklan, Anda akan mendapatkan pesan error "Tidak ada pengisian".

Dalam pengujian sumber iklan tunggal, Anda dapat mengetuk unit iklan untuk melihat log permintaan SDK. Dengan demikian, Anda dapat mengetahui apakah sumber iklan mengisi permintaan iklan yang dibuat setelah pengujian sumber iklan tunggal diaktifkan. Jika sumber iklan gagal memuat iklan, pesan error yang menjelaskan error tersebut akan muncul.

Jika telah menambahkan beberapa sumber iklan yang dipilih ke waterfall mediasi, Anda akan melihat setiap panggilan ke sumber iklan tersebut dalam waterfall hingga iklan diisi atau waterfall berakhir tanpa pengisian.

Menghentikan pengujian sumber iklan tunggal

Untuk menghentikan pengujian, nonaktifkan tombol:

Pesan konfirmasi kemudian akan muncul di layar mulai ulang berikut:

Sebaiknya mulai ulang aplikasi secara paksa setelah menghentikan pengujian untuk membatalkan iklan yang di-cache untuk sumber iklan yang diuji.

Melakukan debug setelan privasi

Prasyarat: Google Mobile Ads SDK versi 9.6.0 atau yang lebih baru

Anda dapat menggunakan pemeriksa iklan untuk melihat sinyal privasi berikut yang diteruskan dalam permintaan iklan sebagai bagian dari Integrasi penayang dengan TCF IAB Eropa:

• GDPR berlaku (IABTCF_gdprApplies)
• String AC (IABTCF_AddtlConsent)
• String TC (IABTCF_TCString)

Setelah memuat iklan atau melakukan pengujian iklan di pemeriksa iklan, ketuk ikon menu pada permintaan di bagian Log permintaan SDK. Selanjutnya, pilih opsi Sinyal privasi.

Layar Sinyal privasi menampilkan sinyal privasi yang diteruskan dalam permintaan iklan.

Untuk mempelajari lebih lanjut string AC, lihat Spesifikasi teknis Izin Tambahan Google. Untuk melihat detail izin terperinci dalam string TC, seperti ID CMP dan daftar ID vendor yang diizinkan yang terkait dengan IAB, klik Decode untuk membuka the IAB GPP Encoder / Decoder.

Jika Anda mengalami error, ikuti langkah-langkah di Memahami masalah privasi untuk memecahkan masalah.

Menyalin seluruh output proses debug

Pemeriksa iklan mendukung penyalinan string JSON yang berisi seluruh output proses debug dari alat, termasuk detail aplikasi AdMob, status inisialisasi adaptor, dan hasil pengujian semua unit iklan.

Untuk melakukannya, ketuk ikon aplikasi tujuh kali hingga Anda melihat pesan Copied ad inspector JSON to clipboard.