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

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

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

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

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

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

แอปบางแอปอาจต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับโฆษณาที่แสดง คุณสามารถรับฟังการเปลี่ยนแปลงข้อมูลเมตาของโฆษณาในโฆษณาวิดีโอที่มีการให้รางวัลได้โดยเรียกใช้ RewardedVideoAd.setAdMetadataListener() ด้วยการติดตั้งใช้งาน AdMetadataListener เมื่อเรียก AdMetadataListener.onAdMetadataChanged() แล้ว คุณจะสามารถตรวจสอบ RewardedVideo.getAdMetadata() เพื่อดูข้อมูลเมตาของโฆษณา

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

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

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