Bản xem trước mẫu quảng cáo và Trình kiểm tra phân phối

Hướng dẫn này trình bày cách gỡ lỗi hoạt động phân phát quảng cáo bằng tính năng xem trước trong ứng dụng và Công cụ kiểm tra việc phân phối.

Bản xem trước trong ứng dụng cho phép bạn xem mẫu quảng cáo của mình được hiển thị trong ứng dụng di động. Bản xem trước này đặc biệt hữu ích cho những nhà xuất bản có mẫu quảng cáo tương tác với ứng dụng, có hành vi khác biệt hoặc dựa vào ứng dụng để hiển thị một số mẫu quảng cáo (bao gồm cả mẫu quảng cáo gốc và MRAID).

Công cụ kiểm tra việc phân phối cung cấp thông tin về những quảng cáo đã được phân phối. Khi quảng cáo không mong muốn phân phối, hãy sử dụng Trình kiểm tra phân phối để tìm hiểu lý do.

Điều kiện tiên quyết

  • Google Mobile Ads SDK phiên bản 7.13.1 trở lên
  • Quyền truy cập vào tài khoản Google Ad Manager
  • Hoàn thành các bước trong phần Bắt đầu sử dụng

Chuẩn bị ứng dụng

Để gỡ lỗi, bạn cần tương tác với trình đơn gỡ lỗi của SDK. Cách mở trình đơn được đề xuất là đưa hàm bên dưới vào ứng dụng của bạn và kích hoạt hàm đó dựa trên hành động của người dùng:

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];
}

Mọi đơn vị quảng cáo hợp lệ trong tài khoản Ad Manager đều đủ điều kiện để mở trình đơn lựa chọn gỡ lỗi.

Nhận thông báo khi trình đơn gỡ lỗi đóng

Khi mở trình đơn tuỳ chọn gỡ lỗi theo phương thức lập trình, bạn có thể chọn triển khai GADDebugOptionsViewControllerDelegate để nhận thông báo khi bộ điều khiển chế độ xem bị đóng. Để thực hiện việc này, hãy làm cho lớp của bạn tuân thủ uỷ quyền:

Swift

import GoogleMobileAds
 
class ViewController: UIViewController, GADDebugOptionsViewControllerDelegate {
}

Objective-C

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

Đặt uỷ quyền trên 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];
}

Cuối cùng, hãy triển khai uỷ quyền:

Swift

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

Objective-C

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

Sau khi thêm chức năng mở trình đơn tuỳ chọn gỡ lỗi, hãy chạy ứng dụng và kích hoạt chức năng ở trên. Trình đơn sau sẽ mở ra:

Chọn Xem trước mẫu quảng cáo để liên kết thiết bị. Một trình duyệt sẽ mở ra và tự động chuyển bạn đến một trình duyệt để đăng nhập vào Ad Manager. Sau khi đăng nhập thành công, hãy đặt tên cho thiết bị để đăng ký thiết bị với tài khoản Ad Manager của bạn, rồi nhấp vào Xác minh.

Bạn đã liên kết thiết bị thành công! Tại thời điểm này, bạn có thể thấy thiết bị của mình được liên kết trong giao diện người dùng Ad Manager. Bạn cũng có thể cho phép người khác truy cập vào thiết bị của bạn.

Xem trước trong ứng dụng

Làm theo các bước để đẩy mẫu quảng cáo đến thiết bị được liên kết. Đảm bảo rằng mẫu quảng cáo được đẩy là một phần của mục hàng đang hoạt động được nhắm đến vị trí quảng cáo mà bạn muốn thấy mẫu quảng cáo.

Sau khi đẩy một mẫu quảng cáo từ giao diện người dùng, hãy kích hoạt lại trình đơn tuỳ chọn gỡ lỗi trên thiết bị của bạn và chọn lại Xem trước mẫu quảng cáo. Bước này cho phép SDK kiểm tra lại Ad Manager để xác minh rằng quá trình liên kết thiết bị đã thành công và để nhận một số thông tin về mẫu quảng cáo mà bạn đã đẩy. Nếu trước đó bạn đã liên kết thiết bị thành công, thì trình đơn gỡ lỗi sẽ đóng ngay lập tức. Nếu không thành công, bạn sẽ được nhắc liên kết lại tài khoản.

Cuối cùng, hãy tải một quảng cáo cho vị trí mà bạn muốn xem trước để xem mẫu quảng cáo của mình!

Trình kiểm tra phân phối

Làm theo các bước Bắt đầu khắc phục sự cố ứng dụng để khắc phục sự cố ứng dụng. Nếu hoàn tất các bước thành công, yêu cầu sẽ xuất hiện ở giao diện người dùng Ad Manager và bạn có thể xem thêm thông tin về quảng cáo đã phân phát.