עיבוד מודעה

כשמכרז 'Protected Audience' מחזיר מועמד למודעה, ניתן להחזיר אותו כ-URN אטום המשמש לעיבוד מודעה ב-iframe, או כ-FencedFrameConfig שמשמש להצגת המודעה במסגרת מגודרת.

במדריך הזה נסביר מהי מסגרת מגודרת ולמה צריך אותה, ונסביר איך להציג מודעה בכל אחת מהשיטות. למבט מעמיק יותר על תמונות מגודרות, ניתן למצוא מידע נוסף במדריך זה או בהצעה.

מהן מסגרות מגודרות?

מסגרת מגודרת (<fencedframe>) היא רכיב HTML לתוכן מוטמע, שדומה ל-iframe. בניגוד ל-iframe, פריים מגודר מגביל את התקשורת עם ההקשר של ההטמעה כדי לאפשר למסגרת לגשת לנתונים מאתרים שונים בלי לשתף אותם עם ההקשר של ההטמעה. באופן דומה, אי אפשר לשתף נתונים מאינטראקציה ישירה (First-Party) בהקשר של ההטמעה עם המסגרת המגודרת.

לדוגמה, נניח ש-news.example (הקשר ההטמעה) מטמיע מודעה מ-shoes.example במסגרת מגודרת. ל-news.example אין אפשרות לזליגת נתונים מהמודעה shoes.example ול-shoes.example אין אפשרות ללמוד נתונים מאינטראקציה ישירה (First-Party) מ-news.example.

איך פועלות מסגרות מגודרות?

מסגרות מגודרות משתמשות באובייקט FencedFrameConfig לניווט. ניתן להחזיר את האובייקט הזה ממכרז של Protected Audience. לאחר מכן, אובייקט config מוגדר כמאפיין config ברכיב של ה-Fenced frame. הערך הזה שונה מ-iframe שבו כתובת URL או URN אטום מוקצים למאפיין src. לאובייקט FencedFrameConfig יש מאפיין url לקריאה בלבד. עם זאת, בגלל שתרחישי השימוש הנוכחיים מחייבים הסתרה של כתובת ה-URL בפועל של המשאב הפנימי, התכונה הזו מחזירה את המחרוזת אטומה כשהיא נקראת.

מסגרת מגודרת לא יכולה להשתמש ב-postMessage כדי לתקשר עם כלי ההטמעה שלה. עם זאת, במסגרת מגודרת אפשר להשתמש ב-postMessage עם iframe בתוך המסגרת המגודרת.

פריימים מגודרים יבודדו מבעל התוכן הדיגיטלי בדרכים אחרות. לבעל האתר לא תהיה גישה ל-DOM שבתוך מסגרת מגודרת, ולמסגרת המגודרת לא תהיה גישה ל-DOM של בעל האתר. בנוסף, מאפיינים כמו name, שבעלי התוכן הדיגיטלי יכולים להגדיר לכל ערך ולצפות בהם, לא זמינים במסגרות מגודרות.

פריימים מגודרים פועלים כמו הקשר גלישה ברמה העליונה (למשל, כרטיסייה בדפדפן). למרות שמסגרת מגודרת בתרחישים לדוגמה מסוימים (כמו opaque-ads) יכולה להכיל נתונים מאתרים שונים (כמו קבוצת אינטרס של Protected Audience API), המסגרת לא יכולה לגשת לאחסון או לקובצי cookie ללא חלוקה. פריים עם גבולות וירטואליים opaque-ads יכולים לגשת למחיצה ייחודית של קובצי Cookie ואחסון חד-פעמיים.

המאפיינים של פריימים מגודרים מפורטים יותר במסביר.

הצגת מודעה במסגרת מגודרת

המערכת מחזירה את הערך FencedFrameConfig ממכרז של Protected Audience API, בתנאי שהפרמטר resolveToConfig של AuctionConfig הוגדר כ-true:

const frameConfig = await navigator.runAdAuction({
  // ...auction configuration
  resolveToConfig: true
});

אחרי שמקבלים את ההגדרה, אפשר להקצות אותה למאפיין config של מסגרת מגודרת כדי לנווט למשאב שה-config מיוצג. גרסאות קודמות של Chrome לא תומכות בנכס resolveToConfig, כך שעדיין צריך לוודא שההבטחה נפתרה ל-FencedFrameConfig לפני שמנווטים:

if (window.FencedFrameConfig && frameConfig instanceof FencedFrameConfig) {
  const frame = document.createElement('fencedframe');
  frame.config = frameConfig;
}

עיבוד מודעה ב-iframe

אם הפונקציה AuctionConfig לא מגדירה באופן מפורש את resolveToConfig או אם היא מוגדרת כ-False, runAdAuction() מחזירה URN אטום. על מנת לעבד את המודעה, אפשר להגדיר את ה-URN הזה בתור src של iframe.