אותות מאובטחים הם נתונים מוצפנים שנאספים במכשיר הלקוח ומשותפים עם בידינגרים נבחרים. במדריך הזה מוסבר איך לאסוף ולשלוח אותות מאובטחים אל Google Ad Manager באמצעות IMA SDK.
במאמר שיתוף אותות מאובטחים עם בידינגרים מוסבר איך לבחור אותות ובידינגרים ולהפעיל שיתוף של אותות מאובטחים.
שימוש בספק אותות של צד שלישי
כדי להשתמש באותות מאובטחים, צריך לפרוס באתר סקריפט לאיסוף אותות כדי לאסוף את האותות, לקודד אותם ולהעביר אותם ל-IMA SDK.
אפשר לפרוס סקריפטים של אותות מאובטחים באופן אוטומטי או ידני.
פריסה אוטומטית
כשבוחרים ספקי אותות ב-Ad Manager, בהתאם לספקי האותות שבחרתם, עשויה להופיע האפשרות לבקש מ-Google לפרוס את הסקריפט לאיסוף האותות בשמכם. אם בוחרים באפשרות הזו והאתר כולל תגי Google Publisher Tag, הסקריפטים של כלי איסוף האותות שבחרתם נטענים באופן אוטומטי.
דוגמה למה שעשוי להופיע בממשק המשתמש של 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>
...
פריסה ידנית
אם האפשרות Ask Google to deploy the signal collection script on your behalf (בקשה ל-Google לפרוס את הסקריפט לאיסוף האותות בשמכם) לא מופיעה ב-Ad Manager, או אם לא מפעילים את האפשרות הזו, צריך לקבל קישור לסקריפט מהספק של האותות המאובטחים ולכלול אותו באופן ידני בפרויקט.
דוגמה למה שעשוי להופיע בממשק המשתמש של 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בפונקציה שמחזירה הבטחה שמתמירה לאותות המקודדים.
צריך לדחוף את האובייקט למערך 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);
...