דיווח מכרזים של Protected Audience API

bookmark_border קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

מדידת הנתונים והתוצאות של מכרזים ב-Protected Audience API

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

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

• צבירה פרטית, שבה מתבצע איסוף של אותות וממצאים של מכרזים כדי ליצור דוחות סיכום.
• Ads Reporting API למסגרות מוגנות ולiframe, שהוא ערוץ בתוך המסגרות לצורך תקשורת עם רכיבי worklet של Protected Audience API. ה-API מאפשר לשייך נתונים ברמת האירוע לאותות מכרזים. הדיווח ברמת האירוע ב-Ads Reporting API הוא מנגנון ביניים עד שיתוכנן מנגנון דיווח פרטי יותר.
• דיווח שיוך שמאפשר לשייך נתוני המרות לאותות במכרז.
• אחסון משותף שמאפשר לכתוב אותות מכרזים לאחסון במקורות שונים, ולאחר מכן לדווח על הנתונים האלה באמצעות צבירת נתונים פרטית.

סקירה כללית על הדוחות של Protected Audience API

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

במהלך המכרז, אפשר לדווח על נתוני המכרז באמצעות 'נכסי דיווח'. במהלך זמן הרינדור, אפשר לדווח על נתוני התעניינות מ-iframe או ממסגרת מגודר. במהלך זמן ההמרה, אפשר לדווח על נתוני שיוך מדף היעד באמצעות Attribution Reporting API.

מיקומי דיווח

במכרז, הקונים יכולים לדווח על אותות שזמינים ב-worklets של generateBid() ו-reportWin(), והמוכרים יכולים לדווח על אותות שזמינים ב-worklets של scoreAd() ו-reportResult(). מחוץ למכרז, הקונים והמוכרים יכולים לדווח על נתונים מהפריים שבו המודעה הוצגה ומהאתר שבו בוצעה ההמרה.

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

נתונים שזמינים במכרז של Protected Audience API

הנתונים הבאים זמינים לדיווח מ-worklet של Protected Audience API במהלך המכרז.

אותות

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

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

נתונים זמינים אחרים

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

נתונים שזמינים מחוץ למכרז של Protected Audience API

מחוץ למכרז של Protected Audience API, יש שתי תקופות זמן שבהן הנתונים זמינים לדיווח.

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

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

דיווח ברמת האירוע

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

דיווח על זכיות במכרזים ברמת האירוע באמצעות sendReportTo()

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

לדוגמה, קונה יכול לדווח על סכום הצעת המחיר הזוכה מהכלי reportWin() למטרות חיוב:

// Buyer reporting worklet
function reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals, directFromSellerSignals) {
  sendReportTo(`https://buyer-reporting-server.example/reporting?bid=${browserSignals.bid}`);
}

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

הדוח 'מעורבות' (Engagement)

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

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

Ads Reporting API למסגרות מגודרות ולתגי iframe

Ads Reporting API למסגרות מגודרות ולתגי iframe מספק מנגנון שמאפשר לכם לשייך נתונים ברמת האירוע של משתמשים ממסגרת מודעה לבין אותות במכרז של קהל מוגן.

ב-worklet לדיווח של Protected Audience API, אפשר לרשום משואת מודעה באמצעות הפונקציה registerAdBeacon() ולהעביר את כתובת ה-URL לדיווח עם האותות שנוספו כפרמטרים של שאילתה. צריך גם לציין את האירוע המותאם אישית שרוצים לשייך לכתובת ה-URL לדיווח. לאחר מכן, בשלב מאוחר יותר כשהמודעה תומרן בפריים מגודר, תוכלו להפעיל את האירוע בהתאמה אישית על ידי קריאה לפונקציה window.fence.reportEvent(). אפשר להוסיף את הנתונים שזמינים בתוך המסגרת המגודרת כמטען שימושי.

הפונקציה registerAdBeacon() זמינה רק בפונקציות הדיווח, ולא זמינה בלוגיקה של הבידינג של הקונה ובלוגיקה של הניקוד של המוכר.

בדוגמה הבאה, מזהה קמפיין משויך למטען ייעודי (payload) ברמת האירוע עם קואורדינטות הקליק:

// Protected Audience API buyer win reporting worklet
function reportWin(auctionSignals) {
  const { campaignId } = auctionSignals

  registerAdBeacon({
    click: `https://buyer-server.example/report/click?campaignId=${campaignId}`
  })
}

// Protected Audience API seller reporting worklet
function reportResult(auctionConfig) {
  const { campaignId } = auctionConfig.auctionSignals;

  registerAdBeacon({
    click: `https://seller-server.example/report/click?campaignId=${campaignId}`
  })
}

