Deals in Protected Audience

Deals, auch bekannt als privater Marktplatz (PMP), in einer Protected Audience-Auktion implementieren

Übersicht

Deals, auch als privater Marktplatz (Private Marketplace, PMP) bezeichnet, bieten Käufern kuratierten Zugriff oder bevorzugte Preise für eine Teilmenge des Inventars. Zur Erleichterung programmatischer Deals werden Sitz-IDs und Deal-IDs verwendet:

  • Eine Sitzplatz-ID stammt vom Käufer und ist eine Kennung, die den Kunden des Käufers repräsentiert. Eine Konto-ID kann Auswirkungen auf die Abrechnung haben, z. B. wenn für ein Konto ein Rabatt bei einem bestimmten Verkäufer gilt.
  • Eine Deal-ID stammt entweder vom Käufer oder vom Verkäufer und ist eine Kennung, die eine Vereinbarung zwischen einem Käufer und einem Verkäufer darstellt. Eine Deal-ID kann Eigenschaften wie Kosten/Preis, Volumenverpflichtung, Zielgruppeninformationen und Exklusivität haben.

Protected Audience ermöglicht Deals mithilfe von Reporting-IDs, sodass Sitz- und Deal-IDs für Gebote, Scoring und Berichte in Auktionen verfügbar sind. Die Berichts-IDs bieten AdTech-Unternehmen die Möglichkeit, diese Deal- und Sitz-IDs in Protected Audience-Berichten nach der Auktion zu erhalten, um Deals abzuwickeln und die Abrechnung zu organisieren. Wir gehen davon aus, dass Käufer, Verkäufer, Agenturen und Werbetreibende eigene Strategien haben, um die Deal- und Sitz-IDs, die sie erhalten, zu interpretieren und zu verstehen.

Schritt-für-Schritt-Anleitung

So können Sie Deals in einer Protected Audience-Auktion ermöglichen:

  1. Der Käufer registriert die Deal- und Konto-IDs in der Konfiguration der Interessengruppe, bevor die Auktion ausgeführt wird.
    • Deal- und Seat-IDs können im Feld Auswählbare Berichts-IDs (selectableBuyerAndSellerReportingIds) festgelegt werden.
    • Wenn die Konto-ID für alle Deals gleich ist, kann sie in buyerAndSellerReportingId festgelegt werden. Die Deal-IDs können im Feld für auswählbare Berichts-IDs (selectableBuyerAndSellerReportingIds) festgelegt werden.
  2. Während der Gebotsgenerierung sind die Deal- und Nutzerlizenz‑IDs verfügbar. Der Käufer wählt eine Deal-ID aus selectableBuyerAndSellerReportingIds aus. Der Käufer generiert ein Gebot, das eine mit diesem Gebot verknüpfte Deal-ID enthält, indem er ein selectedBuyerAndSellerReportingId zurückgibt. Ein Gebot kann die Auktion nur gewinnen, wenn die zurückgegebene Angebots-ID zusammen mit anderen Berichts-IDs und ausgewählten Attributen der Interessengruppe k-anonym ist.
  3. Während der Anzeigenbewertung sind die ausgewählten Deal- und Sitzplatz-IDs für den Verkäufer verfügbar.
  4. Die Deal- und Sitzplatz-IDs sind in den Berichtsfunktionen des Verkäufers verfügbar.
  5. Die Deal- und Sitzplatz-IDs sind in den Berichtsfunktionen des Käufers verfügbar.

1. Registrierung von Deal- und Nutzerlizenz‑IDs

Der Käufer registriert die Deal- und Konto-IDs in der Konfiguration der Interessengruppe, bevor die Auktion ausgeführt wird. Die Deal- und Sitzplatz-IDs werden in selectableBuyerAndSellerReportingIds als String-Array festgelegt. Wenn die Sitzplatz-ID für alle Angebote gleich ist und nicht wiederholt werden muss, kann sie im Feld buyerAndSellerReportingId hinzugefügt werden, das einen String akzeptiert:

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);

Wenn die Sitzplatz-ID für die Deals unterschiedlich ist, kann die folgende Einrichtung verwendet werden:

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. Deal- und Nutzerlizenz-IDs für Käufer bei der Gebotsgenerierung

