Dengan pemeriksa iklan, Anda dapat:
- Memeriksa unit iklan
- Periksa apakah iklan terisi seperti yang diharapkan
- Mengidentifikasi error dan melihat detail tentang cara memperbaikinya
- Lihat detail untuk setiap jaringan iklan bidding per permintaan
- Melihat detail mediasi untuk setiap jaringan iklan per permintaan
- Menguji setiap sumber iklan bidding pihak ketiga atau mediasi waterfall
- Memastikan bahwa Anda telah mengonfigurasi setiap unit iklan dengan benar untuk bidding dan mediasi waterfall
Panduan ini menunjukkan cara meluncurkan dan menggunakan berbagai fitur dalam iklan pemeriksa.
Prasyarat
Untuk menggunakan pemeriksa iklan, Anda harus:
- Selesaikan panduan Memulai.
- Gunakan versi plugin Flutter Mobile Ads 1.3.0 atau lebih tinggi.
- Aktifkan pengujian mode atau link perangkat Anda ke Ad Manager. Pemeriksa iklan hanya diluncurkan di perangkat pengujian atau tertaut.
Luncurkan pemeriksa iklan
Pemeriksa iklan dapat diluncurkan dari mana saja di aplikasi Anda dengan cara berikut:
- Gunakan tombol luncurkan dari menu debug.
- Gunakan gestur yang Anda pilih di setelan pemeriksa iklan.
- Secara terprogram menggunakan API yang disediakan.
Meluncurkan menggunakan menu debug
Tidak ada perubahan yang diperlukan pada aplikasi Anda untuk meluncurkan pemeriksa iklan melalui menu debug; cukup temukan iklan yang ditayangkan oleh jaringan Ad Manager Anda, lalu sentuh lama iklan dengan dua jari untuk membuka menu debug. Kemudian, pilih Buka pemeriksa iklan.
Jika tidak menautkan perangkat, Anda mungkin akan diminta untuk login ke akun Ad Manager.
Anda juga dapat memilih Setelan pemeriksa iklan dari setelan debug dan pilih gestur yang dapat membuka pemeriksa iklan pada masa mendatang tanpa harus membuka melalui menu debug.
Meluncurkan secara terprogram
Pemeriksa iklan juga dapat diluncurkan secara terprogram:
MobileAds.instance.openAdInspector(
(AdInspectorError? error) {
// Error will be non-null if ad inspector closed due to an error.
});
API ini berfungsi untuk perangkat pengujian terdaftar secara terprogram.
Melihat dan memecahkan masalah unit iklan
Setelah diluncurkan, layar pemeriksa iklan utama akan muncul, yang berisi daftar semua unit iklan permintaan iklannya telah dibuat oleh perangkat karena pemeriksa iklan diaktifkan selama sesi aplikasi Google Play. Daftar tersebut juga berisi unit iklan dengan bidding yang diaktifkan, diurutkan secara kronologis dengan permintaan yang paling cepat diselesaikan terlebih dahulu, dan permintaan tidak ada permintaan iklan yang diselesaikan (redup):
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. Jika Anda memerlukan informasi selengkapnya, hubungi sumber iklan pihak ketiga.
Melihat detail bidding untuk unit iklan
Jika Anda baru melakukan bidding, baca pengantar Bidding Terbuka.
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 terdapat jaringan iklan yang memenangkan lelang.
Berikutnya adalah jaringan iklan yang bermasalah. Anda dapat mengikuti langkah pemecahan masalah di akhir FAQ bidding.
Kemudian, ada jaringan iklan yang tidak memiliki iklan yang ditampilkan atau tidak mengajukan bid. Ini adalah indikator yang mungkin dari berbagai masalah pada sumber iklan karena mungkin tidak memiliki bid karena penyiapan atau pengambilan keputusannya. Anda dapat merujuk ke iklan dari panduan penyiapan sumber atau FAQ Bidding Terbuka untuk mendapatkan dukungan selengkapnya.
Terakhir, di bagian bawah daftar adalah jaringan iklan yang kalah dalam bidding lelang.
Waterfall mediasi dapat menempatkan sumber iklan yang memenangkan lelang bidding sesuai dengan nilai eCPM.
Waterfall mediasi adalah hasil dari beberapa grup hasil yang bersaing untuk inventaris yang sama. Anda dapat menambahkan hingga 10 partner hasil pihak ketiga ke satu grup hasil, termasuk partner hasil bidding dan mediasi untuk seluler partner hasil Google Cloud.
Proses debug unit iklan lanjutan
Saat memecahkan masalah unit iklan, sebaiknya pelajari permintaan dan respons iklan untuk mengidentifikasi bagian yang mengalami kegagalan, atau bagikan 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. Ini menghindarkan Anda dari keharusan untuk menjalankan pelacakan jaringan pada aplikasi Anda sendiri.
Selain itu, Anda dapat melihat parameter bidding pihak ketiga yang didekode dengan mengetuk opsi Parameter bidding pihak ketiga di menu yang sama dengan string permintaan. Informasi ini memberikan detail tentang parameter bidding pihak ketiga yang mungkin mengalami masalah, membantu Anda untuk men-debug aplikasi atau memvalidasi bahwa jaringan mengumpulkan sinyalnya dengan sukses.
|
|
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, luaskan kartu untuk melihat status inisialisasi dan versi SDK-nya. Bersama dengan adaptor pihak ketiga yang didukung, Anda juga dapat melihat adaptor peristiwa kustom. Peristiwa kustom memungkinkan penayang menggunakan jaringan iklan yang Ad Manager tidak didukung. Peristiwa kustom dapat dibedakan dari peristiwa pihak ketiga standar adaptor dalam daftar adaptor berdasarkan nama kelas uniknya. Selain memberikan nama class dan informasi status, pemeriksa iklan juga menampilkan label yang ditetapkan ke peristiwa kustom tersebut di antarmuka webAd Manager .
Jika adaptor tidak ditemukan atau gagal diinisialisasi, lihat Memeriksa penayangan iklan aplikasi seluler untuk informasi selengkapnya.
|
|
Menguji unit iklan
Jika Anda ingin menguji unit iklan tanpa harus menjelajahinya di UI aplikasi Anda, pemeriksa iklan mendukung fitur ini langsung dari layar detail unit iklan. Selain itu, Anda dapat menguji beberapa unit iklan sekaligus, dengan pemuatan asinkron dan melihat permintaan iklan uji coba, bahkan melakukan pengujian sumber iklan tunggal.
Pengujian iklan
Pengujian iklan pemeriksa iklan yang diuraikan di bagian ini adalah alat yang bagus untuk memverifikasi pengalaman iklan dasar dan memvalidasi mediasi Anda konfigurasi yang sama saat digunakan dengan pengujian sumber iklan tunggal.
Setelah siap menguji unit iklan, ketuk tombol Minta iklan percobaan di bagian atas layar pemeriksa iklan untuk memicu pengujian iklan pemeriksa iklan. Uji coba hasilnya akan muncul di log permintaan SDK di bawah header Diminta dari pemeriksa iklan.
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 dapat memverifikasi bahwa Anda telah menerapkan adaptor pihak ketiga dengan benar dan bahwa sumber iklan menayangkan iklan seperti yang diharapkan.
Untuk mengaktifkan fitur ini, aktifkan tombol Pengujian sumber iklan tunggal di di bagian bawah layar. Tindakan ini akan menampilkan dialog pemilihan sumber iklan berikut:
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, hal ini tidak berlaku untuk iklan yang sebelumnya di-cache dalam sesi yang belum ditampilkan. Mulai ulang aplikasi secara paksa direkomendasikan saat menerapkan pengujian sumber iklan tunggal untuk membatalkan validasi iklan dalam cache yang dapat ditayangkan, bukan sumber iklan yang Anda pilih yang menerima permintaan.
Setelah memulai ulang aplikasi, semua penempatan unit iklan akan berupaya menampilkan iklan 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 diisi dengan sumber iklan, terlepas dari apakah sumber iklan tersebut dikonfigurasi untuk bidding atau mediasi untuk unit iklan yang diminta. Jika sumber iklan yang diuji tidak berada dalam urutan 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-nya. Hal ini memungkinkan Anda mengetahui apakah sumber iklan mengisi permintaan iklan yang dibuat setelah pengujian sumber iklan tunggal diaktifkan. Jika sumber iklan gagal memuat iklan, muncul pesan {i>error<i} yang menjelaskan kesalahan tersebut.
Jika Anda telah menambahkan beberapa sumber iklan yang dipilih ke mediasi waterfall, Anda akan melihat setiap instance panggilan ke sumber iklan di waterfall hingga iklan terisi atau waterfall berakhir tanpa pengisian.
Menghentikan pengujian sumber iklan tunggal
Untuk menghentikan pengujian, nonaktifkan tombol:
Pesan konfirmasi 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.
Salin seluruh output proses debug
Pemeriksa iklan mendukung penyalinan string JSON yang berisi seluruh output proses debug dari alat, termasuk detail aplikasi Ad Manager , status inisialisasi adaptor, dan hasil pengujian semua unit iklan.
Untuk melakukannya, ketuk ikon aplikasi tujuh kali sampai Anda melihat pesan Iklan yang disalin pemeriksa JSON ke papan klip.