Protected Audience API – Übersicht

On-Device-Anzeigenauktionen für Remarketing und benutzerdefinierte Zielgruppen ohne websiteübergreifendes Drittanbieter-Tracking.

An wen richtet sich dieses Dokument?

In diesem Dokument werden die Grundlagen der Protected Audience API und einige zugrunde liegende Konzepte erläutert. Es enthält jedoch keine detaillierten technischen Informationen.

Im Glossar finden Sie Definitionen der Begriffe, die in der Protected Audience-Dokumentation verwendet werden. Am Ende dieses Dokuments erfahren Sie, wie Sie Feedback geben und teilen können.

Was ist die Protected Audience API?

Die Protected Audience API ist eine Privacy Sandbox-Technologie für Anwendungsfälle mit Remarketing und benutzerdefinierten Zielgruppen, die so konzipiert ist, dass Dritte das Browserverhalten von Nutzern nicht über Websites hinweg verfolgen können.

Die Protected Audience API ermöglicht es dem Browser, Auktionen auf dem Gerät durchzuführen, um relevante Anzeigen von Websites auszuwählen, die der Nutzer zuvor besucht hat.

Die Protected Audience API ist das erste Experiment, das in Chromium im Rahmen der TURTLEDOVE-Vorschläge implementiert wird. Der Unterschied zwischen Protected Audience und TURTLEDOVE bezieht sich hauptsächlich auf die Trennung der On-Device-Rolle des Anzeigenkäufers und -verkäufers. In den folgenden Abschnitten wird die Funktionsweise der Protected Audience API erläutert.

Die Protected Audience API in einer Minute

Einen detaillierteren Überblick über die Protected Audience API finden Sie im Entwicklerleitfaden zur Protected Audience API.

Übersicht über die einzelnen Phasen des Protected Audience API-Lebenszyklus
Lebenszyklus der Protected Audience API

Bei der Protected Audience API werden Interessengruppen verwendet, damit auf Websites Anzeigen präsentiert werden können, die für die Nutzer relevant sind.

Wenn ein Nutzer beispielsweise eine Website besucht, auf der für Produkte geworben wird, kann der Inhaber einer Interessengruppe (z. B. eine Demand-Side-Platform (DSP)) den Browser des Nutzers auffordern, die Mitgliedschaft in der Interessengruppe hinzuzufügen. Wenn die Anfrage erfolgreich ist, werden im Browser folgende Daten aufgezeichnet:

  • Der Name der Interessengruppe, z. B. „custom-bikes“.
  • Der Inhaber der Interessengruppe, z. B. „https://dsp.example“.
  • Konfigurationsinformationen für die Interessengruppe, damit der Browser auf Gebotscode, Anzeigencode und Echtzeitdaten zugreifen kann, wenn der Inhaber der Gruppe zu einer Anzeigenauktion eingeladen wird.

Wenn der Nutzer später eine Website mit verfügbarer Werbefläche besucht, kann der Verkäufer der Werbefläche (ein Sell-Side-Anbieter (SSP) oder die Website selbst) mithilfe von Protected Audience eine Anzeigenauktion durchführen, um die für den Nutzer am besten geeigneten Anzeigen auszuwählen. Der Verkäufer ruft die Funktion navigator.runAdAuction() auf, die eine Liste der Inhaber von Interessengruppen enthält, die zum Abgeben von Geboten eingeladen werden.

Gebote können nur von Interessengruppen abgegeben werden, denen der Browser angehört und deren Inhaber zum Abgeben von Geboten eingeladen wurden.

Der Gebotscode wird über eine URL abgerufen, die in der Konfiguration der Interessengruppe angegeben ist. Dieser Code enthält Daten zur Interessengruppe und Informationen des Verkäufers sowie Kontextdaten zur Seite und zum Browser.

Jede Interessengruppe, die ein Gebot abgibt, wird als Käufer bezeichnet.

