Pratinjau Kreatif & Alat Penayangan

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. Pratinjau ini sangat berguna terutama 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 mana yang ditayangkan; jadi saat iklan yang tidak diharapkan ditayangkan, gunakan alat penayangan untuk mencari tahu alasannya.

Prasyarat

  • Google Mobile Ads SDK versi 10.2.0 atau yang lebih tinggi.
  • Akses ke akun Google Ad Manager.
  • Selesaikan Mulai.

Menyiapkan aplikasi

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

Java

public class MainActivity extends AppCompatActivity {

  ...

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // Initialize the Mobile Ads SDK.
    MobileAds.initialize(this);
  }

  ...

  // Opens a debug menu. Call this method based on a user action.
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  public void openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID");
  }
}

Kotlin

class MainActivity : AppCompatActivity() {

  ...

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    // Initialize the Mobile Ads SDK.
    MobileAds.initialize(this)
  }

  ...

  // Opens a debug menu. Call this method based on a user action.
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  fun openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID")
  }
}

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

Cara lain untuk membuka menu ini adalah dengan menekan dua jari lama pada materi iklan, tetapi cara ini tidak akan berfungsi untuk semua format iklan, seperti iklan native, dan Anda harus berhati-hati agar tidak mengklik iklan saat mencoba menggeser. Memanggil metode di atas jauh lebih kokoh.

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

Pilih Pratinjau Materi Iklan untuk menautkan perangkat Anda. Browser akan terbuka dan otomatis mengarahkan Anda ke browser untuk login ke Ad Manager. Setelah login, beri nama perangkat untuk mendaftarkannya dengan akun Ad Manager Anda. Lalu, klik Verifikasi.

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

Pratinjau dalam aplikasi

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

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

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

Alat penayangan

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