מבצעים ב-Protected Audience API

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

סקירה כללית

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

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

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

הדרכה מפורטת

אלה השלבים להפעלת עסקאות במכרז של Protected Audience:

  1. הקונה רושם את מזהי העסקה והמושבים בהגדרה של קבוצת תחומי העניין לפני הפעלת המכרז
    • אפשר להגדיר מזהי מבצעים ועמדות בשדה מזהי דיווח שניתן לבחור (selectableBuyerAndSellerReportingIds).
    • אם מזהה המושב זהה לכל המבצעים, אפשר להגדיר את מזהה המושב בשדה buyerAndSellerReportingId, ואת מזהי המבצעים בשדה הזיהויים של מי שמדווח שאפשר לבחור (selectableBuyerAndSellerReportingIds).
  2. במהלך יצירת הצעת המחיר, מזהי המבצע והמושבים הופכים לזמינים. הקונה בוחר מזהה עסקה מ-selectableBuyerAndSellerReportingIds. הקונה יוצר הצעת מחיר שכוללת מזהה עסקה שמשויך להצעת המחיר הזו על ידי החזרת הצעת מחיר של selectedBuyerAndSellerReportingId. הצעת מחיר עשויה לזכות במכרז רק אם מזהה העסקה שהוחזר הוא אנונימי (k-אנונימי) לצד מזהי דיווח אחרים ונכסים נבחרים של קבוצת האינטרס.
  3. במהלך דירוג המודעה, מזהי המבצעים והמושבים שנבחרו יהיו זמינים למפיץ.
  4. מזהי העסקה והמושב יהיו זמינים בפונקציות הדיווח של המוכר.
  5. מזהי העסקה והמושב יהיו זמינים בפונקציות הדיווח של הקונה.

1. רישום של מבצעים ומזהי עמדות

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

const interestGroupConfig = {
  owner: 'https://buyer.example',
  name: 'example-ig',
  ad: [
    {
      renderURL: 'https://buyer.example/ad.html',
      selectableBuyerAndSellerReportingIds: ['deal123', 'deal456', 'deal789'], // Deal IDs
      buyerAndSellerReportingId: 'seat123', // Seat ID

      // Though it is not used to facilitate deals, the buyer
      // reporting ID can be defined with other reporting IDs
      buyerAndReportingId: 'brid123'
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

אם מזהה המושב שונה בעסקאות, אפשר להשתמש בהגדרה הבאה:

const interestGroupConfig = {
  owner: 'https://buyer.example',
  name: 'example-ig',
  ad: [
    {
      renderURL: 'https://buyer.example/ad.html',
      selectableBuyerAndSellerReportingIds: [
        'deal123seat123',
        'deal456seat456',
        'deal789seat456'
      ], // Deal and Seat IDs
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

2. מזהי מבצעים ומזהי עמדות של קונים במהלך יצירת הצעת המחיר

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

function generateBid(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectableBuyerAndSellerReportingIds // ['deal123', 'deal456', 'deal789']
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;

  // ...

  return {
    bid: 1,
    render: 'https://buyer.example/ad.html',
    selectedBuyerAndSellerReportingId: 'deal456', // Buyer selects a deal ID
  };
}

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

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

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

3. מזהי המבצעים והמושבים של המוכרים במהלך דירוג המודעה

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

function scoreAd(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingIds, // 'deal456'
  } = browserSignals;

  // ...
}

4. מזהי שטחי פרסום ומבצעים לצורכי דיווח של מוכרים

חשוב לזכור שהצעת מחיר עשויה לזכות במכרז רק אם selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (אם קיימת) ו-buyerReportingId (אם קיימים) מוגדרים כ-k-אנונימיים עבור הבעלים של קבוצת האינטרס, כתובת ה-URL של סקריפט הבידינג, כתובת ה-URL לעיבוד וגודל המודעה (גודל המודעה לא ייכלל בבדיקה הזו עד הרבעון הראשון של 2025 לפחות). לכן, ערכים של מזהה דיווח שכוללים selectedBuyerAndSellerReportingId יהיו תמיד זמינים בדומיין reportResult(). חשוב לשים לב שלמרות ש-buyerReportingId מסומן עבור k-anonymity, הערך זמין רק לפונקציית הדיווח של קונים ולא לפונקציית הדיווח על מפיצים כאן.

function reportResult(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingIds // 'deal456'
  } = browserSignals;

  // ...
}

5. מזהי מבצעים ועמדות לדיווח על קונים

אותו קונספט שמופיע בדוחות של אתרי מכירה חל גם על דוחות הקונים. חשוב לזכור שהצעת מחיר עשויה לזכות במכרז רק אם selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (אם קיימת) ו-buyerReportingId (אם קיימים) מוגדרים כ-k-אנונימיים עבור הבעלים של קבוצת האינטרס, כתובת ה-URL של סקריפט הבידינג, כתובת ה-URL לעיבוד וגודל המודעה (גודל המודעה לא ייכלל בבדיקה הזו עד הרבעון הראשון של 2025 לפחות). לכן, ערכים של מזהה דיווח שכוללים selectedBuyerAndSellerReportingId תמיד יהיו זמינים בדומיין reportWin().

function reportWin(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingId // 'deal456'
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;
}

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