Tài liệu hướng dẫn này dành cho những 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 cho Android.
Điều kiện tiên quyết
- SDK Quảng cáo của Google trên thiết bị di động phiên bản tối thiểu là 17.0.0.
- 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
Để biết thêm 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 đượ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.
Sau đâ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 Bundle cho 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 đượ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ã nhận dạng 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 của mẫu quảng cáo đã chọn tính bằng mili giây, -1 nếu là mẫu quảng cáo phi tuyến tính. |
TraffickingParameters |
Chuỗi | Tham số phân phố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ã nhận dạng 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 sẵn các phần tử bắt đầu từ quảng cáo có trình bao bọc trong cùng (gần với quảng cáo trong dòng) di chuyển ra ngoài đến quảng cáo có 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.
|