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

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

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

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

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

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

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

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

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

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

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

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

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

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);
}
...