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

เลือกแพลตฟอร์ม Android iOS

คู่มือนี้มีไว้สำหรับผู้เผยแพร่โฆษณาที่ผสานรวมข้อมูลเมตาของโฆษณากับ 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"];
}

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

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