Google Mobile Ads SDK อยู่ในโหมดการบำรุงรักษา หากต้องการทราบข้อมูลอัปเดตและฟีเจอร์ล่าสุด โปรดmigrateและตั้งค่า GMA Next-Gen SDK

Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

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

เลือกแพลตฟอร์ม: Android iOS Android (เวอร์ชันเก่า)

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

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

Google Mobile Ads SDK เวอร์ชัน 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 หากไม่มีจะแสดงเป็นค่าว่าง