סקירה כללית של Protected Audience API

מכרזים של מודעות במכשיר להצגת מודעות רימרקטינג ומודעות לקהלים בהתאמה אישית, בלי מעקב של צד שלישי באתרים שונים.

למי המסמך הזה מיועד?

במסמך הזה מוסברים היסודות של Protected Audience API וכמה מושגים בסיסיים, אבל לא נכנסים לפרטים טכניים רבים.

במילון המונחים מופיעים מונחים שמופיעים במסמכי התיעוד של Protected Audience. בסוף המסמך הזה מוסבר איך להשתתף ולשתף משוב.

מה זה Protected Audience API?

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

‫Protected Audience API מאפשר לדפדפן לערוך מכרזים במכשיר כדי לבחור מודעות רלוונטיות מאתרים שהמשתמש ביקר בהם בעבר.

‫Protected Audience API הוא הניסוי הראשון שמוטמע ב-Chromium במסגרת סדרת ההצעות TURTLEDOVE. ההבדל בין Protected Audience לבין TURTLEDOVE קשור בעיקר להפרדה בין התפקידים של קונה המודעות לבין מוכר המודעות במכשיר. בקטעים הבאים מוסבר איך פועל Protected Audience API.

Protected Audience API בדקה אחת

סקירה מפורטת יותר של Protected Audience API מופיעה במדריך למפתחים בנושא Protected Audience API.

סקירה כללית של כל שלב במחזור החיים של Protected Audience API
מחזור החיים של Protected Audience API.

‫Protected Audience API משתמש בקבוצות אינטרס כדי לאפשר לאתרים להציג מודעות שרלוונטיות למשתמשים שלהם.

לדוגמה, כשמשתמש נכנס לאתר שרוצה לפרסם את המוצרים שלו, הבעלים של קבוצת אינטרס (כמו פלטפורמה למפרסמים (DSP)) יכול לבקש מהדפדפן של המשתמש להוסיף חברוּת לקבוצת האינטרס. אם הבקשה מצליחה, הדפדפן מתעד:

  • השם של קבוצת האינטרסים: לדוגמה, custom-bikes.
  • הבעלים של קבוצת האינטרס: לדוגמה, 'https://dsp.example'.
  • פרטי ההגדרה של קבוצת המתעניינים, כדי לאפשר לדפדפן לגשת לקוד של הצעות המחיר, לקוד המודעות ולנתונים בזמן אמת, אם בעלי הקבוצה מוזמן להגיש הצעת מחיר במכרז שטחי פרסום.

אחר כך, כשהמשתמש ייכנס לאתר עם שטח זמין להצגת מודעות, הספק של השטח הזה (הפלטפורמה לספקים (SSP) או האתר עצמו) יכול להשתמש ב-Protected Audience API כדי לערוך מכרז של מודעות, שבו ייבחרו המודעות שהכי מתאימות למשתמש הזה. המוכר קורא לפונקציה navigator.runAdAuction(), שמספקת רשימה של בעלי קבוצות אינטרסים שהוזמנו להגיש הצעות מחיר.

אפשר להגיש הצעות מחיר רק על קבוצות של נושאים שהדפדפן חבר בהן, ושהבעלים שלהן הוזמנו להגיש הצעות מחיר.

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

כל קבוצת בעלי עניין שמגישה הצעת מחיר נקראת קונה.

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

המודעה שתזכה במכרז תוצג במסגרת מוגבלת. כתובת ה-URL של קריאייטיב המודעה מצוינת בהצעת המחיר, והמקור חייב להיות זהה לאחד מהמקורות שמופיעים ברשימה שמופיעה בהגדרות של קבוצת הנושאים.

המוכר יכול לדווח על תוצאות המכרז (reportResult()), והקונים יכולים לדווח על הזכיות שלהם (reportWin()).

מידע נוסף על דוחות של מכרזים ב-Protected Audience

למה אנחנו צריכים את Protected Audience API?

