מדריך השילוב של Protected Audience (לשעבר FLEDGE) לספקי מדידה

במסגרת ארגז החול לפרטיות, הצעה מ-Chrome קהל מוגן API – API בדפדפן שמאפשר למפרסמים ולחברות פרסום דיגיטלי להציג מודעות שמטורגטות לקבוצות של תחומי עניין בלי להסתמך על קובצי cookie של צד שלישי, ובמקביל להגן על המשתמשים מפני מעקב.

ב-Protected Audience API, כשמודעת רימרקטינג זוכה במכרז, העיבוד כתובת ה-URL של המודעה תישלח אל Fenced מסגרת עבור ברינדור. מסגרת מתוחכמת היא רכיב HTML מוצע לתוכן מוטמע, שדומה ל-iframe. בניגוד לרכיבי iframe, מסגרת מגודרת מגבילה את התקשורת עם הקשר ההטמעה כדי לאפשר למסגרת גישה לנתונים מאתרים שונים לשתף אותו עם ההקשר של ההטמעה. פרטים נוספים זמינים תרחישים לדוגמה של Fenced Frames הודעת הסבר.

תצוגה ו Video 360 תומך ברשימה של פקודות מאקרו למדידה הספק שמשמש למעקב אחר חשיפות וקליקים. רק תת-קבוצה קטנה מהם ניתן להחליף פקודות מאקרו כחלק מרינדור הקריאייטיב, בגלל היעדר הקשר ואותות של מכרזים. לדוגמה, ${PUBLISHER_ID} תעבוד ללא שינויים לתגים של ספק המדידה.

מדריך זה מיועד לשותפים למדידת ביצועים של מודעות שעוקבים אחרי אירועים למפרסמים שימוש ב-Display & וידאו 360

צירוף

החל מאוגוסט 2023, יכול להיות שספקי המדידה יצטרכו לפעול לפי השלבים הבאים למטה כדי לרשום את עצמם לשימוש בממשקי API של Fenced Frame Reporting ב-Protected Audience API.

פרטים על האופן שבו ומי יקבל מענה הרשמה

שילוב

תגי חשיפות של ספק מדידה

הוראות לביצוע הגדרות:

תגי סקריפטים דוגמה 
<script src='https://tracking.com/a.js'>xxx</script>
 אחריות: ספקי מדידה צריכים לעדכן את תגי הסקריפט כך שיוכלו להשתמש בהם. ה-API של reportEvent למעקב חשיפות (להנחיות: למטה).
תגי IM דוגמה 
<img src='https://tracking.com/'>
 אחריות: תצוגה ו סרטון 360 כדי לעדכן את תגי img src לשימוש ממשק API של reportEvent למעקב אחר חשיפות.

ממשק ה-API של reportEvent

ה-API הוצע לשימוש עבור מעקב אחרי עיבוד בלבד. ה-API מכיל שני חלקים: registerAdMacro ו reportEvent.

  • תצוגה ו סרטון 360 הוא הבעלים של הפונקציה registerAdMacro ב-reportWin. הפונקציה תרשום צמדי מפתח-ערך של מאקרו בדפדפן לפני שהפונקציה תהליך רינדור.
  • בהתאם לסוג התג, האפשרויות Display & [רשת המדיה] ספקי וידאו 360 או ספקי מדידה הם הבעלים את השינויים בתגי 3PAT כדי להשתמש ב-API reportEvent.

הפרמטר reportEvent מקבל רק קלט אחד של 'destinationURL', שמצביע לשרתים של ספקי מדידה. היא יכולה להכיל כל פקודת מאקרו שמופיעה תצוגה ו עזרה בנושא Video 360 מרכז. לדוגמה:

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

כש-Chrome מפעיל פינג של כתובת URL בפונקציה, הוא ייראה רשום מאקרו ומחליפים אותם בערכים לפני ששולחים בקשת HTTP GET https://adtech.example

השלבים לעדכון תגי סקריפט

לא יהיה שינוי בתגי הקריאייטיב הקיימים. תצוגה ו תמונת סטילס ב-Video 360 מעבד את התגים של ספק המדידה ללא שינוי כחלק מהקריאייטיב מטען ייעודי (payload). כשספקי מדידה מקבלים פינגים של חשיפות ממערכת Protected לצורך קבלת הקשר ל-Audience API, צריך לבצע את השלבים הבאים לגבי חשיפה tracking:

  1. צריך להכין כתובת URL לחשיפה של ספק מדידה כדי לקבל את הפינגים של החשיפות. לדוגמה:

    https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123

  2. הוספת JS reportEvent כשמגיבים לסקריפט מ-Protected Audience API. לדוגמה:

    window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

  3. רישום חשיפות בזמן קבלת פינגים מכתובת ה-URL לחשיפה שהוגדרה ב- שלב 1.

משתני Click Tag של ספק המדידה

תג הקליק הקיים של ספק המדידה ימשיך לפעול עבור חשיפות של Protected Audience. תצוגה ו מערכת Video 360 תשתמש ב-Fenced Frames Ads Reporting API אות reserved.top_navigation לתיעוד קליקים, ולשרשרת של כל המודעות שירותי מעקב אחר קליקים של ספק מדידה כהפניות אוטומטיות. פרטים נוספים זמינים במאמר מסמכי התיעוד של Chrome לגבי דיווח על מודעות Fenced Frame API.