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

Tài liệu hướng dẫn này dành cho các nhà xuất bản 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 dành cho Android.

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

  • Phiên bản tối thiểu 17.0.0 của SDK quảng cáo trên thiết bị di động của Google.
  • Hoàn thành các bước trong phần Video có tặng thưởng.

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

Một số ứng dụng có thể muốn biết thêm về quảng cáo đã được phân phát. Bạn có thể nhận thông báo về các thay đổi đối với siêu dữ liệu quảng cáo trên quảng cáo dạng video có tặng thưởng bằng cách gọi RewardedVideoAd.setAdMetadataListener() với cách triển khai AdMetadataListener. Sau khi AdMetadataListener.onAdMetadataChanged() được gọi, bạn có thể kiểm tra RewardedVideo.getAdMetadata() để biết siêu dữ liệu của quảng cáo.

onAdMetadataChanged() được gọi ngay sau khi 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. Không đảm bảo rằng siêu dữ liệu của quảng cáo sẽ có sẵn tại thời điểm quảng cáo được 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:

Java

RewardedAd.load(this, "/21775744923/example/rewarded", new AdManagerAdRequest.Builder().build(),
    new RewardedAdLoadCallback() {
      @Override
      public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
        mRewardedAd = rewardedAd;
        rewardedAd.setOnAdMetadataChangedListener(new OnAdMetadataChangedListener() {
          @Override
          public void onAdMetadataChanged() {
            Bundle metadata = rewardedAd.getAdMetadata();
            String adId = metadata.getString("AdId");
          }
        });
      }
    });

Kotlin

RewardedAd.load(this, "/21775744923/example/rewarded", AdManagerAdRequest.Builder().build(),
                    object : RewardedAdLoadCallback() {
      override fun onAdLoaded(rewardedAd: RewardedAd) {
        mRewardedAd = rewardedAd
        rewardedAd.onAdMetadataChangedListener = OnAdMetadataChangedListener {
          val metadata = rewardedAd.adMetadata
          val adId = metadata.getString("AdId")
        }
      }
    })

Sau khi truy xuất siêu dữ liệu, bạn có thể kiểm tra Gói để biết các khoá mà bạn quan tâm. Các loại quảng cáo 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:

Key Loại Mô tả
AdId Chuỗi Mã của quảng cáo, để 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 không phải là mẫu quảng cáo phi tuyến tính.
TraffickingParameters Chuỗi Tham số về hoạt động buôn bán ngườ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 – trống nếu không có.
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ó.
CreativeId Chuỗi Mã của mẫu quảng cáo đã chọn cho quảng cáo, để trống nếu không có.
MediaURL Chuỗi URL của nội dung đa phương tiện đã chọn.
Wrappers Mảng Mảng này được điền sẵn các phần tử bắt đầu từ quảng cáo trình bao bọc trong cùng (gần quảng cáo nội tuyến) di chuyển ra ngoài đến quảng cáo trình 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ã nhận dạng 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ó.