Pemeriksa iklan (Beta)

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

Dengan menggunakan pemeriksa iklan, Anda dapat:

• Periksa unit iklan Anda
• Memeriksa apakah iklan terisi sesuai harapan
• Mengidentifikasi error dan melihat detail tentang cara mengatasinya
• Lihat detail untuk setiap jaringan iklan Bidding Terbuka per permintaan
• Melihat detail mediasi untuk setiap jaringan iklan per permintaan
• Menguji setiap sumber iklan Bidding Terbuka atau mediasi waterfall pihak ketiga
• Memastikan bahwa Anda telah mengonfigurasi setiap unit iklan dengan benar untuk Bidding Terbuka dan mediasi waterfall

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

Prasyarat

Untuk menggunakan pemeriksa iklan, Anda harus:

• Identifikasi ID aplikasi Ad Manager Anda.

• Selesaikan panduan Memulai.

• Gunakan Google Mobile Ads SDK versi 8.10.0 atau yang lebih tinggi.

• Aktifkan mode pengujian atau tautkan perangkat Anda ke Ad Manager. Pemeriksa iklan hanya diluncurkan pada pengujian atau perangkat yang ditautkan.

Luncurkan pemeriksa iklan

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

1. Gunakan tombol peluncuran dari menu debug.
2. Gunakan gestur yang Anda pilih di setelan pemeriksa iklan.
3. Secara terprogram menggunakan API yang disediakan.

Meluncurkan menggunakan menu debug

Tidak diperlukan perubahan pada aplikasi untuk meluncurkan pemeriksa iklan melalui menu debug; cukup temukan iklan yang ditayangkan oleh jaringan Ad Manager Anda, dan sentuh lama iklan dengan dua jari untuk membuka menu debug. Selanjutnya, pilih Buka pemeriksa iklan.

Jika tidak menautkan perangkat, Anda mungkin diminta untuk login ke akun Ad Manager.

Anda juga dapat memilih Setelan pemeriksa iklan dari setelan debug dan memilih gestur yang dapat membuka pemeriksa iklan di masa mendatang tanpa harus melalui menu debug.

Meluncurkan secara terprogram

Pemeriksa iklan juga dapat diluncurkan secara terprogram:

Swift

GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
  // Error will be non-nil if there was an issue and the inspector was not displayed.
}

Objective-C