// Ad frame
window.fence.reportEvent({
  eventType: 'click',
  eventData: JSON.stringify({'clickX': '123', 'clickY': '456'}),
  destination:['buyer', 'seller']
});

גם ה-API לדיווח על מודעות בפריימים מגודר יהיה זמין לפחות עד 2026, מסיבות זהות לאלו של דיווח על זכיות.

לסקירה מפורטת יותר, אפשר לעיין במאמר ההסבר.

גישה לרשת ללא הגבלות

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

הגישה לרשת תהיה מוגבלת בעתיד.

דוח ייחוס למקורות תנועה

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

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

מנגנון מעבר

כשרוצים לרשום משואת מודעות, אפשר להשתמש במילות המפתח reserved.top_navigation. כך המערכת תוסיף באופן אוטומטי את הכותרת Attribution-Reporting-Eligible כדי שהמשוואה תהיה כשירה לרישום כמקור שיוך.

registerAdBeacon({
 'reserved.top_navigation': 'https://adtech.example/click?buyer_event_id=123',
});

כדי לצרף נתונים ברמת האירוע למצפן שרשמת, אפשר להפעיל את setReportEventDataForAutomaticBeacons() מהמסגרת המגודרת עם עומס העבודה של האירוע.

window.fence.setReportEventDataForAutomaticBeacons({
  eventType: 'reserved.top_navigation',
  eventData: 'data from the frame',
  destination:['seller', 'buyer']
})

מידע נוסף זמין בקטע 'דיווח שיוך' במאמר ההסבר על Ads Reporting API.

דוגמה לדוח על התעניינות והמרות

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

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

תהליך העבודה:

1. לפני שהמכרז מתחיל, הקונה שולח למוכרים מזהה ייחודי כחלק מתגובה פרוגרמטית להצעת מחיר בבידינג בזמן אמת (RTB). אפשר להגדיר את המזהה כמשתנה כמו auctionId. המזהה מועבר כ-perBuyerSignals ב-auctionConfig והוא הופך לזמין ב-worklets של הקונה.
2. במהלך המכרז, הקונה יכול לרשום משואת מודעה שתופעל במהלך הזמן שבו המודעה מוצגת ובמהלך הזמן שבו מתרחשת ההמרה (registerAdBeacon()).
   1. כדי לשייך אותות מכרז לאירוע של מסגרת מודעה, מגדירים את auctionId כפרמטר של שאילתה בכתובת ה-URL של ה-beacon.
   2. כדי לשייך אותות מכרז לאירוע המרה, מגדירים את auctionId בכתובת ה-URL של ה-beacon.
3. במהלך הרינדור של המודעה, הסמנים שרשמתם בזמן המכרז יכולים להופעל או להשתפר באמצעות נתונים ברמת האירוע.
   1. מפעילים את אירוע הפריימים באמצעות reportEvent() ומעבירים את הנתונים ברמת האירוע.
   2. הוספת עומס נתונים ברמת האירוע למיקום ה-beacon לזיהוי השיוך באמצעות setReportEventDataForAutomaticBeacons()
   3. כדי לרשום את המודעה ב-Attribution Reporting API, צריך להשיב לבקשות של משואת המודעות באמצעות הכותרת Attribution-Reporting-Register-Source.
4. במהלך זמן ההמרה, אפשר להפעיל את המקור שרשמתם במהלך מועד המכרז.

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

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

צבירת נתונים של Protected Audience

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

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

מידע נוסף על ה-API זמין במאמר צבירה פרטית.

צבירת אותות מכרזים

אתם יכולים לצבור את האותות שזמינים בתוך רכיבי ה-worklet בשרת שלכם באמצעות Private Aggregation. כדי לצבור אותות, אפשר להשתמש בשיטה privateAggregation.contributeToHistogram() שזמינה ב-worklet לבידינג של הקונה, ב-worklet לדירוג של המוכר וב-worklets של דיווח לקונה/למוכר.

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

function convertBuyerToBucket(igOwner) {}
function convertWinningBidToValue(winningBid) {}

function reportResult(auctionConfig, browserSignals) {
  privateAggregation.contributeToHistogram({
    bucket: convertBuyerToBucket(browserSignals.interestGroupOwner),
    value: convertWinningBidToValue(browserSignals.bid)
  });
} 

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

צבירת אותות מכרזים עם נתוני אירועים

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