Bei der Gebotsgenerierung entscheidet der Käufer, ob er ein Gebot für eine Deal-ID abgeben möchte. In generateBid() kann der Käufer eine Deal-ID aus selectableBuyerAndSellerReportingIds auswählen und den Wert als selectedBuyerAndSellerReportingId zurückgeben. Das Gebot wird abgelehnt, wenn die ausgewählte Deal-ID nicht im selectableBuyerAndSellerReportingIds-Array enthalten ist.

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
  };
}

Ein Gebot mit einem zurückgegebenen Wert für selectedbuyerAndSellerReportingId kann die Auktion nur gewinnen, wenn der Wert von selectedbuyerAndSellerReportingId gemeinsam mit buyerAndSellerReportingId (falls vorhanden), buyerReportingId (falls vorhanden), dem Inhaber der Interessengruppe, der Gebotsskript-URL, der Render-URL und der Anzeigengröße (die Anzeigengröße ist bis mindestens zum 1. Quartal 2025 von dieser Prüfung ausgeschlossen) k-anonym ist.

Auch wenn selectablebuyerAndSellerReportingIds in der Konfiguration der Interessengruppe definiert ist, kann generateBid() ein Gebot zurückgeben, das keine selectedbuyerAndSellerReportingId enthält. In diesem Fall folgen die Reporting-IDs, die den Reporting-Funktionen zur Verfügung gestellt werden, wenn dieses Gebot gewinnt, dem Verhalten von nicht auswählbaren Reporting-IDs.

Wenn generateBid() noch einmal ausgeführt wird, weil bei der ersten Ausführung keine Gebote mit Anzeigen generiert wurden, die die Prüfungen zur k-Anonymität bestanden haben, sind selectableBuyerAndSellerReportingIds, die die Prüfung zur k-Anonymität nicht bestehen, bei der erneuten Ausführung nicht in der Interessengruppe enthalten.

3. Deal- und Nutzerlizenz-IDs für Verkäufer bei der Anzeigenbewertung

Die ausgewählte Deal-ID und eine eventuell vorhandene Nutzerlizenz-ID werden für scoreAd() zugänglich gemacht. Der Verkäufer gibt den Attraktivitätswert des erfolgreichen Gebots unter Berücksichtigung der Deal-ID und aller besonderen Bedingungen an. Wenn der Verkäufer der Meinung ist, dass die vom Käufer ausgewählte Deal-ID nicht zutrifft, lehnt er das Gebot ab, indem er ihm einen Empfehlenswertigkeitswert von null oder einen negativen Wert zuweist.

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

  // ...
}

4. Deal- und Nutzerlizenz‑IDs für Verkäuferberichte

Ein Gebot kann die Auktion nur gewinnen, wenn selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (falls vorhanden) und buyerReportingId (falls vorhanden) k-anonym mit dem Inhaber der Interessengruppe, der URL des Gebotsskripts, der Render-URL und der Anzeigengröße sind. Die Anzeigengröße wird bis mindestens zum ersten Quartal 2025 nicht in diese Prüfung einbezogen. Daher sind Berichts-ID-Werte, die selectedBuyerAndSellerReportingId enthalten, immer in reportResult() verfügbar. Auch wenn buyerReportingId auf k-Anonymität geprüft wird, ist der Wert nur für die Berichtsfunktion des Käufers und nicht für die Berichtsfunktion des Verkäufers verfügbar.

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

  // ...
}

5. Deal- und Nutzerlizenz‑IDs für Käuferberichte

Das gleiche Konzept für die Berichterstellung durch Verkäufer gilt auch für die Berichterstellung durch Käufer. Ein Gebot kann die Auktion nur gewinnen, wenn selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (falls vorhanden) und buyerReportingId (falls vorhanden) k-anonym mit dem Inhaber der Interessengruppe, der URL des Gebotsskripts, der Render-URL und der Anzeigengröße sind. Die Anzeigengröße wird bis mindestens zum ersten Quartal 2025 nicht in diese Prüfung einbezogen. Daher sind Berichts-ID-Werte, die selectedBuyerAndSellerReportingId enthalten, immer in reportWin() verfügbar.

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

Feedback geben