Deals in Protected Audience

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

Übersicht

Deals, die auch als privater Marktplatz (Private Marketplace, PMP) bezeichnet werden, bieten Käufern einen ausgewählten Zugriff oder Vorzugspreise für einen Teil des Inventars. Für programmatische Deals werden Sitzplatz-IDs und Deal-IDs verwendet:

  • Eine Nutzerlizenz-ID stammt vom Käufer und ist eine Kennung, die den Kunden des Käufers repräsentiert. Eine Nutzerlizenz-ID kann sich auf die Abrechnung auswirken, z. B. wenn für einen Sitzplatz bei einem bestimmten Verkäufer ein Rabatt gewährt wird.
  • 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 maßgeschneiderte Strategien zur Interpretation und Analyse der Deal-ID und Lizenzierungs-IDs haben, 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 Nutzerlizenz-IDs in der Interessengruppenkonfiguration, bevor die Auktion ausgeführt wird.
    • Deal- und Nutzerlizenz-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 Gebotserstellung werden die Deal- und Lizenz-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 Lizenz-IDs sind in den Berichtsfunktionen des Käufers verfügbar.

1. Registrierung von Angebots- und Sitz-IDs

Der Käufer registriert die Deal- und Nutzerlizenz-IDs in der Interessengruppenkonfiguration, bevor die Auktion ausgeführt wird. Die Deal-ID und die Sitz-ID werden in selectableBuyerAndSellerReportingIds als String-Array festgelegt. Wenn die ID der Nutzerlizenz für alle Deals gleich ist und nicht wiederholt werden muss, kann die ID 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
      buyerAndReportingId: '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(..., 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
  };
}

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

Auch wenn selectablebuyerAndSellerReportingIds in der Interessengruppenkonfiguration definiert ist, ist es für generateBid() weiterhin gültig, ein Gebot ohne selectedbuyerAndSellerReportingId zurückzugeben. In diesem Fall entsprechen die Berichts-IDs, die den Berichtsfunktionen zur Verfügung gestellt werden, wenn dieses Gebot gewinnt, dem Verhalten der nicht auswählbaren Berichts-ID.

In den Fällen, in denen generateBid() noch einmal ausgeführt wird, weil beim ersten Aufruf keine Gebote für Anzeigen ausgegeben wurden, die die k-Anonymitätsprüfungen bestanden haben, ist selectableBuyerAndSellerReportingIds, die die k-Anonymitätsprüfung 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 gegebenenfalls eine Nutzerlizenz-ID werden für scoreAd() freigegeben. 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 Berichts-ID-Werte, die ein 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 Nutzerlizenz-IDs für Käuferberichte

Das Konzept der Verkäuferberichte gilt auch für Kä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 Berichts-ID-Werte, die eine selectedBuyerAndSellerReportingId enthalten, immer in reportWin() verfügbar.

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

Interagieren und Feedback geben