כדי לצבור אותות מכרזים לפי אירועים, אפשר להשתמש בפונקציה privateAggregation.contributeToHistogramOnEvent(eventType, contribution) שמקבלת מחרוזת שמציינת את סוג האירוע ואת התרומה שעל בסיסה יתבצע הדיווח כשהאירוע הזה יופעל. אפשר להפעיל את השיטה עם סוג אירוע מותאם אישית, ולאחר מכן להפעיל את window.fence.reportEvent(eventType) ממסגרת המודעה כדי להפעיל את שליחת הדוח.

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

// Protected Audience API worklet
function getClickReportBucketForCampaign(campaignId) {
  // return a bucket for the campaign ID and the click event
}

function generateBid(interestGroup) {
  privateAggregation.contributeToHistogramOnEvent('click', {
    bucket: getClickReportBucketForCampaign(interestGroup.ads.metadata.campaignId), 
    value: 1
  });
}

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

// Ad frame
window.fence.reportEvent('click');

לאחר מכן, בשלב מאוחר יותר, אפשר להפעיל את שליחת הדוח מתוך מסגרת המודעה באמצעות קריאה ל-reportEvent(eventType):

במאמר הזה מוסבר איך מפעילים תרומות של Private Aggregation מתוך פריים.

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

אפשר גם לצבור את תוצאות המכרזים שמתרחשות כשמתרחש אירוע של זכייה או הפסד במכרז באמצעות contributeToHistogramOnEvent(eventType, contribution) כשמעבירים מילות מפתח מסוג אירוע שמורות (reserved.win, reserved.loss ו-reserved.always).

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

כשמציינים ערך בסיס מסוים, כמו סכום הצעת המחיר הזוכה, אפשר להגדיר כמה להוסיף או לחסר מהערך הזה, ואז לדווח על הערך הסופי. לדוגמה, אם הצעת המחיר הזוכה בסך 5 $מצוינה כערך הבסיס, אפשר לחסר את הצעת המחיר שלכם בסך 2 $כדי לחשב את הערך בפועל של 3 $של סכום ההפסד במכרז.

דיווח על תוצאות המכרזים

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

כדי לבדוק כמה הפסדתם במכרז, אפשר לחסר את מחיר הצעת המחיר שלכם ממחיר הצעת המחיר הזוכה:

function generateBid() {
  const bid = calculateBidAmount();

  privateAggregation.contributeToHistogramOnEvent('reserved.loss', {
    bucket: getBucketForCampaign(interestGroup.ads.metadata.campaignId),
    value: {
      baseValue: 'winning-bid',
      scale: 1 // Scale the value to minimize noise-to-signal ratio 
      offset: -bid, // Numbers added to browser value after scaling 
    }
  });
}

כשהדוח נשלח, הערך המדויק שמדווח הוא הערך המשוער של baseValue שעבר הזזה לפי הערך של offset. מידע נוסף זמין במאמר ההסבר.

דיווח על ביצועים

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

מידע נוסף זמין במאמר הזה.

אחסון אותות מכרזים ב-Shared Storage

אחסון משותף הוא אחסון ללא מחיצות ומקורות שונים, שאפשר לכתוב בו באופן חופשי, אבל הוא מוגן באמצעות שערים בזמן הקריאה והעיבוד של הערכים השמורים. אחד מהשערים הזמינים ל-Shared Storage API הוא Private Aggregation. אפשר לקרוא את הערכים באחסון המשותף רק מתוך ווירטואל וויט, ואפשר לדווח על הערכים האלה באמצעות Private Aggregation מתוך הווירטואל וויט.

אפשר גם לכתוב לאחסון המשותף מ-worklets של בידינג, ניקוד ודיווח של Protected Audience API. בשלב מאוחר יותר, תוכלו לדווח על הערכים האלה באחסון המשותף לשרת באמצעות Private Aggregation . אפשר גם להשתמש בערכים השמורים לפעולה בחירת כתובת URL.

מ-worklet של Protected Audience API, אפשר לכתוב מפתחות וערכים לאחסון משותף:

// Protected Audience API worklet
function generateBid() {
  sharedStorage.set('test-bucket', 123);
}

בשלב מאוחר יותר, תוכלו לטעון וורקלט של אחסון משותף כדי לקרוא את הערך הזה ולשלוח אותו באמצעות Private Aggregation:

// Shared Storage worklet
class SendReachReport{
  async run() {
    const testBucket = await this.sharedStorage.get('test-bucket');

    privateAggregation.contributeToHistogram({
      bucket: testBucket,
      value: 1
    });
  }
}

register('send-report', SendReachReport);

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

מה השלב הבא?

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

דיון על ה-API

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

התנסות עם ה-API

אתם יכולים לערוך ניסויים ולהשתתף בשיחה על Protected Audience API.