แชร์ความคิดเห็นเกี่ยวกับ GMA Next-Gen SDK ในแชแนล #gma-next-gen-sdk ของเซิร์ฟเวอร์ชุมชนการโฆษณาและการวัดผลของ Google ใน Discord

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

เลือกแพลตฟอร์ม: Android (เบต้า)

Android iOS

คู่มือนี้มีไว้สำหรับผู้เผยแพร่โฆษณาที่ผสานรวมข้อมูลเมตาของโฆษณากับ 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 ว่างเปล่าหากไม่มี