คู่มือนี้มีไว้สำหรับผู้เผยแพร่โฆษณาที่ผสานรวมข้อมูลเมตาของโฆษณากับ Google Mobile Ads SDK สำหรับ Android
ข้อกำหนดเบื้องต้น
- Google Mobile Ads SDK เวอร์ชันขั้นต่ำ 17.0.0
- ทำตามขั้นตอนใน วิดีโอที่มีการให้รางวัล.
การดึงข้อมูลเมตาของโฆษณา
หากต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับโฆษณาที่แสดง ให้ฟังการเปลี่ยนแปลงข้อมูลเมตาของโฆษณาในโฆษณาวิดีโอที่มีการให้รางวัล
ระบบจะเรียกใช้ onAdMetadataChanged() ทันทีหลังจากที่โฆษณาโหลดหรือเมื่อข้อมูลเมตาของโฆษณาเปลี่ยนแปลงแบบไม่พร้อมกันหลังจากที่โหลด ระบบไม่รับประกันว่าข้อมูลเมตาของโฆษณาจะพร้อมใช้งานในขณะที่โหลดโฆษณา ดังนั้นเราขอแนะนำให้รอ Callback นี้ก่อนที่จะเข้าถึงข้อมูลเมตาของโฆษณา
ต่อไปนี้เป็นตัวอย่างโค้ดที่แสดงวิธีดึงข้อมูลเมตาของโฆษณา
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");
}
});
};
};
);
แทนที่หน่วยโฆษณา AD_UNIT_ID เช่น /21775744923/example/rewarded สำหรับโฆษณาที่มีการให้รางวัล
หลังจากดึงข้อมูลเมตาแล้ว คุณสามารถตรวจสอบ Bundle เพื่อดูคีย์ที่ต้องการได้ โฆษณาประเภทต่างๆ อาจมีคีย์ข้อมูลเมตาของโฆษณาที่แตกต่างกันซึ่งเชื่อมโยงกับโฆษณานั้นๆ โฆษณาวิดีโอ VAST มีคีย์ต่อไปนี้
Key |
ประเภท | คำอธิบาย |
|---|---|---|
AdId |
สตริง | รหัสของโฆษณา หากไม่มีจะแสดงเป็นค่าว่าง |
AdTitle |
สตริง | ชื่อ หากไม่ได้ระบุจะแสดงเป็นค่าว่าง |
CreativeDurationMs |
จำนวนเต็ม | ระยะเวลาของครีเอทีฟโฆษณาที่เลือกเป็นมิลลิวินาที หากไม่ใช่แบบเชิงเส้นจะแสดงเป็น -1 |
TraffickingParameters |
สตริง | พารามิเตอร์การแสดงโฆษณา หากไม่มีจะแสดงเป็นค่าว่าง |
DealId |
สตริง | รหัสดีลแรกที่อยู่ในเชน Wrapper สำหรับโฆษณาปัจจุบัน โดยเริ่มจากด้านบน หากไม่มีจะแสดงเป็นค่าว่าง |
AdSystem |
สตริง | เซิร์ฟเวอร์โฆษณาต้นทางของโฆษณา หากไม่มีจะแสดงเป็นค่าว่าง |
CreativeId |
สตริง | รหัสของครีเอทีฟโฆษณาที่เลือกสำหรับโฆษณา หากไม่มีจะแสดงเป็นค่าว่าง |
MediaURL |
สตริง | URL ของสื่อที่เลือก |
Wrappers |
อาร์เรย์ |
อาร์เรย์จะป้อนข้อมูลองค์ประกอบโดยเริ่มจากโฆษณา Wrapper ด้านในสุด (ใกล้กับโฆษณาในบรรทัด) ไปยังโฆษณา Wrapper ด้านนอกสุด แต่ละ
องค์ประกอบในอาร์เรย์เป็นพจนานุกรมที่มีคีย์และ
ค่าต่อไปนี้
|