הבנת תחומי העניין של המשתמשים מאפשרת להציג מודעות רלוונטיות יותר מאשר רק בחירה של מודעות על סמך תוכן האתר (טירגוט הקשרי) או על סמך מידע שהמשתמש סיפק לאתר שבו המודעה מוצגת (טירגוט על סמך נתונים מאינטראקציה ישירה).

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

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

איך אפשר לנסות את Protected Audience API?

  • במדריך למפתחים בנושא Protected Audience API מוסבר איך להשתמש ב-API ואיך לבצע בדיקות מקומיות.

  • בכתובת protected-audience-demo.web.app יש הסבר מפורט על פריסה בסיסית של Protected Audience באתרים של מפרסמים ובעלי תוכן דיגיטלי. בסרטון ההדגמה של Protected Audience מוסבר איך הקוד הזה פועל ומוצג תצוגה מקדימה של אופן השימוש בכלי הפיתוח של Chrome לצורך ניפוי באגים.

אילו הגדרות דפדפן זמינות?

המשתמשים יכולים לשנות את ההשתתפות שלהם בגרסאות הניסיון של ארגז החול לפרטיות ב-Chrome על ידי הפעלה או השבתה של ההגדרה ברמה העליונה בchrome://settings/adPrivacy. במהלך הבדיקה הראשונית, המשתמשים יכולים לבטל את ההסכמה לשימוש ב-Protected Audience API באמצעות ההגדרות של ארגז החול לפרטיות.

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

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

למתקשרים ב-API אין גישה לחברות בקבוצה כשמשתמשים גולשים במצב פרטי, והחברות מוסרת כשמשתמשים מוחקים את נתוני האתר שלהם.

אפשר לבטל את ההצטרפות ל-Protected Audience API?

כאן מוסבר איך לחסום את הגישה ל-Protected Audience API, בתור בעלי אתר או בתור משתמשים פרטיים.

מושגים מרכזיים

רוצים לקבל מידע נוסף על המינוח של Protected Audience? אפשר לעיין במילון המונחים של ארגז החול לפרטיות.

מהי קבוצת אינטרסים?

קבוצת אינטרס של Protected Audience API מייצגת קבוצה של אנשים עם תחומי עניין משותפים, ומתאימה לרשימת רימרקטינג.

לכל קבוצת אינטרס ב-Protected Audience API יש בעלים. סוגים שונים של בעלים ייצרו סוגים שונים של קבוצות נושאים עם תרחישי שימוש שונים.

הבעלים מבקש מהדפדפן של המשתמש להוסיף חברות לקבוצת האינטרס שלו על ידי קריאה לפונקציית JavaScript‏ navigator.joinAdInterestGroup(), ומספק מידע כמו נתונים על מודעות שרלוונטיות לקבוצת האינטרס וכתובת URL ל-JavaScript שמשמשת לבידינג. אפשר לעדכן את הנתונים של קבוצת האינטרס (למשל המודעות), ואפשר להפעיל קבוצת אינטרס למשך עד 30 יום.

סוגים של קבוצות אינטרס

בטבלה הבאה מוצגות דוגמאות לסוגים שונים של קבוצות של תחומי עניין ב-Protected Audience API ולבעלים שלהן.

