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

เลือกแพลตฟอร์ม: Android ใหม่ Android iOS

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

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

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

หากต้องการให้แอปทราบข้อมูลเพิ่มเติมเกี่ยวกับโฆษณาที่แสดง ให้ตั้งค่าโฆษณาให้เป็น GADAdMetadataDelegate ของตัวเอง จากนั้นคุณจะรอฟังการเปลี่ยนแปลงข้อมูลเมตาของโฆษณาได้โดยใช้เมธอด adMetadataDidChange: ใน GADAdMetadataDelegate เมื่อมีการเรียกใช้ Delegate นี้แล้ว ให้ตรวจสอบพร็อพเพอร์ตี้ adMetadata ในโฆษณา

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

ต่อไปนี้เป็นตัวอย่างโค้ดที่แสดงวิธีดึงข้อมูลเมตาของโฆษณาสำหรับโฆษณาที่มีการให้รางวัล

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [GAMRequest request];
  [GADRewardedAd
       loadWithAdUnitID:@"ca-app-pub-3940256099942544/4806952744"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        self.rewardedAd.fullScreenContentDelegate = self;

        /// Set the ad to be the delegate of its ad metadata.
        self.rewardedAd.adMetadataDelegate = self;

        NSLog(@"Rewarded ad loaded.");
      }];
}

/#pragma mark GADAdMetadataDelegate implementation

- (void)adMetadataDidChange:(id<GADAdMetadataProvider>)ad {
  NSDictionary<NSString*, id> *adMetadata = _rewardedAd.adMetadata;
  NSString *adId = adMetadata[@"AdId"];
}

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

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