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 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.
Đang 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ể
theo dõi những thay đổi về siêu dữ liệu quảng cáo trên quảng cáo video có tặng thưởng bằng cách gọi
RewardedVideoAd.setAdMetadataListener()
bằng cách triển khai
AdMetadataListener
. Sau khi gọi AdMetadataListener.onAdMetadataChanged()
,
bạn có thể kiểm tra RewardedVideo.getAdMetadata()
để biết siêu dữ liệu của một 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
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
do đó bạn nên đợi cuộc gọi lại này trước khi truy cập vào
siêu dữ liệu.
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 để tìm các khoá 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à mẫu quảng cáo phi tuyến tính. |
TraffickingParameters |
Chuỗi | Thông số quản lý quảng cáo, trống nếu không có. |
DealId |
Chuỗi | Mã giao dịch đầu tiên xuất hiện trong chuỗi trình bao bọc cho quảng cáo hiện tại, bắt đầu từ phần 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 đượ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 phía ngoài so với quảng cáo bao bọc ngoài cùng. Một
phần tử trong mảng là một từ điển chứa các khoá và
giá trị.
|