สัญญาณที่ปลอดภัยคือข้อมูลที่เข้ารหัสซึ่งรวบรวมในอุปกรณ์ไคลเอ็นต์และแชร์กับผู้เสนอราคาบางราย คู่มือนี้จะแสดงวิธีรวบรวมและส่งสัญญาณที่ปลอดภัยไปยัง Google Ad Manager โดยใช้ IMA SDK
หากต้องการเลือกสัญญาณและผู้เสนอราคา รวมถึงเปิดใช้การแชร์สัญญาณที่ปลอดภัย โปรดดูแชร์สัญญาณที่ปลอดภัยกับผู้เสนอราคา
ใช้ผู้ให้บริการสัญญาณของบุคคลที่สาม
หากต้องการใช้สัญญาณที่ปลอดภัย คุณต้องติดตั้งใช้งานสคริปต์ผู้รวบรวมสัญญาณในเว็บไซต์เพื่อรวบรวม เข้ารหัส และส่งสัญญาณไปยัง IMA SDK
คุณติดตั้งใช้งานสคริปต์สัญญาณที่ปลอดภัยโดยอัตโนมัติหรือด้วยตนเองก็ได้
ติดตั้งใช้งานโดยอัตโนมัติ
เมื่อเลือกผู้ให้บริการสัญญาณใน Ad Manager คุณอาจเห็นตัวเลือกขอให้ Google ติดตั้งใช้งานสคริปต์รวบรวมสัญญาณในนามของคุณ ทั้งนี้ขึ้นอยู่กับผู้ให้บริการสัญญาณที่เลือก หากเลือกตัวเลือกนี้และเว็บไซต์มีแท็กผู้เผยแพร่โฆษณาผ่าน Google ระบบจะโหลดสคริปต์รวบรวมสัญญาณที่คุณเลือกไว้โดยอัตโนมัติ
ต่อไปนี้คือตัวอย่างสิ่งที่คุณอาจเห็นใน UI ของ Ad Manager
ต่อไปนี้คือตัวอย่างสิ่งที่คุณอาจเห็นในไฟล์ 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 หรือไม่ได้เปิดตัวเลือกนี้ คุณต้องขอลิงก์สคริปต์จากผู้ให้บริการสัญญาณที่ปลอดภัย แล้วรวมไว้ในโปรเจ็กต์ด้วยตนเอง
ต่อไปนี้คือตัวอย่างสิ่งที่คุณอาจเห็นใน UI ของ Ad Manager
ต่อไปนี้คือตัวอย่างสิ่งที่คุณอาจเห็นในไฟล์ 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 มีดังนี้
- สร้างออบเจ็กต์ที่มีพร็อพเพอร์ตี้
networkCodeและcollectorFunction - ป้อนข้อมูลพร็อพเพอร์ตี้
networkCodeด้วยรหัสเครือข่าย - ป้อนข้อมูลพร็อพเพอร์ตี้
collectorFunctionด้วยฟังก์ชันที่แสดงผล Promise ซึ่งจะแก้ไขเป็นสัญญาณที่เข้ารหัส
พุชออบเจ็กต์ไปยังอาร์เรย์ googletag.secureSignalProviders ก่อนสร้างอินสแตนซ์ adsLoader เพื่อให้ IMA SDK เข้าถึงเพื่อดึงข้อมูลและส่งสัญญาณที่เข้ารหัสได้
ตัวอย่าง JavaScript
ads.js
...
console.log("initializing IMA");
adContainer = document.getElementById('ad-container');
adDisplayContainer = new google.ima.AdDisplayContainer(adContainer, videoElement);
const NETWORK_CODE = '12345678901';
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);
...