Siêu dữ liệu quảng cáo

Hướng dẫn này dành cho các nhà xuất bản đang tích hợp siêu dữ liệu quảng cáo với SDK quảng cáo trên thiết bị di động của Google cho iOS.

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

Đang tìm nạp siêu dữ liệu quảng cáo

Để một ứng dụng biết thêm về các quảng cáo được phân phát, hãy đặt quảng cáo đó thành GADAdMetadataDelegate của riêng ứng dụng đó. Sau đó, bạn có thể theo dõi các thay đổi về siêu dữ liệu quảng cáo bằng cách triển khai phương thức adMetadataDidChange: trên GADAdMetadataDelegate. Sau khi phương thức uỷ quyền này được gọi, hãy kiểm tra thuộc tính adMetadata trên quảng cáo.

adMetadataDidChange: được gọi ngay sau khi một quảng cáo tải hoặc khi siêu dữ liệu của quảng cáo thay đổi không đồng bộ sau khi tải. Chúng tôi không đảm bảo rằng siêu dữ liệu quảng cáo sẽ hoạt động tại thời điểm tải. Vì vậy, bạn nên đợi lệnh gọi lại này trước khi truy cập vào siêu dữ liệu của quảng cáo.

Dưới đây là ví dụ về mã cho thấy cách truy xuất siêu dữ liệu quảng cáo cho quảng cáo có tặng thưởng:

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [ request];
  [GADRewardedAd
       loadWithAdUnitID:@"ca-app-pub-3940256099942544/4806952744"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        self.rewardedAd.fullScreenContentDelegate = self;

        /// Set the ad to be the delegate of its ad metadata.
        self.rewardedAd.adMetadataDelegate = self;

        NSLog(@"Rewarded ad loaded.");
      }];
}

/#pragma mark GADAdMetadataDelegate implementation

- (void)adMetadataDidChange:(id<GADAdMetadataProvider>)ad {
  NSDictionary<NSString*, id> *adMetadata = _rewardedAd.adMetadata;
  NSString *adId = adMetadata[@"AdId"];
}

Sau khi truy xuất siêu dữ liệu, bạn có thể kiểm tra Gói để tìm các khoá mà bạn quan tâm. Các loại quảng cáo khác nhau có thể có các khoá siêu dữ liệu quảng cáo khác nhau liên kết với chúng. Quảng cáo dạng video VAST có các khoá sau:

Khoá Loại Mô tả
AdId Chuỗi Mã của quảng cáo hoặc chuỗi trống nếu không có.
AdTitle Chuỗi Tiêu đề, để trống nếu không được chỉ định.
CreativeDurationMs Số nguyên Thời lượng mẫu quảng cáo đã chọn tính bằng mili giây, -1 nếu quảng cáo phi tuyến tính.
TraffickingParameters Chuỗi Thông số quản lý quảng cáo hoặc chuỗi trống nếu không có.
DealId Chuỗi Mã giao dịch đầu tiên có trong chuỗi trình bao bọc cho quảng cáo hiện tại, bắt đầu từ trên cùng hoặc chuỗi trống nếu không có thông tin này.
AdSystem Chuỗi Máy chủ quảng cáo nguồn của quảng cáo, trống nếu không có sẵn.
CreativeId Chuỗi Mã của mẫu quảng cáo được chọn cho quảng cáo, để trống nếu không có.
MediaURL Chuỗi URL của nội dung nghe nhìn đã chọn.
Wrappers Mảng Mảng này được điền sẵn các phần tử bắt đầu ở quảng cáo trình bao bọc trong cùng (gần với quảng cáo cùng dòng) di chuyển ra ngoài quảng cáo bao bọc ngoài cùng. Mỗi phần tử trong mảng là một từ điển chứa các khoá và giá trị sau.
AdId
Chuỗi. Mã quảng cáo dùng cho quảng cáo trình bao bọc, để trống nếu không có.
AdSystem
Chuỗi. Hệ thống quảng cáo dùng cho quảng cáo trình bao bọc, để trống nếu không có.
CreativeId
Chuỗi. Mã mẫu quảng cáo dùng cho quảng cáo trình bao bọc, để trống nếu không có.