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

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