หากต้องการพูดคุยและแสดงความคิดเห็นเกี่ยวกับผลิตภัณฑ์ของเรา โปรดเข้าร่วมช่อง Discord อย่างเป็นทางการของ Ad Manager ในเซิร์ฟเวอร์ชุมชนการโฆษณาและการวัดผลของ Google

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

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

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

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

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

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

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

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

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

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")
        }
      }
    })

หลังจากดึงข้อมูลเมตาแล้ว คุณจะตรวจสอบ Bundle เพื่อหาคีย์ที่ต้องการได้ โฆษณาประเภทต่างๆ อาจมีคีย์ข้อมูลเมตาของโฆษณาที่แตกต่างกันซึ่งเชื่อมโยงอยู่ โฆษณาวิดีโอ VAST มีคีย์ต่อไปนี้

`Key`	ประเภท	คำอธิบาย
`AdId`	สตริง	รหัสของโฆษณา ว่างเปล่าหากไม่มี
`AdTitle`	สตริง	ชื่อ (เว้นว่างหากไม่ได้ระบุ)
`CreativeDurationMs`	จำนวนเต็ม	ระยะเวลาของครีเอทีฟโฆษณาที่เลือกเป็นมิลลิวินาที หรือ -1 หากเป็นครีเอทีฟโฆษณาที่ไม่ใช่เชิงเส้น
`TraffickingParameters`	สตริง	พารามิเตอร์การแสดงโฆษณา เว้นว่างไว้หากไม่มี
`DealId`	สตริง	รหัสข้อตกลงแรกที่อยู่ในเชน Wrapper สำหรับโฆษณาปัจจุบัน โดยเริ่มจากด้านบนสุด (ว่างเปล่าหากไม่มี)
`AdSystem`	สตริง	เซิร์ฟเวอร์โฆษณาต้นทางของโฆษณา ว่างเปล่าหากไม่มี
`CreativeId`	สตริง	รหัสของครีเอทีฟโฆษณาที่เลือกสำหรับโฆษณา ว่างเปล่าหากไม่มี
`MediaURL`	สตริง	URL ของสื่อที่เลือก
`Wrappers`	อาร์เรย์	อาร์เรย์จะได้รับการป้อนข้อมูลด้วยองค์ประกอบที่เริ่มต้นจากโฆษณาแบบ Wrapper ด้านในสุด (ใกล้กับโฆษณาในบรรทัด) ไปยังโฆษณาแบบ Wrapper ด้านนอกสุด องค์ประกอบแต่ละรายการในอาร์เรย์คือพจนานุกรมที่มีคีย์และค่าต่อไปนี้ `AdId` สตริง รหัสโฆษณาที่ใช้สำหรับโฆษณา Wrapper ว่างเปล่าหากไม่มี `AdSystem` สตริง ระบบโฆษณาที่ใช้สำหรับโฆษณา Wrapper โดยจะเว้นว่างไว้หากไม่มี `CreativeId` สตริง รหัสครีเอทีฟโฆษณาที่ใช้สำหรับโฆษณา Wrapper ว่างเปล่าหากไม่มี