Pemeriksa iklan

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
Pemeriksa iklan adalah overlay dalam aplikasi yang memungkinkan perangkat yang diotorisasi untuk menjalankan analisis permintaan iklan real-time secara langsung dalam aplikasi seluler. Ini disertakan dengan Google Mobile Ads SDK versi 20.0.0 dan lebih tinggi, dan dapat diaktifkan tanpa memerlukan coding.

Dengan menggunakan pemeriksa iklan pada versi Mobile Ads SDK yang lebih rendah dari20.2.0, Anda dapat:

  • Memeriksa unit iklan
  • Memeriksa adaptor pihak ketiga
  • Memeriksa apakah iklan terisi sesuai harapan
  • Mengidentifikasi error dan melihat detail tentang cara memperbaikinya
  • Melihat detail mediasi untuk setiap jaringan iklan per permintaan
  • Menguji setiap sumber iklan mediasi pihak ketiga
  • Memastikan bahwa Anda telah mengonfigurasi dengan benar setiap unit iklan untuk mediasi waterfall
  • Menguji integrasi peristiwa kustom

Untuk Mobile Ads SDK versi 20.2.0 dan yang lebih tinggi, Anda juga dapat:

  • Melihat detail bidding untuk setiap jaringan iklan per permintaan
  • Melihat detail bidding dan urutan mediasi secara bersamaan untuk setiap jaringan iklan per permintaan
  • Menguji setiap sumber iklan bidding pihak ketiga atau mediasi mediasi
  • Memastikan bahwa Anda telah mengonfigurasi dengan benar setiap unit iklan untuk bidding dan mediasi waterfall

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

Prasyarat

Untuk menggunakan pemeriksa iklan, Anda harus:

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

Meluncurkan pemeriksa iklan

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

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

Luncurkan menggunakan gestur

Aplikasi tidak perlu melakukan perubahan untuk meluncurkan pemeriksa iklan dengan gestur. Cukup lakukan gestur (jentikkan ganda atau goyang) yang Anda konfigurasikan di AdMob untuk perangkat pengujian tersebut. Pelajari lebih lanjut.

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

Meluncurkan secara terprogram

Pemeriksa iklan juga dapat diluncurkan secara terprogram:

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

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

Melihat dan memecahkan masalah unit iklan

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

Unit iklan diurutkan secara kronologis dengan permintaan yang baru saja selesai terlebih dahulu. Seperti yang ditunjukkan di atas, unit iklan yang dikenal tanpa permintaan yang selesai diredupkan.

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 berisi detail tentang waterfall mediasi sampai 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, hubungi sumber iklan pihak ketiga.

Melihat detail bidding untuk unit iklan

Prasyarat: Google Mobile Ads SDK 20.2.0 atau yang lebih tinggi

Jika Anda baru menggunakan bidding, baca ringkasan.

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

Hasil 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 bermasalah. Anda dapat mengikuti langkah-langkah pemecahan masalah untuk masalah tersebut.

  • Selanjutnya, ada jaringan iklan yang tidak memiliki iklan yang ditampilkan atau tidak mengajukan bid. Ini merupakan indikator yang mungkin dari berbagai masalah pada sumber iklan karena mungkin tidak ada bid karena penyiapan atau penentuannya. Anda dapat melihat panduan penyiapan sumber iklan atau menghubungi sumber iklan secara langsung untuk mendapatkan dukungan.

  • Terakhir, di bagian bawah daftar ada jaringan iklan yang kalah dari lelangbidding .

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

Ketika sumber iklan dipanggil di waterfall mediasi, sumber iklan tersebut akan menayangkan iklan. Untuk mempelajari lebih lanjut cara kerja bidding 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, sebaiknya pelajari permintaan iklan itu sendiri untuk mengidentifikasi tempat terjadinya sesuatu yang gagal atau sampaikan masukan Anda kepada Dukungan Google untuk membantu proses debug. Ketuk ikon menu di bagian atas rantai waterfall dan pilih Bagikan string permintaan untuk mengekspor permintaan iklan lengkap. Dengan cara ini, Anda tidak perlu repot 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. Hal ini memberikan detail tentang parameter bidding pihak ketiga yang mungkin mengalami masalah, yang membantu Anda men-debug aplikasi atau memvalidasi bahwa jaringan berhasil mengumpulkan sinyalnya.

Lihat adaptor yang tersedia

Buka tab Adaptor, tempat Anda dapat menemukan daftar semua adaptor pihak ketiga yang terkait dengan sumber iklan dalam konfigurasi bidding atau mediasi di aplikasi Anda, dan status inisialisasinya. Jika adaptor tidak ditemukan atau gagal diinisialisasi, baca artikel pusat bantuan untuk memecahkan masalah ini.

Selain adaptor pihak ketiga yang didukung, Anda juga dapat melihat adaptor peristiwa kustom; peristiwa kustom memungkinkan penayang menggunakan jaringan iklan yang tidak didukung oleh AdMob. Peristiwa kustom dapat diidentifikasi dalam daftar adaptor bersama adaptor pihak ketiga standar dengan nama class-nya seperti yang ditunjukkan di bawah ini:

Selain memberikan informasi nama dan status kelas, pemeriksa iklan juga memberikan label yang ditetapkan ke kelas di UI AdMob.

Melakukan pengujian sumber iklan tunggal

Pemeriksa iklan memiliki fitur untuk membatasi permintaan iklan di aplikasi Anda agar hanya menayangkan iklan dari satu sumber iklan mediasi bidding atau waterfall. Hal ini memungkinkan Anda memverifikasi bahwa Anda telah menerapkan adaptor pihak ketiga dengan benar dan bahwa sumber iklan ditayangkan 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.

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

Setelan pengujian sumber iklan tunggal berlaku untuk semua permintaan iklan berikutnya yang Anda buat dalam sesi yang sama. Namun, hal tersebut tidak akan berlaku untuk iklan yang sebelumnya di-cache dalam sesi tersebut yang belum ditampilkan. Mulai ulang aplikasi secara paksa direkomendasikan saat menerapkan satu pengujian sumber iklan untuk membatalkan iklan yang disimpan dalam cache yang dapat ditayangkan, dan bukan sumber iklan yang Anda pilih yang menerima permintaan.

Setelah memulai ulang aplikasi, semua penempatan unit iklan akan mencoba menampilkan iklan dari jaringan yang dipilih saja. 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 mencoba mengisi dengan sumber iklan yang dipilih, terlepas dari apakah sumber iklan tersebut dikonfigurasi untuk bidding atau mediasi untuk unit iklan yang diminta. Artinya, jika sumber iklan yang Anda uji tidak berada dalam waterfall mediasi untuk unit iklan, Anda akan melihat 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 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 satu pengujian sumber iklan

Untuk menghentikan pengujian, nonaktifkan tombol:

Pesan konfirmasi akan muncul melalui layar mulai ulang berikut:

Sebaiknya mulai ulang aplikasi secara paksa setelah pengujian dihentikan untuk membatalkan iklan yang disimpan dalam cache untuk sumber iklan yang diuji.