Wenn der Browser die Funktion zum Ausführen der Anzeigenauktion aufruft, wird mit dem Code jedes Käufers ein Gebot generiert. Dazu werden Echtzeitdaten verwendet, die vom Protected Audience-Schlüssel/Wert-Dienst des Käufers bereitgestellt werden. Der Verkäufer erhält dann diese Gebote sowie seine eigenen Echtzeitdaten und bewertet jedes Gebot. Das Gebot mit der höchsten Punktzahl gewinnt die Auktion.

Die Gewinneranzeige wird in einem eingezäunten Frame angezeigt. Die URL des Anzeigen-Creatives wird im Gebot angegeben und der Ursprung muss mit einem Eintrag in der Liste übereinstimmen, die in der Konfiguration der Interessengruppe angegeben ist.

Der Verkäufer kann das Ergebnis der Auktion (reportResult()) und Käufer ihre Gewinne (reportWin()) melden.

Weitere Informationen zu Protected Audience-Auktionsberichten

Warum benötigen wir die Protected Audience API?

Wenn Sie die Interessen der Nutzer kennen, können Sie relevantere Anzeigen schalten, als wenn Sie Anzeigen nur basierend auf dem Websitecontent (Kontext-Targeting) oder anhand von Informationen auswählen, die ein Nutzer auf der Website angibt, auf der die Anzeige ausgeliefert wird (Targeting mit eigenen Daten).

Bisher haben Werbeplattformen Nutzerinteressen ermittelt, indem sie das Verhalten der Nutzer auf verschiedenen Websites verfolgt haben. Browser benötigen eine Möglichkeit, Werbeplattformen die Auswahl relevanter Anzeigen zu ermöglichen, damit Content-Publisher Werbeeinnahmen erzielen können, ohne dass ein websiteübergreifendes Tracking erfolgt.

Ziel der Protected Audience API ist es, die Webplattform so zu gestalten, dass der Browser des Nutzers auf seinem Gerät und nicht der Werbetreibende oder die Ad-Tech-Plattformen Informationen darüber enthält, wofür sich die Person interessiert.

Wie kann ich die Protected Audience API ausprobieren?

  • Im Entwicklerleitfaden zur Protected Audience API wird beschrieben, wie Sie die API verwenden und lokal testen.

  • Unter protected-audience-demo.web.app finden Sie eine Anleitung für die grundlegende Protected Audience-Bereitstellung auf Websites von Werbetreibenden und Publishern. Im Demovideo zur Protected Audience API wird erläutert, wie dieser Code funktioniert. Außerdem wird gezeigt, wie Sie die Chrome-Entwicklertools zum Debuggen verwenden können.

Welche Browserkonfiguration ist verfügbar?

Nutzer können ihre Teilnahme an Privacy Sandbox-Tests in Chrome anpassen, indem sie die Einstellung auf oberster Ebene in chrome://settings/adPrivacy aktivieren oder deaktivieren. Während der ersten Testphase können Nutzer die Protected Audience API über die Privacy Sandbox-Einstellungen deaktivieren.

In Chrome soll es Nutzern möglich sein, die Liste der Interessengruppen, denen sie auf den von ihnen besuchten Websites hinzugefügt wurden, anzusehen und zu verwalten. Wie bei den Privacy Sandbox-Technologien können sich die Nutzereinstellungen aufgrund von Feedback von Nutzern, Aufsichtsbehörden und anderen ändern.

Wir werden die verfügbaren Einstellungen in Chrome im Laufe der Entwicklung der Protected Audience API auf Grundlage von Tests und Feedback aktualisieren. In Zukunft werden wir detailliertere Einstellungen zur Verwaltung von Protected Audience und zugehörigen Daten anbieten.

API-Aufrufer können nicht auf die Gruppenmitgliedschaft zugreifen, wenn Nutzer im Inkognitomodus surfen. Die Mitgliedschaft wird entfernt, wenn Nutzer ihre Websitedaten löschen.

Kann ich die Protected Audience API deaktivieren?

Weitere Informationen zum Blockieren des Zugriffs auf die Protected Audience API als Websiteinhaber oder einzelner Nutzer

Wichtige Konzepte

Möchten Sie mehr über die Terminologie von Protected Audience erfahren? Glossar zur Privacy Sandbox

Was ist eine Interessengruppe?

