สัญญาณที่ปลอดภัย

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

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

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

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

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

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

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

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

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

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

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

สําหรับคําขอโฆษณาแต่ละรายการ ให้สร้างออบเจ็กต์ SecureSignals ที่มีข้อมูลที่กำหนดเองซึ่งเข้ารหัสแล้วในรูปแบบสตริง จากนั้นเพิ่มออบเจ็กต์ SecureSignals ลงในคําขอโฆษณาโดยเรียกใช้ adsRequest.setSecureSignals()

ตัวอย่าง Java มีดังนี้

app/src/main/java/com/example/project name/MainActivity.java

...
private void requestAds(String adTagUrl) {
  // Create the ads request.
  AdsRequest request = sdkFactory.createAdsRequest();
  request.setAdTagUrl(adTagUrl);
  request.setContentProgressProvider(
      () -> {
        if (videoPlayer.getDuration() <= 0) {
          return VideoProgressUpdate.VIDEO_TIME_NOT_READY;
        }
        return new VideoProgressUpdate(
            videoPlayer.getCurrentPosition(), videoPlayer.getDuration());
      });
  
  SecureSignals signal = SecureSignals.create("My encoded signal string");
  request.setSecureSignals(signal);
  
  // Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
  adsLoader.requestAds(request);
}
...