หน้านี้ได้รับการแปลโดย Cloud Translation API

ข้อมูลเมตาของโฆษณา

คู่มือนี้มีไว้สำหรับผู้เผยแพร่โฆษณาที่ผสานรวมข้อมูลเมตาของโฆษณากับ Google Mobile Ads SDK สำหรับ Android

ข้อกำหนดเบื้องต้น

SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 17.0.0 เป็นอย่างน้อย
ทำตามขั้นตอนในวิดีโอที่ให้รางวัล

การดึงข้อมูลเมตาของโฆษณา

หากต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับโฆษณาที่แสดง ให้ฟังการเปลี่ยนแปลงข้อมูลเมตาของโฆษณาในโฆษณาวิดีโอที่มีการให้รางวัล

onAdMetadataChanged() จะเรียกใช้ทันทีหลังจากที่โฆษณาโหลดหรือเมื่อข้อมูลเมตาของโฆษณา มีการเปลี่ยนแปลงแบบไม่พร้อมกันหลังจากที่โหลด เรารับประกันไม่ได้ ว่าข้อมูลเมตาของโฆษณาจะพร้อมใช้งานในเวลาที่โหลดโฆษณา ดังนั้นเราขอแนะนำให้รอการเรียกกลับนี้ก่อนที่จะเข้าถึงข้อมูลเมตาของโฆษณา

ตัวอย่างโค้ดที่แสดงวิธีดึงข้อมูลเมตาของโฆษณามีดังนี้

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 ด้านนอกสุด องค์ประกอบแต่ละรายการในอาร์เรย์คือพจนานุกรมที่มีคีย์และค่าต่อไปนี้ `AdId` สตริง รหัสโฆษณาที่ใช้สำหรับโฆษณา Wrapper โดยจะว่างเปล่าหากไม่มี `AdSystem` สตริง ระบบโฆษณาที่ใช้สำหรับโฆษณา Wrapper โดยจะเว้นว่างไว้หากไม่มี `CreativeId` สตริง รหัสครีเอทีฟโฆษณาที่ใช้สำหรับโฆษณา Wrapper ว่างเปล่าหากไม่มี