ผสานรวมอะแดปเตอร์สัญญาณที่ปลอดภัย

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

สัญญาณที่ปลอดภัยคือข้อมูลที่เข้ารหัสซึ่งรวบรวมในอุปกรณ์ของไคลเอ็นต์และแชร์กับผู้เสนอราคาที่เลือก คู่มือนี้จะแสดงวิธีรวบรวมและส่งสัญญาณที่ปลอดภัยไปยัง Google Ad Manager โดยใช้ IMA SDK

Secure Signals API ต้องใช้ IMA SDK สำหรับ tvOS เวอร์ชัน 4.8.2 ขึ้นไป

หากต้องการเลือกสัญญาณและผู้เสนอราคา รวมถึงเปิดใช้การแชร์สัญญาณที่ปลอดภัย โปรดดูแชร์ สัญญาณที่ปลอดภัยกับผู้เสนอราคา

ใช้ผู้ให้บริการสัญญาณบุคคลที่สาม

หากต้องการใช้สัญญาณที่ปลอดภัย คุณต้องติดตั้งใช้งานคลาสอะแดปเตอร์ตัวรวบรวมสัญญาณ ในแอป เพื่อรวบรวมสัญญาณ เข้ารหัสสัญญาณ และส่งสัญญาณไปยัง IMA SDK

ทำตามวิธีการของผู้ให้บริการบุคคลที่สามเพื่อสร้างบัญชีกับผู้ให้บริการ รวมถึงเฟรมเวิร์ก, และตั้งค่าอะแดปเตอร์สัญญาณที่ปลอดภัยในแอป

IMA SDK สำหรับ tvOS จะเริ่มต้นใช้งานอะแดปเตอร์สัญญาณที่ปลอดภัยแต่ละรายการโดยอัตโนมัติโดยไม่ต้องทำการเปลี่ยนแปลงโค้ดเพิ่มเติม

ตัวอย่างวิธีเพิ่มอะแดปเตอร์สัญญาณที่ปลอดภัยลงในโปรเจ็กต์

ส่งข้อมูลที่กำหนดเอง

นอกจากการใช้ผู้ให้บริการสัญญาณบุคคลที่สามแล้ว คุณยังรวบรวม เข้ารหัส และส่งสัญญาณด้วยข้อมูลที่กำหนดเองได้ด้วย คุณต้องเปิดสัญญาณที่กำหนดเองใน Ad Manager ก่อนจึงจะส่งสัญญาณที่ปลอดภัยพร้อมข้อมูลที่กำหนดเองได้

ทำดังนี้สำหรับคำขอโฆษณาแต่ละรายการ

1. สร้างออบเจ็กต์ IMASecureSignals ที่มีข้อมูลที่กำหนดเองที่เข้ารหัสเป็นสตริง
2. เพิ่มออบเจ็กต์ IMASecureSignals ลงในคำขอโฆษณาโดยตั้งค่าแอตทริบิวต์ IMAAdsRequest.secureSignals ดังนี้

Objective-C

BasicExample/ViewController.m

...
- (void)requestAds {
  // Create an ad display container for ad rendering.
  IMAAdDisplayContainer *adDisplayContainer =
      [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                          viewController:self
                                          companionSlots:nil];
  // Create an ad request with our ad tag, display container, and optional user context.
  IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:kTestAppAdTagUrl
                                                adDisplayContainer:adDisplayContainer
                                                   contentPlayhead:self.contentPlayhead
                                                       userContext:nil];
  
  IMASecureSignals *signals =
      [[IMASecureSignals alloc] initWithCustomData:@"My encoded signal string"];
  request.secureSignals = signals;
  
  [self.adsLoader requestAdsWithRequest:request];
}
...

Swift

BasicExample/ViewController.swift

...
private func requestAds() {
  // Create ad display container for ad rendering.
  let adDisplayContainer = IMAAdDisplayContainer(
    adContainer: videoView, viewController: self, companionSlots: nil)
  // Create an ad request with our ad tag, display container, and optional user context.
  let request = IMAAdsRequest(
    adTagUrl: ViewController.testAppAdTagURL,
    adDisplayContainer: adDisplayContainer,
    contentPlayhead: contentPlayhead,
    userContext: nil)
  
  let signals = IMASecureSignals(customData: "My encoded signal string")
  request.secureSignals = signals
  
  adsLoader.requestAds(with: request)
}
...