เริ่มต้นใช้งานสัญญาณที่ปลอดภัย

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

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

API สัญญาณที่ปลอดภัยต้องใช้ IMA SDK สำหรับ iOS เวอร์ชัน 3.18.1 ขึ้นไป

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

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

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

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

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

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

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

นอกเหนือจากการใช้ผู้ให้บริการสัญญาณบุคคลที่สามแล้ว คุณยังรวบรวม เข้ารหัส และส่งสัญญาณด้วยข้อมูลที่กำหนดเองได้ด้วย ก่อนที่จะส่งสัญญาณที่ปลอดภัย ด้วยข้อมูลที่กำหนดเอง คุณต้องเปิดใช้สัญญาณที่กำหนดเองใน 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)
}
...