כשמכרז '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
.