מדריך השילוב והבדיקה של Protected Audience (לשעבר FLEDGE) ל-SSP

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

ספקי SSP יכולים לבדוק את Protected Audience API באמצעות Display & Video 360 ו-Google Ads כדי:

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

במדריך הבא מתוארים פרטי השילוב בין SSP לבין Display & Video 360 ו-Google Ads. ספקי SSP שרוצים לתאם בדיקה צריכים לקבל אנשי קשר עם רשת המדיה נציג של Video 360 Partnership.

צירוף

ספקי SSP צריכים להירשם בעצמם להשתמש ב-Protected Audience API.

סיכום תהליך ההצגה

בתרשים הבא מוצגת התהליך הגנרי המתאר את נקודות האינטראקציה העיקריות בין Chrome, SSP, רשת המדיה ו- Video 360 ו-Google Ads.

תרשים רצף שמציג בקשות בין Chrome, SSP ו- DSP

אפשרויות שילוב

אפשרות 1: חשבון ישיר / אתר מכירה יחיד

תהליך בקשה מפורט לאתר מכירה יחיד מכרזים

שלבים:

  1. תג מודעה של SSP שולח בקשה להצגת מודעה לשרת SSP, שמציין שהדפדפן יש תמיכה ב-Protected Audience API.
  2. שרת SSP שולח ל-DSP בקשה להצעת מחיר לפי הקשר של OpenRTB, שמציינת הדפדפן תומך ב-Protected Audience API
  3. DSP מגיב בתגובה להצעת מחיר מסוג OpenRTB שכוללת אותות עבור מכרז במכשיר.
  4. שרת SSP שולח תגובת מודעה עם הגדרת מכרז לתג מודעה של SSP.
  5. תג מודעה של SSP מפעיל מכרז במכשיר על ידי קריאה runAdAuction() העברת אותות מתגובת הצעת מחיר מסוג OpenRTB של DSP דרך perBuyerSignals
  6. Chrome קורא לשרת DSP מהימן – מפתח/ערך כדי לאחזר אותות של בידינג בזמן אמת.
  7. שיחות מ-Chrome generateBid() פונקציית DSP JavaScript לכל קבוצת תחומי עניין שמשתתפת בתוכנית.
  8. Chrome מבצע קריאה לשרת ניקוד SSP מהימן של מפתח/ערך כדי לאחזר אותות ניקוד בזמן אמת.
  9. שיחות מ-Chrome scoreAd() פונקציית SSP של JavaScript לכל קבוצת תחומי עניין שמשתתפת בתוכנית.
  10. שיחות מ-Chrome reportWin() פונקציית DSP JavaScript לדיווח על המנצח ל-DSP.
  11. שיחות מ-Chrome reportResult() פונקציית SSP של JavaScript לדיווח על המנצח ל-SSP.

שינויים מינימליים בצד SSP

  • צריך לעדכן את תג המודעה של SSP לערך

    • זיהוי אם הדפדפן תומך ב-Protected Audience API
    • שליחת המידע הזה כחלק מהבקשה להצגת מודעה אל שרת SSP [1]
    • ליזום מכרז במכשיר על ידי שליחת קריאה ל-runAdAuction() אותות מתגובת OpenRTB של ה-DSP ( [5] ) (השדה 'נתוני קונה' מופעל והסבר על המבנה של הבקשה להצעת מחיר ושל התגובה שלמטה).

  • שרת ה-SSP צריך

    • להפיץ מידע על תמיכה של Protected Audience API ל-DSP בשדה בבקשה להצעת מחיר ב-OpenRTB [2] (מידע נוסף זמין בקטע על הצעת המחיר) ובמבנה של הבקשות והתשובות בהמשך).
    • להפיץ אותות קונה של DSP בתגובה להצעת מחיר מסוג OpenRTB למודעת SSP תג (עיינו בקטע על בקשות להצעת מחיר / מבנה התגובות להצעת מחיר למטה) [4]

  • [Optional] SSP צריך להטמיע שרת SSP מהימן כדי לאחזר בזמן אמת ניקוד אותות לתמיכה בבדיקות איכות המודעות, אכיפת הגדרות של בעלי תוכן דיגיטלי [8]

  • SSP צריך להטמיע JavaScript עם "scoreAd(...)" ו-"reportResult(...)" פונקציות [9], [11]

אפשרות 2: כמה אתרי מכירה

תהליך בקשה מפורט למכרזים עם כמה אתרי מכירה

