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

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

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

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

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

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

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

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

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

Java

RewardedAd.load(this, "/6499/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, "/6499/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`	Type	คำอธิบาย
`AdId`	สตริง	รหัสโฆษณา, เว้นว่างไว้หากไม่มี
`AdTitle`	สตริง	ชื่อจะเว้นว่างไว้หากไม่ได้ระบุไว้
`CreativeDurationMs`	จำนวนเต็ม	ระยะเวลาของครีเอทีฟโฆษณาที่เลือกเป็นมิลลิวินาที และ -1 หากไม่ใช่แบบเชิงเส้น
`TraffickingParameters`	สตริง	พารามิเตอร์การดูแลการแสดงโฆษณา เว้นว่างไว้หากไม่มี
`DealId`	สตริง	รหัสดีลแรกที่แสดงในห่วงโซ่ Wrapper สำหรับโฆษณาปัจจุบัน โดยเริ่มจากรหัสด้านบน-ว่างเปล่าหากไม่มี
`AdSystem`	สตริง	เซิร์ฟเวอร์โฆษณาต้นทางของโฆษณาจะเว้นว่างไว้หากไม่มี
`CreativeId`	สตริง	รหัสของครีเอทีฟโฆษณาที่เลือกสำหรับโฆษณา ซึ่งเว้นว่างไว้หากไม่มี
`MediaURL`	สตริง	URL ของสื่อที่เลือก
`Wrappers`	อาร์เรย์	อาร์เรย์สร้างขึ้นด้วยองค์ประกอบที่เริ่มจากโฆษณา Wrapper ด้านในสุด (ใกล้กับโฆษณาแบบอินไลน์) ที่ย้ายออกไปยังโฆษณา Wrapper ชั้นนอกสุด องค์ประกอบแต่ละรายการในอาร์เรย์คือพจนานุกรมที่มีคีย์และค่าต่อไปนี้ `AdId` สตริง รหัสโฆษณาที่ใช้สำหรับโฆษณาแบบ Wrapper ว่างเปล่าหากไม่มี `AdSystem` สตริง ระบบโฆษณาที่ใช้สำหรับโฆษณา Wrapper จะเว้นว่างไว้หากไม่มี `CreativeId` สตริง รหัสครีเอทีฟโฆษณาที่ใช้สำหรับโฆษณาแบบ Wrapper ว่างเปล่าหากไม่มี