בעלים דוגמה תחום עניין דוגמה תרחישים לדוגמה
מפרסם יצרן אופניים מוצרים אנשים שצפו בדפי מוצרים של קטגוריה מסוימת של אופניים. רימרקטינג לאנשים שכבר הייתה להם אינטראקציה עם המותג.
בעל תוכן דיגיטלי אתר חדשות תוכן אנשים שקוראים על רכיבה על אופניים. בעלי תוכן דיגיטלי יכולים להשתמש בנתונים מאינטראקציה ישירה כדי לאפשר למפרסמים לקנות מודעות שרלוונטיות לקוראים באתר שלהם. קבוצת אינטרס בבעלות בעל התוכן הדיגיטלי יכולה לאפשר לבעלי תוכן דיגיטלי לעשות את אותו הדבר גם כשאותם אנשים גולשים באתרים אחרים. בעלי אתרים יכולים לגבות תשלום על האפשרות להציג מודעות לפלחים ספציפיים של קהל היעד שלהם.
פרסום דיגיטלי DSP קטגוריית מוצרים אנשים שהביעו עניין בציוד לרכיבה על אופניים. חברת טכנולוגיית פרסום יכולה ליצור ולנהל קבוצת עניין של אנשים שהיא מאמינה שהם מחפשים פריטים מקטגוריה מסוימת. אפשר להשתמש בקבוצת העניין הזו כדי לפרסם מוצרים באתרים שמוכרים מוצרים בקטגוריה הזו (ושעובדים עם חברת הטכנולוגיה הפרסומית).

ב-Chrome אפשר ליצור עד 1,000 קבוצות אינטרס לכל בעלים, ועד 1,000 בעלים של קבוצות אינטרס. ההגבלות האלה נועדו לשמש כאמצעי הגנה, ולא כהגבלות שצריך להגיע אליהן במהלך פעולה רגילה.

מה זה קונה?

ב-Protected Audience API, קונה הוא צד שבבעלותו קבוצת אינטרס ומגיש הצעות מחיר במכרז של מודעות.

לדוגמה:

  • מפרסם: פועל בשמו.
  • פלטפורמה למפרסמים (DSP): פלטפורמה שפועלת בשם המפרסמים.
  • הבעלים של קבוצה של תחומי עניין: עובד בשביל כמה מפרסמים.

לקונים יש שלוש משימות:

  • בוחרים אם להשתתף במכרז.
  • בוחרים מודעות ומחשבים הצעת מחיר.
  • דיווח על תוצאת המכרז.

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

כשקונה מבקש מהדפדפן של משתמש להוסיף קבוצת אינטרס לקבוצות שהוא חבר בהן (על ידי קריאה לפונקציית JavaScript‏ navigator.joinAdInterestGroup()), הקונה מספק לדפדפן את הפרטים הבאים:

הקוד של הקונה יכול לכלול גם פונקציה reportWin() לדיווח על תוצאות המכרז.

מי מריץ מכירה פומבית של מודעות?

יכול להיות שיש כמה גורמים שמנהלים מכרז למכירת שטח פרסום.

לדוגמה:

  • בעל תוכן דיגיטלי: פועל באופן עצמאי כדי לארח תוכן מודעות באתר שלו.
  • פלטפורמה לספקים (SSP): פלטפורמה שעובדת עם בעל האתר ומספקת שירותים אחרים.
  • סקריפט של צד שלישי: פועל בשם בעל האתר כדי לאפשר השתתפות במכרזים של מודעות.

באמצעות Protected Audience API, למוכר של שטחי פרסום יש שלוש משימות:

  • אכיפת כללים לבעלי תוכן דיגיטלי: ציון הקונים והצעות המחיר שעומדים בדרישות.
  • הפעלת לוגיקה של מכרז: קוד JavaScript שמופעל ב-worklets כדי לחשב ציון רצויות לכל הצעת מחיר.
  • דיווח על תוצאת המכרז.

המשימות האלה מתבצעות באופן פרוגרמטי, בקוד שמספק המוכר כשהוא מתחיל מכרז על מודעה על ידי קריאה לפונקציית JavaScript‏ navigator.runAdAuction().

איך פועל מכרז של מודעות ב-Protected Audience API?

בתרשים הבא מפורט כל שלב במכרז של מודעות באמצעות Protected Audience API:

שישה שלבים במכרז של מודעות ב-Protected Audience API
שלבים במכרז של מודעות לקהלים מוגנים.