שלבים:

  1. מתאם SSP שולח בקשה להצגת מודעה לשרת SSP, שמציין שהדפדפן יש תמיכה ב-Protected Audience API.
  2. שרת SSP שולח ל-DSP בקשה להצעת מחיר לפי הקשר של OpenRTB, שמציינת הדפדפן תומך ב-Protected Audience API,
  3. שרת DSP מגיב עם תגובת הצעת מחיר מסוג openRTB שמכילה אותות עבור מכרז במכשיר.
  4. שרת SSP שולח תגובת מודעה עם הגדרת מכרז לתג מודעה של SSP.
  5. מתאם הצעת המחיר מראש של SSP מספק הגדרת מכירה פומבית של רכיבים לשרת המודעות של בעל התוכן הדיגיטלי התיוג.
  6. תג שרת המודעות של בעל התוכן הדיגיטלי שולח בקשה להצגת מודעה אל שרת המודעות של בעל התוכן הדיגיטלי.
  7. התג של שרת המודעות של בעל תוכן דיגיטלי מפעיל מכרז במכשיר באמצעות קריאה runAdAuction(...) API.
  8. Chrome קורא לשרת DSP מהימן – מפתח/ערך כדי לאחזר אותות של בידינג בזמן אמת.
  9. שיחות מ-Chrome generateBid() פונקציית JavaScript ב-DSP לכל קבוצת אינטרס שמשתתפת בתוכנית.
  10. Chrome מבצע קריאה לשרת ניקוד SSP מהימן של מפתח/ערך כדי לאחזר אותות ניקוד בזמן אמת.
  11. שיחות מ-Chrome scoreAd() פונקציית SSP של JavaScript לכל קבוצת תחומי עניין שמשתתפת בתוכנית.
  12. שיחות מ-Chrome reportWin() פונקציית DSP JavaScript לדיווח על המנצח ל-DSP.
  13. שיחות מ-Chrome reportResult() פונקציית SSP של JavaScript לדיווח על המנצח ל-SSP.

שינויים מינימליים בצד SSP

  • צריך לעדכן את מתאם ה-SSP ל

  • שרת ה-SSP צריך

    • להפיץ מידע על תמיכה של Protected Audience ל-DSP באמצעות השדה בבקשה להצעת מחיר ב-OpenRTB [2] (מידע נוסף זמין בקטע בנושא הצעת המחיר ובמבנה של הבקשות והתשובות בהמשך).
    • להפיץ אותות קונה של DSP בתגובה להצעת מחיר מסוג OpenRTB למודעת SSP תג (עיינו בקטע על בקשות להצעת מחיר / מבנה התגובות להצעת מחיר למטה) [4]

  • [Optional] SSP צריך להטמיע שרת SSP מהימן כדי לאחזר בזמן אמת ניקוד אותות לתמיכה בבדיקות איכות המודעות, אכיפת הגדרות של בעלי תוכן דיגיטלי [10]

  • שירות SSP צריך לחשוף JavaScript עם scoreAd() ו-reportResult() פונקציות [11], [14].

שירותי בידינג ומכרזים

אנחנו מעריכים מאוד את שיטת הבידינג שירותי מכירות פומביות (B&A) proposal

כאשר מציגים & המערכת של Video 360 מוכנה לבדיקת Protected Audience API באמצעות B&A, ניצור איתך קשר עם פרטים נוספים.

פרוטוקול OpenRTB

בקשה להצעת מחיר

