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
- SDK quảng cáo trên thiết bị di động của Google phiên bản tối thiểu là 17.0.0.
- Hoàn thành các bước trong Quảng cáo dạng video có tặng thưởng.
Tìm nạp siêu dữ liệu quảng cáo
Để biết thêm thông tin về quảng cáo được phân phát, hãy theo dõi các thay đổi về siêu dữ liệu quảng cáo trên quảng cáo dạng video có tặng thưởng.
onAdMetadataChanged() đượ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 quảng cáo tải. Không có gì đả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
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
.
Sau đây là ví dụ về mã cho biết cách truy xuất siêu dữ liệu quảng cáo:
Kotlin
RewardedAd.load(
AdRequest.Builder("AD_UNIT_ID").build(),
object : AdLoadCallback<RewardedAd> {
override fun onAdLoaded(ad: RewardedAd) {
...
ad.adEventCallback = object : RewardedAdEventCallback {
override fun onAdMetadataChanged() {
val metadata = ad.adMetadata
val adId = metadata.getString("AdId")
}
}
}
})
Java
RewardedAd.load(
new AdRequest.Builder("AD_UNIT_ID").build(),
new AdLoadCallback<RewardedAd>() {
@Override
public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
Rewarded.this.rewardedAd = rewardedAd;
...
rewardedAd.setAdEventCallback(new RewardedAdEventCallback() {
@Override
public void onAdMetadataChanged() {
Bundle metadata = rewardedAd.getAdMetadata();
String adId = metadata.getString("AdId");
}
});
};
};
);
Thay thế đơn vị quảng cáo AD_UNIT_ID. Ví dụ:
/21775744923/example/rewarded cho quảng cáo có tặng thưởng.
Sau khi truy xuất siêu dữ liệu, bạn có thể kiểm tra Gói cho các khoá mà bạn quan tâm về. 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 được 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à quảng cáo tuyến tính. |
TraffickingParameters |
Chuỗi | Tham số phân phát, để trống nếu không có. |
DealId |
Chuỗi | Mã thoả thuận đầ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 nghe nhìn đã chọn. |
Wrappers |
Mảng |
Mảng này được điền bằng các phần tử bắt đầu từ 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 đế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.
|