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

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

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

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

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

צירוף

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

פרטים על ההרשמה ועל מי יצטרך להירשם

שילוב

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

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

• Display & Video 360
• Campaign Manager 360

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

ממשק API של reportEvent

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

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

ב-reportEvent נדרש רק קלט אחד של 'destinationURL', שמפנה לשרתים של ספק המדידה. הוא יכול לכלול את כל פקודות המאקרו שרשומות במרכז העזרה של Display & 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.

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

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

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

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

2. הוספת reportEvent JS בתגובה לסקריפט מ-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. מערכת Display & Video 360 תשתמש בחיישן reserved.top_navigation של Fenced Frames Ads Reporting API כדי לרשום קליקים, והיא תשרשר את כל הכלים למעקב אחר קליקים של ספק המדידה כהפניות אוטומטיות. לפרטים נוספים, עיינו במסמכי התיעוד של Chrome לממשק API לדיווח על מודעות Fenced Frame Ads.