מבצעים ב-Protected Audience API

הטמעה של דילים, שנקראים גם 'שוק פרטי' (PMP), במכרז של Protected Audience API

סקירה כללית

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

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

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

הדרכה מפורטת

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

  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
      buyerReportingId: '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(interestGroup, ...) {
  const [{
    buyerAndSellerReportingId, // 'seat123'
    selectableBuyerAndSellerReportingIds // ['deal123', 'deal456', 'deal789']
    buyerReportingId // 'brid123' - Not used for deals, but the value is available
  }] = interestGroup.ads;

  // ...

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

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

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

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

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

  // ...
}

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

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

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'
    buyerReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;
}

אינטראקציה ושיתוף משוב