עיבוד מודעה

כאשר מכרז של 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 ברכיב של המסגרת הסגורה. הערך הזה שונה מ-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, בתנאי שהפרמטר 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 כדי לעבד את המודעה.