[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

API ini berfungsi untuk perangkat pengujian yang terdaftar secara terprogram.

Pastikan pengontrol tampilan yang diteruskan ke API ini sudah sepenuhnya terlihat di layar (viewDidAppear: telah dipanggil). Jika pengontrol tampilan yang diteruskan sedang dalam proses ditampilkan, seperti saat API dipanggil dalam fungsi viewDidLoad pengontrol tampilan, presentasi pemeriksa iklan akan gagal.

Melihat dan memecahkan masalah unit iklan

Setelah diluncurkan, layar pemeriksa iklan utama akan muncul, yang berisi daftar semua unit iklan perangkat telah membuat permintaan iklan sejak pemeriksa iklan diaktifkan selama sesi aplikasi ini. Daftar ini juga berisi unit iklan dengan Bidding Terbuka yang diaktifkan, diurutkan secara kronologis dengan permintaan yang paling baru diselesaikan terlebih dahulu, dan unit tanpa permintaan iklan yang selesai (diredupkan):

Sebaiknya 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 urutan mediasi hingga 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, hubungi sumber iklan pihak ketiga.

Melihat detail bidding untuk unit iklan

Jika Anda baru mengenal Bidding Terbuka, baca pengantar Bidding Terbuka.

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

Hasil Open Bidding diurutkan untuk mendekatkan item yang dapat ditindaklanjuti ke bagian atas daftar:

• Di bagian atas adalah jaringan iklan yang memenangkan lelang.

• Berikutnya adalah jaringan iklan yang mengalami masalah. Anda dapat mengikuti langkah-langkah pemecahan masalah di bagian akhir Open Bidding FAQ.

• Lalu, ada jaringan iklan yang tidak memiliki iklan yang ditampilkan atau tidak mengajukan bid. Hal ini adalah indikator yang mungkin dari berbagai masalah pada sumber iklan karena sumber iklan mungkin tidak memiliki bid akibat penyiapan atau pengambilan keputusannya. Anda dapat melihat panduan penyiapan sumber iklan atau FAQ Bidding Terbuka untuk dukungan lebih lanjut.

• Terakhir, di bagian bawah daftar terdapat jaringan iklan yang kalah dalam Open Bidding lelang.

  

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

Waterfall mediasi adalah hasil dari beberapa grup hasil yang bersaing untuk inventaris yang sama. Anda dapat menambahkan hingga sepuluh partner hasil pihak ketiga ke satu grup hasil, termasuk partner hasil Bidding Terbuka dan mediasi untuk partner hasil aplikasi seluler.

Proses debug unit iklan lanjutan

Saat memecahkan masalah unit iklan, sebaiknya pelajari permintaan dan respons iklan untuk mengidentifikasi bagian yang gagal atau membagikan informasi 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. Dengan demikian, Anda tidak perlu repot menjalankan pelacakan jaringan di 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. Tindakan ini memberikan detail tentang parameter bidding pihak ketiga mana yang mungkin mengalami masalah, sehingga membantu Anda men-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, luaskan 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 Ad Manager tidak didukung. Peristiwa kustom dapat dibedakan dari adaptor pihak ketiga standar di daftar adaptor berdasarkan nama class-nya yang unik. Selain memberikan nama kelas dan informasi status, pemeriksa iklan juga menampilkan label yang ditetapkan ke peristiwa kustom tersebut di Ad Manager antarmuka web.

Jika adaptor tidak ditemukan atau gagal diinisialisasi, lihat Memeriksa penayangan iklan aplikasi seluler untuk mengetahui informasi selengkapnya.

Catatan: Penerapan peristiwa kustom sebelumnya, sebelum API versi v9.0.0, yang API yang tidak digunakan lagi oleh subclass tidak mendukung inisialisasi dan muncul sebagai Masalah ditemukan dalam pemeriksa iklan. Jika Anda melihat peringatan tersebut di pemeriksa iklan meskipun integrasi peristiwa kustom tampak berfungsi, periksa apakah aplikasi Anda menggunakan antarmuka yang tidak digunakan lagi seperti GADCustomEventBanner dan ganti dengan class GADMediationAdapter baru.

Menguji unit iklan

Jika Anda ingin menguji unit iklan tanpa harus membukanya di UI aplikasi, pemeriksa iklan mendukungnya 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 menjalankan pengujian sumber iklan tunggal.

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

Pengujian iklan

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

Poin Penting: Meskipun unit iklan Anda dapat mendukung beberapa format iklan, pemeriksa iklan tidak mengizinkan Anda memilih format mana yang ingin diuji, tetapi ditetapkan secara default ke format yang terakhir diminta.

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

Pelajari cara menggunakan pemeriksa iklan di aplikasi

Pengujian sumber iklan tunggal

Pemeriksa iklan memiliki fitur untuk membatasi permintaan iklan di aplikasi Anda agar hanya menayangkan iklan dari satu Open Bidding atau sumber iklan mediasi Waterfall. Hal ini memungkinkan Anda memastikan bahwa adaptor pihak ketiga telah diterapkan dengan benar dan sumber iklan menayangkan iklan seperti yang diharapkan.

Untuk mengaktifkan fitur ini, alihkan tombol Pengujian sumber iklan tunggal di bagian bawah layar. Tindakan ini akan menampilkan dialog pemilihan sumber iklan berikut:

Anda harus menginisialisasi 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 setiap permintaan iklan berikutnya yang Anda buat dalam sesi yang sama. Namun, hal 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 cache apa pun 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 menampilkan sumber iklan pengujian yang aktif:

Dalam mode pengujian sumber iklan tunggal, semua permintaan iklan akan diisi dengan sumber iklan yang dipilih, terlepas dari apakah sumber iklan tersebut dikonfigurasi untuk bidding atau mediasi untuk unit iklan yang diminta atau tidak. Jika sumber iklan yang diuji 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 menampilkan log permintaan SDK-nya. 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 akan muncul yang menjelaskan error tersebut.

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

Menghentikan pengujian satu sumber iklan

Untuk menghentikan pengujian, nonaktifkan tombol:

Pesan konfirmasi kemudian muncul di layar mulai ulang berikut:

Sebaiknya mulai ulang aplikasi Anda 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 tersebut, termasuk detail Ad Manager aplikasi Anda, status inisialisasi adaptor, dan hasil pengujian semua unit iklan.

Untuk melakukannya, ketuk ikon aplikasi tujuh kali sampai Anda melihat pesan Menyalin JSON pemeriks iklan iklan ke papan klip.