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 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 yang ditayangkan; jadi saat iklan yang tidak terduga ditayangkan, gunakan alat penayangan untuk mencari tahu alasannya.

Prasyarat

  • Google Mobile Ads SDK versi 10.2.0 atau yang lebih baru.
  • Akses ke akun Google Ad Manager.
  • Selesaikan langkah Memulai.

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 adalah dengan menekan lama dua jari pada materi iklan, tetapi 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 akan jauh lebih andal.

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

Pilih Creative Preview 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. Selanjutnya, klik Verifikasi.

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

Pratinjau dalam aplikasi

Ikuti langkah-langkah untuk mendorong 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 menu opsi debug di perangkat Anda lagi, lalu pilih Creative Preview sekali lagi. Langkah ini memungkinkan SDK memeriksa Ad Manager untuk memverifikasi bahwa penautan perangkat berhasil dan mendapatkan beberapa informasi tentang materi iklan yang Anda kirim. Jika penautan perangkat sebelumnya berhasil, menu debug akan segera ditutup. Jika tidak berhasil, Anda akan diminta untuk menautkan kembali akun Anda.

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

Alat penayangan

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