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

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

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

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

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

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

คุณติดตั้งใช้งานสคริปต์สัญญาณที่ปลอดภัยโดยอัตโนมัติหรือด้วยตนเองก็ได้

ติดตั้งใช้งานโดยอัตโนมัติ

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

ตัวอย่างสิ่งที่คุณอาจเห็นใน Ad Manager UI:

ตัวอย่างสิ่งที่คุณอาจเห็นในไฟล์ index.html ของเว็บไซต์

<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<!-- Load gpt.js, which autoloads all signal provider scripts configured to be
  deployed by Google. -->
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script src="ads.js"></script>

ติดตั้งใช้งานด้วยตนเอง

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

ตัวอย่างสิ่งที่คุณอาจเห็นใน Ad Manager UI:

ตัวอย่างสิ่งที่คุณอาจเห็นในไฟล์ index.html ของเว็บไซต์

<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<!-- Load signal provider scripts manually, using the unique instructions given by each
  signal provider. -->
<script src="//cdn.provider1.com/files/a/e/5/4/7/signalCollector.js"></script>
<script src="//provider2.co.uk/ads/signalcollector/script.min.js"></script>
<script src="/local/path/to/third_party_signal_provider_3.js"></script>
<script src="ads.js"></script>

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

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

ขั้นตอนสำหรับโปรเจ็กต์ HTML5 มีดังนี้

  1. สร้างออบเจ็กต์ที่มีพร็อพเพอร์ตี้ networkCode และ collectorFunction
  2. ป้อนรหัสเครือข่ายในพร็อพเพอร์ตี้ networkCode ด้วย รหัสเครือข่ายของคุณ
  3. ป้อนฟังก์ชันที่แสดงผล Promise ซึ่งจะแสดงผลสัญญาณที่เข้ารหัสแล้วในพร็อพเพอร์ตี้ collectorFunction

ส่งออบเจ็กต์ไปยังอาร์เรย์ googletag.secureSignalProviders ก่อน ที่จะสร้างอินสแตนซ์ `adsLoader` เพื่อให้ IMA SDK เข้าถึงออบเจ็กต์ดังกล่าวเพื่อดึงและส่งสัญญาณ ที่เข้ารหัสแล้วได้

ตัวอย่าง JavaScript

console.log("initializing IMA");
adContainer = document.getElementById('ad-container');
adDisplayContainer = new google.ima.AdDisplayContainer(adContainer, videoElement);

const NETWORK_CODE = '21775744923';

/**
 * Sample signal collector function.
 * @return {!Promise<string>} A promise that resolves to the encoded signals.
 */
const signalCollector = () => {
 return new Promise((resolve, reject) => {
   resolve("My encoded signal string");
 });
};
if (!googletag) googletag = {};
if (!googletag.secureSignalProviders) googletag.secureSignalProviders = [];
googletag.secureSignalProviders.push({
 networkCode: NETWORK_CODE,
 collectorFunction: signalCollector
});

adsLoader = new google.ima.AdsLoader(adDisplayContainer);