Deals in Protected Audience

Deals, die auch als privaten Marktplatz bezeichnet werden, in einer Protected Audience-Auktion implementieren

Übersicht

Deals, auch als Private Marketplace (PMP) bezeichnet, bieten Käufern ausgewählten Zugriff oder bevorzugte Preise auf einen Teil des Inventars. Um programmatische Deals zu vereinfachen, werden Lizenz-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 Sitzplatz-ID kann Auswirkungen auf die Abrechnung haben, z. B. wenn für einen Sitzplatz ein Rabatt bei einem bestimmten Verkäufer gilt.
  • Eine Deal-ID stammt entweder vom Käufer oder vom Verkäufer. Sie ist eine Kennung, die eine Vereinbarung zwischen einem Käufer und einem Verkäufer darstellt. Eine Deal-ID kann Eigenschaften wie Kosten/Preis, Volumenzusicherung, Zielgruppeninformationen, Exklusivität und mehr umfassen.

Protected Audience erleichtert Deals durch die Verwendung von Berichts-IDs, die es ermöglichen, dass Lizenz- und Deal-IDs für Auktionsgebote, die Bewertung und Berichte verfügbar sind. Über die Berichts-IDs erhalten AdTech-Unternehmen die entsprechenden Deal- und Lizenz-IDs in Protected Audience-Berichten nach der Auktion. So können sie Deals abwickeln und die Abrechnung organisieren. Wir gehen davon aus, dass Käufer, Verkäufer, Agenturen und Werbetreibende individuelle Strategien haben, um die Deal- und Seat-IDs zu interpretieren und zu verstehen, die sie erhalten.

Schritt-für-Schritt-Anleitung

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

  1. Der Käufer registriert die Deal- und Anzeigenblock-IDs in der Konfiguration der Interessengruppe, bevor die Auktion gestartet wird.
    • Deal- und Sitzplatz-IDs können im Feld Auswählbare Berichts-IDs (selectableBuyerAndSellerReportingIds) festgelegt werden.
    • Wenn die Sitzplatz-ID für alle Deals identisch ist, kann sie in buyerAndSellerReportingId festgelegt werden. Die Deal-IDs können im Feld für auswählbare IDs für die Berichterstellung (selectableBuyerAndSellerReportingIds) festgelegt werden.
  2. Während der Geboterzeugung werden 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 Deal-ID enthält, die mit diesem Gebot verknüpft ist, indem er eine selectedBuyerAndSellerReportingId zurückgibt. Ein Gebot kann die Auktion nur gewinnen, wenn die zurückgegebene Deal-ID zusammen mit anderen Berichts-IDs k-anonym ist und Eigenschaften der Interessengruppe ausgewählt werden.
  3. Während der Anzeigenbewertung werden die ausgewählten Deal- und Lizenz-IDs für den Verkäufer verfügbar.
  4. Die Deal- und Lizenz-IDs sind in den Berichtsfunktionen des Verkäufers verfügbar.
  5. Die Deal- und Platz-IDs sind in den Berichtsfunktionen des Käufers verfügbar.

1. Registrierung von Angebots- und Sitz-IDs

Der Käufer registriert die Deal- und Anzeigenblock-IDs in der Konfiguration der Interessengruppe, bevor die Auktion gestartet wird. Die Deal- und Sitzplatz-IDs werden in selectableBuyerAndSellerReportingIds als Array von Strings festgelegt. Wenn die Sitzplatz-ID für alle Angebote identisch ist und nicht wiederholt werden muss, kann sie in das Feld buyerAndSellerReportingId eingefü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 sich die Nutzerlizenz-ID für die Deals unterscheidet, kann die folgende Konfiguration 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-ID und Nutzerlizenz-IDs für Käufer während der Gebotserstellung

Bei der Gebotserstellung entscheidet der Käufer, ob er auf eine Deal-ID bieten möchte. In generateBid() kann der Käufer eine Deal-ID aus selectableBuyerAndSellerReportingIds auswählen und als Wert selectedBuyerAndSellerReportingId zurückgeben. Das Gebot wird abgelehnt, wenn die ausgewählte Deal-ID nicht im Array selectableBuyerAndSellerReportingIds 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 URL des Gebotsscripts, der Render-URL und der Anzeigengröße k-anonym ist. Die Anzeigengröße ist bis mindestens Q1 2025 von dieser Prüfung ausgenommen.

Auch wenn selectablebuyerAndSellerReportingIds in der Konfiguration der Interessengruppe definiert ist, ist es zulässig, dass generateBid() ein Gebot zurückgibt, das keine selectedbuyerAndSellerReportingId enthält. In diesem Fall gelten für die Berichts-IDs, die den Berichtsfunktionen zur Verfügung gestellt werden, wenn dieses Gebot den Zuschlag erhält, die Vorgaben für nicht auswählbare Berichts-IDs.

Wenn generateBid() noch einmal ausgeführt wird, weil bei der ersten Ausführung keine Gebote mit Anzeigen abgegeben wurden, die die K-Anonymitätsprüfung bestanden haben, sind selectableBuyerAndSellerReportingIds, die die K-Anonymitätsprüfung nicht bestehen, bei der Wiederholung nicht in der Interessengruppe enthalten.

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

Die ausgewählte Deal-ID wird zusammen mit einer Lizenz-ID (falls vorhanden) für scoreAd() zugänglich gemacht. Der Verkäufer gibt die Erwünschtheit des erfolgreichen Gebots unter Berücksichtigung der Deal-ID und etwaiger Sonderbedingungen an. Sollte der Verkäufer der Meinung sein, dass die vom Käufer gewählte Deal-ID nicht zutrifft, lehnt er das Gebot ab, indem er ihm einen Wert von null oder einen negativen Wert für die Erwünschtheit einräumt.

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 Rendering-URL und der Anzeigengröße sind (die Anzeigengröße ist mindestens bis zum 1. Quartal 2025 von dieser Prüfung ausgeschlossen). Daher sind Werte für die Berichts-ID, die eine selectedBuyerAndSellerReportingId enthalten, immer in reportResult() verfügbar. Auch wenn bei buyerReportingId die k-Anonymität überprüft wird, ist der Wert nur für die Berichtsfunktion für Käufer und nicht für die Berichtsfunktion für Verkäufer verfügbar.

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

  // ...
}

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

Das Konzept der Verkäuferberichte gilt auch für Käuferberichte. Wie Sie wissen, kann ein Gebot nur dann die Auktion gewinnen, wenn selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (falls vorhanden) und buyerReportingId (falls vorhanden) k-anonym mit dem Inhaber der Interessengruppe, der URL des Gebotsscripts, der Render-URL und der Anzeigengröße sind. Die Anzeigengröße ist bis mindestens Q1 2025 von dieser Prüfung ausgenommen. Daher sind Berichts-ID-Werte, die ein 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;
}

Mit Nutzern interagieren und Feedback geben