Eine Protected Audience API-Interessengruppe stellt eine Gruppe von Personen mit einem gemeinsamen Interesse dar, das einer Remarketing-Liste entspricht.

Jede Interessengruppe der Protected Audience API hat einen Inhaber. Verschiedene Arten von Inhabern erstellen unterschiedliche Arten von Interessengruppen mit unterschiedlichen Anwendungsfällen.

Der Inhaber fordert den Browser des Nutzers auf, die Mitgliedschaft in seiner Interessengruppe hinzuzufügen, indem er die JavaScript-Funktion navigator.joinAdInterestGroup() aufruft und Informationen wie Daten zu Anzeigen, die für die Interessengruppe relevant sind, sowie eine URL für JavaScript bereitstellt, das bei Geboten verwendet wird. Interessengruppendaten (z. B. die Anzeigen) können aktualisiert werden und eine Interessengruppe kann bis zu 30 Tage lang aktiviert werden.

Arten von Interessengruppen

In der folgenden Tabelle finden Sie Beispiele für verschiedene Arten von Interessengruppen und Eigentümern der Protected Audience API.

Inhaber Beispiel Interesse Beispiel Anwendungsfälle
Advertiser Fahrradhersteller Produkte Nutzer, die sich Produktseiten für eine bestimmte Kategorie von Fahrrädern angesehen haben. Remarketing für Nutzer, die bereits mit der Marke interagiert haben.
Publisher Nachrichtenwebsite Inhalt Nutzer, die sich über Radfahren informieren. Publisher können selbst erhobene Daten verwenden, damit Werbetreibende Anzeigen kaufen können, die für die Leser auf ihrer Website relevant sind. Mit einer Interessengruppe, die einem Publisher gehört, könnten Publisher dasselbe tun, auch wenn diese Personen andere Websites besuchen. Publisher können möglicherweise Gebühren für die Möglichkeit erheben, Anzeigen für bestimmte Segmente ihrer Zielgruppe zu schalten.
AdTech DSP Produktkategorie Personen, die Interesse an Fahrradzubehör gezeigt haben. Ein Ad-Tech-Unternehmen kann eine Interessengruppe von Nutzern erstellen und verwalten, die seiner Meinung nach an einer bestimmten Artikelkategorie interessiert sind. Diese Interessengruppe könnte dann verwendet werden, um Produkte auf Websites zu bewerben, auf denen Artikel in dieser Kategorie verkauft werden und die mit dem Unternehmen, das Anzeigentechnologien anbietet, zusammenarbeiten.

In Chrome sind bis zu 1.000 Interessengruppen pro Inhaber und bis zu 1.000 Inhaber von Interessengruppen zulässig. Diese Grenzwerte sind als Leitlinien gedacht und sollten im normalen Betrieb nicht erreicht werden.

Was ist ein Käufer?

In der Protected Audience API ist ein Käufer eine Partei, die eine Interessengruppe besitzt und bei einer Anzeigenauktion Gebote abgibt.

Beispiel:

Käufer haben drei Aufgaben:

  • Wählen Sie aus, ob Sie an einer Auktion teilnehmen möchten.
  • Wählen Sie Anzeigen aus und berechnen Sie ein Gebot.
  • Das Auktionsergebnis melden.

Diese Aufgaben werden programmatisch in Code ausgeführt, der vom Käufer bereitgestellt wird und während einer Anzeigenauktion mit der Protected Audience API ausgeführt wird.

Wenn ein Käufer den Browser eines Nutzers auffordert, eine Interessengruppe zu den Gruppen hinzuzufügen, denen er angehört (durch Aufrufen der JavaScript-Funktion navigator.joinAdInterestGroup()), stellt der Käufer dem Browser Folgendes zur Verfügung:

  • Eine URL für den Gebotscode, der verwendet wird, wenn der Verkäufer eine Anzeigenauktion durchführt.
  • Möglicherweise URLs für Anzeigen-Creatives für die Interessengruppe. Anzeigen-URLs können später mit einem Update hinzugefügt werden.
  • Eine Liste der abzufragenden Datenschlüssel und die URL des Schlüssel/Wert-Dienstes des Käufers, damit der Gebotscode während einer Auktion Echtzeitdaten abrufen kann.

