Pratinjau Kreatif & Delivery Inspector

Panduan ini menunjukkan cara men-debug penayangan iklan menggunakan pratinjau dalam aplikasi dan Delivery Inspector.

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

Delivery Inspector memberikan informasi tentang iklan mana yang ditayangkan. Saat iklan yang tidak terduga ditayangkan, gunakan Delivery Inspector untuk mencari tahu alasannya.

Prasyarat

• Google Mobile Ads SDK versi 7.13.1 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 di 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 = GADDebugOptionsViewController(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.

Catatan: Cara lain untuk membuka menu adalah dengan melakukan gestur geser pada materi iklan, tetapi ini tidak 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 efektif.

Mendapatkan notifikasi saat menu debug ditutup

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

Swift

import GoogleMobileAds
 
class ViewController: UIViewController, GADDebugOptionsViewControllerDelegate {
}

Objective-C

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

Tetapkan delegasi di GADDebugOptionsViewController:

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, implementasikan delegasi:

Swift

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

Objective-C

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

Tautkan perangkat Anda

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

Catatan: SFSafariViewController dibuka di iOS 9 dan yang lebih baru, sedangkan Safari dibuka di iOS 8 dan yang lebih lama.

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

Pratinjau dalam aplikasi

Ikuti langkah-langkah untuk mengirim materi iklan ke perangkat tertaut Anda. Pastikan bahwa materi iklan yang dikirim 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, dan pilih Pratinjau Materi Iklan lagi. Langkah ini memungkinkan SDK memeriksa kembali Ad Manager untuk memverifikasi bahwa penautan perangkat berhasil dan untuk mendapatkan beberapa informasi tentang materi iklan yang dikirim. 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 dipratinjau untuk melihat materi iklan Anda.

Pemeriksa Penayangan

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.