ב-Protected Audience API, מכרז פרסום הוא אוסף של תוכניות JavaScript קטנות שהדפדפן מריץ במכשיר של המשתמש כדי לבחור מודעה. כדי לשמור על הפרטיות, כל קוד מכרז המודעות של המוכר והקונים מופעל בוורקלטים מבודדים של JavaScript שלא יכולים לתקשר עם העולם החיצוני.

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

המוכר מספק לדפדפן קוד לדירוג הצעות מחיר, שכולל את הערך של כל הצעה, את כתובת ה-URL של קריאייטיב המודעה ונתונים אחרים שמוחזרים מכל קונה. במהלך המכרז, קוד הבידינג של הקונים וקוד ניקוד הצעות המחיר של המוכר יכולים לקבל נתונים משירותי המפתח/הערך שלהם. אחרי שמודעה נבחרת ומוצגת (במסגרת מוגבלת כדי לשמור על הפרטיות), המוכר והקונה שזכה יכולים לדווח על תוצאת המכרז.

  1. משתמש מבקר באתר שמוצגות בו מודעות.
  2. הקוד של המוכר מתחיל מכרז. המוכר מציין איזה שטח פרסום מוצע למכירה ומי יכול להגיש הצעות מחיר, וגם שיטה לדירוג הצעות המחיר האלה.
  3. הקוד של הקונה המוזמן מופעל כדי ליצור הצעת מחיר, כתובת URL של קריאייטיב רלוונטי של מודעה ונתונים אחרים. סקריפט הבידינג יכול לשלוח שאילתות לגבי נתונים בזמן אמת, כמו התקציב שנותר לקמפיין הפרסום, משירות המפתח/הערך של הקונה.
  4. הקוד של המוכר מנקד כל הצעת מחיר ובוחר את ההצעה המנצחת. הלוגיקה הזו משתמשת בערך הצעת המחיר ובנתונים אחרים כדי להחזיר את מידת הרצויות של הצעת מחיר ולדחות מודעה שלא יכולה לנצח את המודעה הזוכה בהקשר. המוֹכר יכול להשתמש בשירות משלו של זוגות מפתח/ערך כדי להציג נתונים בזמן אמת. לפני שמכרז מתחיל, המוכר מוצא את המודעה ההקשרית הכי טובה למיקום המודעה שזמין.
  5. המודעה הזוכה מוחזרת כאובייקט הגדרה של fenced frame כשמגדירים את הדגל resolveToConfig בהגדרות המכרז. ההגדרה משמשת לניווט בפריים המוגבל אל נכס הקריאייטיב של המודעה, וכתובת ה-URL של הקריאייטיב מוסתרת מהמוכר ומהבעלים של האתר או האפליקציה. אם הדגל resolveToConfig מוגדר כ-false או לא מועבר, המודעה שזכתה מוחזרת כ-URN אטום שאפשר להשתמש בו כדי להציג את המודעה ב-iframe. אובייקט ההגדרה של fenced frame זמין החל מגרסה M114.
  6. הסוחר והקונים הזוכים מקבלים דיווח על המכרז.

מנגנון דיווח על קונים שאיבדו את ההזדמנות נמצא בדיון.

מהו שירות של Protected Audience API מסוג מפתח/ערך?

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

שירות המפתח/ערך נפרס בתשתית הענן של טכנולוגיית הפרסום, והשירות פועל בסביבת ביצוע מהימנה. בקשה לשירות מפתחות/ערכים לא יכולה לגרום לרישום ביומן ברמת האירוע או להשפיע על דברים אחרים. שירות המפתח/ערך יתמוך גם בפונקציות שהוגדרו על ידי המשתמש (UDF), שיאפשרו לטכנולוגיות פרסום להפעיל לוגיקה מותאמת אישית משלהן בתוך שירות המפתח/ערך.

קונה או מוכר מספקים רשימה של 'מפתחות' כדי לציין את הנתונים שהם צריכים משירות מפתח/ערך של Protected Audience API. השירות למפתחות/ערכים מחזיר ערך לכל מפתח.