Der Code des Käufers kann auch eine reportWin()-Funktion enthalten, um das Auktionsergebnis zu melden.

Wer führt eine Anzeigenauktion durch?

Es gibt mehrere Parteien, die eine Auktion durchführen können, um Werbeflächen zu verkaufen.

Beispiel:

  • Content-Publisher: handelt in eigener Verantwortung, um Anzeigeninhalte auf seiner Website zu hosten.
  • Supply-Side-Plattform (SSP): Zusammenarbeit mit dem Publisher und Bereitstellung anderer Dienste.
  • Drittanbieterskript: Wird im Auftrag eines Publishers verwendet, um die Teilnahme an Anzeigenauktionen zu ermöglichen.

Mit der Protected Audience API hat ein Verkäufer von Anzeigenplätzen drei Aufgaben:

  • Publisher-Regeln durchsetzen: Festlegen, welche Käufer und Gebote infrage kommen.
  • Auktionslogik ausführen: JavaScript, das in Worklets ausgeführt wird, um für jedes Gebot einen Wert für die Eignung zu berechnen.
  • Das Auktionsergebnis melden.

Diese Aufgaben werden programmatisch in Code ausgeführt, der vom Verkäufer bereitgestellt wird, wenn er eine Anzeigenauktion durch Aufrufen der JavaScript-Funktion navigator.runAdAuction() initiiert.

Wie funktioniert eine Anzeigenauktion mit der Protected Audience API?

Im folgenden Diagramm sind die einzelnen Phasen einer Anzeigenauktion mit der Protected Audience API dargestellt:

Sechs Phasen einer Anzeigenauktion mit der Protected Audience API
Phasen der Anzeigenauktion für Protected Audience.

Bei der Protected Audience API ist eine Anzeigenauktion eine Sammlung kleiner JavaScript-Programme, die der Browser auf dem Gerät des Nutzers ausführt, um eine Anzeige auszuwählen. Aus Datenschutzgründen wird der gesamte Code für die Anzeigenauktion von Verkäufern und Käufern in isolierten JavaScript-Worklets ausgeführt, die nicht mit der Außenwelt kommunizieren können.

Ein Verkäufer (ein Publisher oder eine Supply-Side-Plattform) startet eine Protected Audience-Anzeigenauktion auf einer Website, auf der Werbeflächen verkauft werden (z. B. eine Nachrichtenwebsite). Der Verkäufer wählt Käufer aus, die an der Auktion teilnehmen dürfen, gibt an, welche Werbefläche zum Verkauf steht, und legt zusätzliche Kriterien für die Anzeige fest. Jeder Käufer ist Inhaber einer Interessengruppe.

