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

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

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

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

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

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

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

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [ 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"];
}

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

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