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

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

למי המאמר הזה מיועד?

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

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

מה זה 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 כדי להפעיל מכרז של מודעות ולבחור את המודעות המתאימות ביותר. להצגה למשתמש. בית העסק קורא ל-navigator.runAdAuction() שמספקת רשימה של בעלים של קבוצות תחומי עניין שהוזמנו להגיש הצעות מחיר.

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

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

כל קבוצת אינטרס שמספקת הצעת מחיר נקראת 'קונה'.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

האם אפשר לבטל את ההסכמה לשימוש ב-Protected Audience API?

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

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

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

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

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

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

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

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

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

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

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

מהו קונה?

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

לדוגמה:

לקונים יש שלוש עבודות:

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

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

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

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

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

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

מנגנון דיווח שהקונים מפסידים נמצא בבדיקה.

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

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

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

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

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

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

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

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

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

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

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

איך משתמשים בנתונים מאינטראקציה ישירה (First-Party) במכרזים של Protected Audience?

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

במכרז של Protected Audience המפרסם יכול להשתמש בנתונים מאינטראקציה ישירה (First-Party) כדי לקבוע אם החברות בקבוצת תחומי העניין של המודעה נמצאת, וגם להעביר את הנתונים לקבוצת תחומי העניין בתור 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) על ידי הגדרה של האותות בהגדרת המכרז כשמתחילים את המכרז, ויכול לקבוע מי יקבל את הנתונים מהאינטראקציה הישירה (First-Party). כשבעל תוכן דיגיטלי מעביר נתונים מאינטראקציה ישירה (First-Party) בתור auctionSignals, הם זמינים גם לקונים וגם לאתרי המכירה. כשהנתונים מועברים בתור sellerSignals, הם זמינים רק למפיץ, וכשהם מועברים בתור perBuyerSignals, הם זמינים רק לקונים שצוינו. בעל האפליקציה יכול גם להעביר נתונים מאינטראקציה ישירה (First-Party) למכרזים של רכיבים. בעל האפליקציה ומשתתפי המכרז צריכים להסכים לפני כן לגבי הנתונים מאינטראקציה ישירה (First-Party) שצריך לשתף, ואיזה פורמט של נתונים.

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

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 לניפוי באגים ב-Protected Audience API.

מעורבות ושיתוף משוב