Der Verkäufer stellt dem Browser Code zum Bewerten von Geboten zur Verfügung. Dieser enthält den Wert jedes Gebots, die URL des Anzeigen-Creatives und andere Daten, die von den einzelnen Käufern zurückgegeben werden. Während der Auktion können Gebotscode von Käufern und Code für die Gebotsbewertung vom Verkäufer Daten von ihren Schlüssel/Wert-Diensten empfangen. Sobald eine Anzeige ausgewählt und in einem eingezäunten Frame (um den Datenschutz zu wahren) ausgeliefert wurde, können der Verkäufer und der erfolgreiche Käufer das Auktionsergebnis melden.

  1. Ein Nutzer besucht eine Website, auf der Anzeigen ausgeliefert werden.
  2. Der Code des Verkäufers startet eine Auktion. Der Verkäufer gibt an, welche Werbefläche zum Verkauf steht und wer Gebote abgeben kann. Außerdem legt er eine Methode zur Bewertung der Gebote fest.
  3. Der Code des eingeladenen Käufers wird ausgeführt, um ein Gebot, eine URL für ein relevantes Anzeigen-Creative und andere Daten zu generieren. Das Gebotsskript kann Echtzeitdaten wie das verbleibende Budget der Werbekampagne vom Schlüssel/Wert-Dienst des Käufers abfragen.
  4. Der Code des Verkäufers bewertet jedes Gebot und wählt einen Gewinner aus. Bei dieser Logik werden der Gebotswert und andere Daten verwendet, um die Attraktivität eines Gebots zu ermitteln und eine Anzeige abzulehnen, die nicht besser als die kontextbezogene Gewinneranzeige ist. Der Verkäufer kann seinen eigenen Schlüssel/Wert-Dienst für Echtzeitdaten verwenden. Bevor eine Auktion beginnt, sucht der Verkäufer die beste kontextbezogene Anzeige für den verfügbaren Anzeigenblock.
  5. Die Gewinneranzeige wird als Konfigurationsobjekt für den eingeschlossenen Frame zurückgegeben, wenn das Flag resolveToConfig in der Auktionskonfiguration festgelegt ist. Die Konfiguration wird verwendet, um den eingeschränkten Frame zum Creative zu navigieren. Die URL des Creatives ist sowohl für den Verkäufer als auch für den Publisher verborgen. Wenn das resolveToConfig-Flag auf false gesetzt oder nicht übergeben wird, wird die Gewinneranzeige als undurchsichtige URN zurückgegeben, mit der die Anzeige in einem iFrame gerendert werden kann. Das Konfigurationsobjekt für den eingeschränkten Frame ist ab M114 verfügbar.
  6. Die Auktion wird dem Verkäufer und den Käufern, die die Auktion gewonnen haben, gemeldet.

Ein Mechanismus zur Berichterstellung für verlorene Käufer wird derzeit diskutiert.

Was ist ein Schlüssel/Wert-Dienst für die Protected Audience API?

Mit dem Schlüssel/Wert-Dienst der Protected Audience API können Ad-Tech-Unternehmen Echtzeitdaten abfragen, wenn ein Gebot vom Käufer abgegeben wird, und Verkäufer Anzeigen bewerten, ohne die Privatsphäre zu beeinträchtigen. Weitere Informationen zum Schlüssel/Wert-Dienst der Protected Audience API und anderen Diensten finden Sie unter Protected Audience API-Dienste.

Der Key/Value-Dienst wird in der Cloud-Infrastruktur des Ad-Tech-Unternehmens bereitgestellt und in einer vertrauenswürdigen Ausführungsumgebung ausgeführt. Eine Anfrage an einen Schlüssel/Wert-Dienst kann nicht zu einer Protokollierung auf Ereignisebene führen oder andere Nebeneffekte haben. Der Schlüssel/Wert-Dienst unterstützt auch benutzerdefinierte Funktionen (UDFs), mit denen Ad-Tech-Unternehmen ihre eigene benutzerdefinierte Logik im Schlüssel/Wert-Dienst ausführen können.

Ein Käufer oder Verkäufer gibt eine Liste von „Schlüsseln“ an, um die Daten anzugeben, die er von einem Schlüssel/Wert-Dienst der Protected Audience API benötigt. Der Schlüssel/Wert-Dienst antwortet mit einem Wert für jeden Schlüssel.

Der Code für den Protected Audience API-Schlüssel/Wert-Dienst ist jetzt in einem GitHub-Repository für die Privacy Sandbox verfügbar. Dieser Dienst kann von Chrome- und Android-Entwicklern verwendet werden.

Weitere Informationen zum Key/Value-Dienst der Protected Audience API finden Sie in der API-Dokumentation und in der Dokumentation zum Vertrauensmodell.

Wie werden Echtzeitdaten in Auktionen einbezogen?

Die Käufer oder Verkäufer in einer Anzeigenauktion benötigen möglicherweise Zugriff auf Echtzeitdaten. Käufer möchten beispielsweise das verbleibende Budget in einer Werbekampagne berechnen oder der Verkäufer muss Werbe-Creatives anhand der Publisher-Richtlinien prüfen.

