Pratinjau Kreatif & Delivery Inspector

Panduan ini menunjukkan cara men-debug penayangan iklan menggunakan pratinjau dalam aplikasi dan Pemeriksa Penayangan.

Pratinjau dalam aplikasi memungkinkan Anda melihat materi iklan Anda sendiri yang dirender dalam aplikasi seluler Anda. Pratinjau ini sangat berguna bagi penayang yang memiliki materi iklan yang berinteraksi dengan aplikasi, memiliki perilaku unik, atau mengandalkan aplikasi untuk beberapa rendering-nya (termasuk materi iklan native dan MRAID).

Pemeriksa Penayangan memberikan informasi mengenai iklan yang ditayangkan. Jika iklan yang tidak diharapkan ditayangkan, gunakan Delivery Inspector untuk mengetahui alasannya.

Prasyarat

  • Google Mobile Ads SDK versi 7.13.1 atau yang lebih baru
  • 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 dalam aplikasi Anda, dan memicunya berdasarkan tindakan pengguna:

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  let debugOptionsViewController = DebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

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

Mendapatkan notifikasi saat menu debug ditutup

Saat membuka menu opsi debug secara terprogram, Anda dapat memilih untuk menerapkan GADDebugOptionsViewControllerDelegate agar diberi tahu saat pengontrol tampilan ditutup. Untuk melakukannya, buat class Anda sesuai dengan delegasi:

Swift

import GoogleMobileAds
 
class ViewController: UIViewController, GADDebugOptionsViewControllerDelegate {
}

Objective-C

@import GoogleMobileAds;
 
@interface ViewController : UIViewController <GADDebugOptionsViewControllerDelegate> {
}
 
@end

Tetapkan delegasi di GADDebugOptionsViewController Anda:

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  let debugOptionsViewController = GADDebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  debugOptionsViewController.delegate = self
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  debugOptionsViewController.delegate = self;
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

Terakhir, terapkan delegasi:

Swift

func debugOptionsViewControllerDidDismiss(controller: GADDebugOptionsViewController) {
  print("Debug options view controller dismissed.")
}

Objective-C 

- (void)debugOptionsViewControllerDidDismiss:(GADDebugOptionsViewController *)controller {
  NSLog(@"Debug options view controller dismissed.");
}

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 berhasil login, beri nama perangkat Anda untuk mendaftarkannya ke akun Ad Manager Anda, lalu klik Verifikasi.

Anda telah berhasil menautkan perangkat Anda. Pada tahap ini, Anda dapat melihat perangkat Anda yang ditautkan di frontend Ad Manager. Anda juga dapat mengizinkan orang lain mengakses perangkat Anda.

Pratinjau dalam aplikasi

Ikuti langkah-langkah untuk mendorong materi iklan ke perangkat tertaut Anda. Pastikan materi iklan yang didorong adalah bagian dari item baris aktif yang ditargetkan ke slot iklan tempat Anda ingin melihat materi iklan.

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

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

Delivery Inspector

Ikuti langkah-langkah Mulai pemecahan masalah aplikasi untuk memecahkan masalah aplikasi Anda. Jika Anda berhasil menyelesaikan langkah-langkah tersebut, permintaan akan muncul di frontend Ad Manager dan Anda dapat melihat info selengkapnya tentang iklan yang ditayangkan.