הקוד של שירות המפתח/הערך של Protected Audience API זמין עכשיו במאגר של ארגז החול לפרטיות ב-GitHub. מפתחי Chrome ו-Android יכולים להשתמש בשירות הזה.

מידע נוסף על שירות Protected Audience API Key/Value זמין במאמר שמסביר על ה-API ובמאמר שמסביר על מודל האמון.

איך משולבים במכרזים נתונים בזמן אמת?

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

כדי לעמוד בדרישות הפרטיות של Protected Audience API, נתונים בזמן אמת שנדרשים במהלך מכרז על מודעה מסופקים על ידי שירות המפתח/ערך. כשכל קונה מתקשר אל navigator.joinAdInterestGroup(), הקונה מציין כתובת URL של שירות מפתח/ערך ומציין את המפתחות שיש לשלוח לשירות במהלך מכרז. באופן דומה, כשהמוכר מפעיל מכירה פומבית של מודעות על ידי קריאה ל-navigator.runAdAuction(), הוא מספק כתובת URL לשירות Key/Value שלו. המערכת תשלח שאילתה לשירות המפתח/הערך של המוכר עם כתובת ה-URL של הקריאייטיב.

לצורך בדיקות ראשוניות, נעשה שימוש במודל "Bring Your Own Server". בטווח הארוך, חברות פרסום דיגיטלי יצטרכו להשתמש בשירותי מפתח/ערך של Protected Audience API בקוד פתוח שפועלים בסביבות ביצוע מהימנות כדי לאחזר נתונים בזמן אמת.

כדי לוודא שהסביבה העסקית תהיה מוכנה בזמן, אנחנו לא צפויים לדרוש את השימוש בשירותי מפתח/ערך בקוד פתוח או בסביבות ביצוע מהימנות עד תקופה מסוימת אחרי הוצאת קובצי ה-Cookie של צד שלישי משימוש. לפני המעבר הזה, נשלח הודעה מראש למפתחים כדי שיוכלו להתחיל לבדוק את השינוי וליישם אותו.

איך משתמשים בנתונים מאינטראקציה ישירה במכרז של קהל מוגן?

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

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

לדוגמה, אם המפרסם יודע מה הצבע המועדף על המשתמש, אפשר להגדיר את הערך בהגדרות של קבוצת האינטרס כ-userBiddingSignals כשמוסיפים את המשתמש לקבוצת אינטרס:

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

בעלי האתרים יכולים גם להעביר את הנתונים מאינטראקציה ישירה (First-Party) שלהם על ידי הגדרת האותות בהגדרות המכרז כשהם מתחילים את המכרז, והם יכולים לקבוע מי יקבל את הנתונים מאינטראקציה ישירה. כשבעל תוכן דיגיטלי מעביר את הנתונים מאינטראקציה ישירה בתור auctionSignals, הם זמינים גם לקונים וגם למוכרים. כשהנתונים מועברים כ-sellerSignals, הם זמינים רק למוכר, וכשהם מועברים כ-perBuyerSignals, הם זמינים רק לקונים שצוינו. בעלי האתרים יכולים גם להעביר נתונים מאינטראקציה ישירה למכרזים של רכיבים. בעל האתר והמשתתפים במכרז צריכים להסכים מראש על הנתונים מאינטראקציה ישירה שצריך לשתף, ועל הפורמט של הנתונים.

בדוגמה הבאה מתואר איך בעל התוכן הדיגיטלי יכול להעביר את הנתונים מאינטראקציה ישירה למשתתפים שונים במכרז:

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

למידע נוסף

סקירה מפורטת יותר של Protected Audience API מופיעה במדריך למפתחים בנושא Protected Audience API.

מפתחים

אם אתם רוצים להתחיל לעבוד עם Protected Audience API, כדאי לקרוא את המאמר בנושא התנסות והשתתפות.

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

השתתפות ושיתוף משוב