Um die Datenschutzanforderungen der Protected Audience API zu erfüllen, werden Echtzeitdaten, die während einer Anzeigenauktion erforderlich sind, vom Schlüssel/Wert-Dienst bereitgestellt. Wenn ein Käufer navigator.joinAdInterestGroup() aufruft, gibt er eine Schlüssel/Wert-Dienst-URL und die Schlüssel an, die während einer Auktion beim Dienst abgefragt werden sollen. Wenn der Verkäufer eine Anzeigenauktion durch Aufrufen von navigator.runAdAuction() durchführt, stellt er eine URL für seinen Schlüssel/Wert-Dienst bereit. Der Key/Value-Dienst des Verkäufers wird mit der Render-URL des Creatives abgefragt.

Für erste Tests wird das Modell Bring Your Own Server verwendet. Langfristig müssen Ad-Tech-Unternehmen die Open-Source-Schlüssel/Wert-Dienste der Protected Audience API verwenden, die in vertrauenswürdigen Ausführungsumgebungen ausgeführt werden, um Echtzeitdaten abzurufen.

Damit das Ökosystem genügend Zeit zum Testen hat, gehen wir davon aus, dass die Verwendung der Open-Source-Schlüssel/Wert-Dienste oder vertrauenswürdiger Ausführungsumgebungen erst einige Zeit nach der Einstellung von Drittanbieter-Cookies erforderlich sein wird. Wir werden Entwickler rechtzeitig benachrichtigen, damit sie mit dem Testen und der Umstellung beginnen können, bevor die Umstellung erfolgt.

Wie werden selbst erhobene Daten in einer Protected Audience-Auktion verwendet?

Selbst erhobene Daten sind Daten, die der Website gehören und die sie über ihre Nutzer erhebt. Wenn ein Nutzer beispielsweise auf der Website des Werbetreibenden oder Publishers seine Lieblingsfarbe angegeben hat, gilt diese Farbe als selbst erhobene Daten.

Bei einer Protected Audience-Auktion kann der Werbetreibende seine selbst erhobenen Daten verwenden, um die Mitgliedschaft in der Anzeigengruppe mit Interessen zu bestimmen. Außerdem kann er Daten als userBiddingSignals in die Interessengruppe übergeben. Die selbst erhobenen Daten des Werbetreibenden sind nur für die Käufer während der Gebotsgenerierung verfügbar, nicht für die Verkäufer.

Wenn der Werbetreibende beispielsweise die Lieblingsfarbe des Nutzers kennt, kann der Wert in der Konfiguration der Interessengruppe als userBiddingSignals festgelegt werden, wenn der Nutzer einer Interessengruppe hinzugefügt wird:

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

Der Publisher kann seine selbst erhobenen Daten auch übergeben, indem er die Signale beim Starten der Auktion in der Auktionskonfiguration festlegt. Außerdem kann er festlegen, wer die selbst erhobenen Daten erhält. Wenn ein Publisher die selbst erhobenen Daten als auctionSignals übergibt, sind sie sowohl für Käufer als auch für Verkäufer verfügbar. Wenn die Daten als sellerSignals übergeben werden, sind sie nur für den Verkäufer verfügbar. Wenn sie als perBuyerSignals übergeben werden, sind sie nur für die angegebenen Käufer verfügbar. Der Publisher kann auch selbst erhobene Daten an Komponentenauktionen übergeben. Der Publisher und die Auktionsbeteiligten sollten sich vorab darauf einigen, welche selbst erhobenen Daten weitergegeben werden müssen und wie die Daten formatiert werden müssen.

Im folgenden Beispiel wird beschrieben, wie der Publisher die Erstanbieterdaten an verschiedene Auktionsteilnehmer weitergeben kann:

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

Weitere Informationen

Einen detaillierteren Überblick über die Protected Audience API finden Sie im Entwicklerleitfaden zur Protected Audience API.

Entwickler

Wenn Sie mit der Protected Audience API arbeiten möchten, lesen Sie den Abschnitt Experimentieren und teilnehmen.

Wir haben einen Leitfaden für API-Entwickler erstellt und eine Demo der Protected Audience API entwickelt, die eine Anleitung für die grundlegende Bereitstellung der Protected Audience API enthält. Im Demovideo zur Protected Audience API wird die Funktionsweise des Democodes erläutert und gezeigt, wie Sie die Chrome-Entwicklertools für das Debugging der Protected Audience API verwenden.

Feedback geben