כדי להבחין בין הזדמנויות חשיפות שתומכות ב-Protected מכרזים במכשיר Audience API שמבוססים רק על מכרזים רגילים מכרז של Exchange בצד השרת, שדה enum חדש שנקרא ae עבור 'מכרז' סביבה" צריך להוסיף אותו כתוסף לאובייקט Imp ב-OpenRTB. בקשה להצעת מחיר כדי לציין איזו סביבת מכרז נתמכת על ידי משבצת החשיפה. ה-enum ae יכול לקבל את הערכים הבאים:

  • 0: מכרזים רגילים בצד השרת
  • 1: בקשות עם תמיכה ב-Protected Audience API, שבהן ניתן המכרז פועל בשרתים של הבורסה ובבידינג של קבוצות על תחומי עניין, המכרז הסופי ירוץ בדפדפן
{
  "id": …
  "imp": [{
    "id": "1"
    "video": {...}
    "ext": {
      "ae": 1
    }]
}

תגובה להצעת מחיר

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

{
  "seatbid": [{
    "bid": [{
      … // Traditional contextual bids
    }]
  }],

  "ext": {
    // InterestGroupBidding object which holds information for running an
    // in-browser interest group auction.
    "igbid": [{
      // ID of the Imp object of the impression to which
      // these interest group bidding signals apply to.
      "impid": "1",

      // InterestGroupBuyer object which holds DSP information for the in-browser
      // auction.
      "igbuyer": [{
        // Origin of Display & Video 360 and Google Ads to participate in the
        // interest group auction. For more info regarding the origin see:
        // https://developer.mozilla.org/en-US/docs/Glossary/Origin
        "origin": "https://td.doubleclick.net",

        // Buyer-specific signals to use in auctionConfig as perBuyerSignals.
        // Used by the buyer's interest group bidding function. Can be left empty
        "buyerdata": ...,

        // Buyer experiment group id to support coordinated experiments with
        // buyers' trusted servers. This experiment id should be added to the
        // `perBuyerExperimentGroupIds` map in auctionConfig.
        "buyer_experiment_group_id": 12345
      }]
    }]
  }
}

התרחישים הבאים נתמכים.

  • תרחיש 1: רשת המדיה ו Video 360 ו-Google Ads רוצים להשתתף רק במכרז לפי הקשר. בתרחיש הזה אין שדה igbid.

  • תרחיש 2: רשת המדיה ו Video 360 ו-Google Ads רוצים להשתתף רק במכרז של קבוצת אינטרס. בתרחיש הזה, Display & Video 360 וגם מערכת Google Ads תשמיט את שדה הצעת המחיר הסגור בתגובה להצעת המחיר, ורק מחזיר מידע igbid. במילים אחרות, הנוכחות של שדה igbid מציינת את העובדה ש-Display & המערכת של Video 360 ו-Google Ads מבקשת את הקבוצות של תחומי העניין שמשויכות אליהן כדי להשתתף במכרז שמתארח במכשיר.

  • תרחיש 3: רשת המדיה ו Video 360 ו-Google Ads רוצים להשתתף בתוכנית גם במכרזים לפי הקשר וגם במכרזים של קבוצות תחומי עניין. בתרחיש הזה, Display & Video 360 ו-Google Ads יחזירו את שני שדות הצעת המחיר בתגובה להצעת המחיר ו-igbid.

מטא-נתונים עם הצעת מחיר למודעה

Protected Audience API מאפשר passing arbitrary metadata על המודעה מהפונקציה generateBid().

תצוגה ו ב-Video 360 אנחנו מתכננים להסתמך על specification למטא-נתונים של המודעה: Protected Audience API ו-OpenRTB.

למשל 'רשת המדיה' המערכת של Video 360 תחזיר את השדות הבאים כחלק מהמודעה object:

מאפיין PA סוג תיאור של OpenRTB
ad.seat String; חובה מזהה מושב הקונה (למשל: מפרסם, סוכנות) שבשמו הצעת המחיר הזו נשלחת.
ad.adomain String[] הדומיין של המפרסם לבדיקה של רשימת חסימה (למשל, 'ford.com'). הוא יכול להיות מערך של נכסי קריאייטיב משתנים. המרות יכולות לאשר שרק דומיין אחד מורשה.
ad.cid מחרוזת מזהה קמפיין שעוזר לבדוק את איכות המודעות.
ad.crid מחרוזת מזהה קריאייטיב שעוזר לבדוק את איכות המודעה.
ad.language מחרוזת שפת הקריאייטיב באמצעות ISO-639-1-alpha-2. הקוד הלא סטנדרטי "xx" ניתן להשתמש בהן גם אם הקריאייטיב לא מכיל תוכן בשפה מסוימת (למשל, באנר עם לוגו של חברה בלבד). יש לכלול רק שפה אחת או langb.
ad.w מספר שלם רוחב הקריאייטיב בפיקסלים בלתי תלויים למכשיר (DIPS).
ad.h מספר שלם גובה הקריאייטיב בפיקסלים בלתי תלויים במכשיר (DIPS).

דוגמה

{
  "seat": "123"
  "adomain": ["example.com"]
  "cid": "12345"
  "crid": "12345"
  "language": "en"
  "w": 300
  "h": 250
}

דיווח על אירועים

Protected Audience API מספק לדיווח ברמת האירוע ממשק API לדיווח ברמת האירוע שמתואר כאן פוסט מ-GitHub: Fenced Frame Ads Reporting. למרות שהשם הוא Fenced Frame Ads Reporting, ה-API זמין בו גם מסגרות מגודרות וגם iframes (ראו פרטים here).

שירות SSP יכול לרשום כתובת URL בדפדפן בפונקציית reportresult על ידי שיחה registerAdBeacon() API.

תצוגה ו המערכת של וידאו 360 תתקשר למספר reportEvent() API עם היעד 'component-seller' מתוך הקריאייטיב לדיווח אירועי חשיפות וקליקים. התוצאה תהיה שליחת איתות Bluetooth אל כתובת URL רשומה.

שימו לב ש-Display & מערכת Video 360 תפעיל את ה-API של reportEvent() כדי לקבל חשיפות קליקים עם נתוני פוסט ריקים.

דוגמה

registerAdBeacon({
 'impression': 'https://ssp.example/impression?ssp_event_id=abc',
});
registerAdBeacon({
 'click': 'https://ssp.example/click?ssp_event_id=abc',
});

תצוגה ו סרטון 360 ישתתף ב-Chrome-facilitated testing מתוך הוצאה משימוש של קובצי cookie של צד שלישי. כדי שתהיה לך אפשרות לבצע את הבדיקה, אנחנו מבקשים משותפים להעביר לנו את התוויות של Chrome בבקשה להצעת מחיר ב-OpenRTB לפי השלבים הבאים specification:

אובייקט: Device.ext

מאפיין סוג תיאור
Cdep מחרוזת את התווית כפי שהתקבלה מ-Chrome או משותף upstream.