Protected Audience API – Übersicht

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

An wen richtet sich dieser Artikel?

In diesem Artikel werden die Grundlagen der Protected Audience API und einige zugrunde liegende Konzepte erläutert. Allerdings werden hier nicht viele technische Details erläutert.

Im Glossar finden Sie die in der Protected Audience-Dokumentation verwendeten Begriffe. Am Ende dieses Artikels erfahren Sie, wie Sie Feedback geben und interagieren.

Was ist die Protected Audience API?

Die Protected Audience API ist eine Privacy Sandbox-Technologie zur Bereitstellung von Remarketing und benutzerdefinierten Zielgruppen für Anwendungsfälle. Sie wurde so entwickelt, dass Drittanbieter das Browserverhalten von Nutzern nicht websiteübergreifend nachverfolgen können.

Die Protected Audience API ermöglicht On-Device-Auktionen im Browser, um relevante Anzeigen von Websites auszuwählen, die der Nutzer zuvor besucht hat.

Die Protected Audience API ist der erste Test, der in Chromium innerhalb der TURTLEDOVE-Angebote implementiert wird. Der Unterschied zwischen Protected Audience und TURTLEDOVE bezieht sich hauptsächlich auf die Trennung der Rolle des Käufers und des Verkäufers auf dem Gerät. In den folgenden Abschnitten wird die Funktionsweise der Protected Audience API erläutert.

Protected Audience API in einer Minute

Eine ausführlichere Übersicht über die Protected Audience API finden Sie im Entwicklerleitfaden für die 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 ausgeliefert werden können, die für ihre Nutzer relevant sind.

Wenn ein Nutzer beispielsweise eine Website besucht, auf der für seine Produkte geworben werden soll, kann ein Inhaber einer Interessengruppe (z. B. eine Demand-Side-Plattform (DSP)) den Browser des Nutzers auffordern, eine Mitgliedschaft für die Interessengruppe hinzuzufügen. Wenn die Anfrage erfolgreich ist, zeichnet der Browser Folgendes auf:

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

Wenn der Nutzer später eine Website mit verfügbaren Werbeflächen 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 am besten geeigneten Anzeigen für den Nutzer auszuwählen. Der Verkäufer ruft die Funktion navigator.runAdAuction() auf, mit der eine Liste der Inhaber der Interessengruppe bereitgestellt wird, die zum Gebot eingeladen wurden.

Gebote können nur von Interessengruppen abgegeben werden, zu denen der Browser gehört und deren Inhaber zu einem Gebot eingeladen wurden.

Der Gebotscode wird von einer URL abgerufen, die in der Konfiguration der Interessengruppe angegeben ist. Dieser Code liefert Daten zur Interessengruppe, Informationen vom Verkäufer sowie Kontextdaten zur Seite und vom Browser.

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

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

Die erfolgreiche Anzeige wird in einem Fenced Frame präsentiert. Die URL der Anzeige ist im Gebot angegeben und der Ursprung muss mit einem Ursprung in der Liste übereinstimmen, die in der Konfiguration der Interessengruppe bereitgestellt wird.

Der Verkäufer kann das Auktionsergebnis melden (reportResult()) und Käufer können ihre Gewinne melden (reportWin()).

Weitere Informationen zu Protected Audience-Auktionsberichten

Wozu dient die Protected Audience API?

Wenn Sie die Interessen der Nutzer verstehen, können relevantere Anzeigen geschaltet werden, als wenn nur Anzeigen auf Grundlage des Websiteinhalts ausgewählt werden (Kontext-Targeting) oder die Informationen verwendet werden, die ein Nutzer der Website bereitgestellt hat, auf der die Anzeige erscheint (Ausrichtung auf selbst erhobene Daten).

Traditionell haben Werbeplattformen die Interessen der Nutzer erfasst, indem sie ihr Verhalten websiteübergreifend erfassen. Browser benötigen eine Möglichkeit, über Anzeigenplattformen relevante Anzeigen auszuwählen, damit Content-Publisher ohne websiteübergreifendes Tracking Werbeeinnahmen erzielen können.

Die Protected Audience API zielt darauf ab, die Webplattform in einen Zustand zu bringen, in dem der Browser des Nutzers auf seinem Gerät – nicht die Plattform des Werbetreibenden oder der AdTech-Plattform – Informationen darüber enthält, woran diese Person interessiert ist.

Wie kann ich die Protected Audience API testen?

  • Im Entwicklerleitfaden für die Protected Audience API wird beschrieben, wie die API verwendet und lokal getestet wird.

  • protection-audience-demo.web.app bietet eine Schritt-für-Schritt-Anleitung für die grundlegende Bereitstellung von Protected Audience auf Websites von Werbetreibenden und Publishern. Im Protected Audience-Demovideo wird die Funktionsweise dieses Codes erklärt. Außerdem wird in einer Vorschau angezeigt, wie die Chrome-Entwicklertools für die Fehlerbehebung verwendet werden.

Welche Browserkonfiguration ist verfügbar?

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

In Chrome wird geplant, dass Nutzer die Liste der Interessengruppen, denen sie auf den von ihnen besuchten Websites hinzugefügt wurden, ansehen und verwalten können. Wie bei den Technologien der Privacy Sandbox können sich die Nutzereinstellungen mit dem Feedback von Nutzern, Aufsichtsbehörden und anderen Personen weiterentwickeln.

Im Laufe der Protected Audience API werden die verfügbaren Einstellungen in Chrome basierend auf Tests und Feedback aktualisiert. 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?

Sie können den Zugriff auf die Protected Audience API blockieren – entweder als Websiteinhaber oder als einzelner Nutzer.

Schlüsselkonzepte

Möchten Sie mehr über die Protected Audience-Terminologie erfahren? Weitere Informationen finden Sie im Glossar zur Privacy Sandbox.

Was ist eine Interessengruppe?

Eine Protected Audience API-Interessengruppe repräsentiert eine Gruppe von Personen mit gemeinsamen Interessen, die einer Remarketing-Liste entsprechen.

Jede Protected Audience API-Interessengruppe hat einen Inhaber. Unterschiedliche Inhabertypen erstellen unterschiedliche Arten von Interessengruppen für unterschiedliche Anwendungsfälle.

Der Inhaber bittet den Browser des Nutzers, eine Mitgliedschaft zu seiner Interessengruppe hinzuzufügen. Dazu ruft er die JavaScript-Funktion navigator.joinAdInterestGroup() auf. Dabei werden Informationen wie Daten zu Anzeigen, die für die Interessengruppe relevant sind, und eine URL für JavaScript zur Verfügung gestellt, die bei Geboten verwendet werden. Daten zu Interessengruppen (z. B. Anzeigen) können aktualisiert werden und eine Interessengruppe kann für bis zu 30 Tage aktiviert sein.

Typen von Interessengruppen

Die folgende Tabelle enthält Beispiele für verschiedene Arten von Protected Audience API-Interessengruppen und -Inhabern.

Inhaber Beispiel Interesse Beispiel Anwendungsfälle
Advertiser Fahrradhersteller Produkte Nutzer, die Produktseiten für eine bestimmte Fahrradkategorie aufgerufen haben. Remarketing für Nutzer, die bereits mit der Marke interagiert haben
Publisher Nachrichtenwebsite Inhalte Personen, die über Radfahren lesen. Mit selbst erhobenen Daten können Verlage und Webpublisher Anzeigen kaufen, die für die Leser auf ihrer Website relevant sind. Eine Interessengruppe, die dem Publisher gehört, könnte es Publishern ermöglichen, dasselbe zu tun, selbst wenn sie andere Websites besuchen. Publisher können unter Umständen Gebühren für die Auslieferung von Anzeigen für bestimmte Zielgruppensegmente erheben.
AdTech DSP Produktkategorie Personen, die sich für Fahrradausrüstung interessiert haben. Ein Unternehmen für Anzeigentechnologie könnte eine Interessengruppe von Personen erstellen und verwalten, die sich für eine bestimmte Artikelkategorie interessieren. Diese Interessengruppe könnte dann verwendet werden, um Produkte auf Websites zu bewerben, auf denen Produkte dieser Kategorie verkauft werden und die mit dem Unternehmen für Anzeigentechnologie zusammenarbeiten.

In Chrome sind bis zu 1.000 Interessengruppen pro Inhaber und bis zu 1.000 Interessengruppeninhaber zulässig. Diese Grenzwerte sind als Leitplanken gedacht und dürfen im normalen Betrieb nicht erreicht werden.

Was ist ein Käufer?

In der Protected Audience API ist ein Käufer Inhaber einer Interessengruppe und bietet in einer Anzeigenauktion.

Beispiel:

Käufer haben drei Jobs:

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

Diese Jobs werden programmatisch in dem vom Käufer bereitgestellten Code ausgeführt, der während einer Protected Audience API-Anzeigenauktion ausgeführt wird.

Wenn ein Käufer den Browser eines Nutzers auffordert, den Gruppen, zu denen er gehört, eine Interessengruppe hinzuzufügen (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 mit einer Aktualisierung später hinzugefügt werden.
  • Eine Liste der abzufragenden Datenschlüssel und die URL des Schlüssel/Wert-Diensts des Käufers, damit der Gebotscode während einer Auktion Echtzeitdaten abrufen kann.

Der Code des Käufers kann auch eine reportWin()-Funktion enthalten, mit der das Auktionsergebnis gemeldet wird.

Wer führt eine Anzeigenauktion durch?

Es gibt mehrere Parteien, die eine Auktion zum Verkauf von Werbeflächen durchführen.

Beispiel:

  • Content-Publisher: Hostet Anzeigeninhalte auf seiner Website für sich selbst.
  • Supply-Side-Plattform (SSP): Zusammenarbeit mit dem Publisher und Bereitstellung anderer Dienste
  • Drittanbieter-Script: Aktion für einen Publisher, um die Teilnahme an Anzeigenauktionen zu ermöglichen

Mit der Protected Audience API hat ein Anzeigenflächenverkäufer drei Aufgaben:

  • Publisher-Regeln durchsetzen, um anzugeben, welche Käufer und welche Gebote berechtigt sind
  • Auktionslogik ausführen: JavaScript wird in Worklets ausgeführt, um für jedes Gebot einen gewünschten Wert zu berechnen.
  • Melden Sie das Auktionsergebnis.

Diese Aufträge werden programmatisch in dem Code ausgeführt, der vom Verkäufer beim Initiieren einer Anzeigenauktion durch Aufrufen der JavaScript-Funktion navigator.runAdAuction() bereitgestellt wird.

Wie funktioniert eine Anzeigenauktion der Protected Audience API?

Im folgenden Diagramm werden die einzelnen Phasen einer Protected Audience API-Anzeigenauktion veranschaulicht:

Sechs Phasen einer Protected Audience API-Anzeigenauktion
Phasen der Protected Audience-Anzeigenauktion.

In 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 Auktionscode des Verkäufers und Käufers in isolierten JavaScript-Workstations ausgeführt, die nicht mit der Außenwelt kommunizieren können.

Ein Verkäufer (ein Publisher oder eine Supply-Side-Plattform) initiiert eine Protected Audience-Anzeigenauktion auf einer Website, auf der Werbefläche verkauft wird (z. B. eine Nachrichtenwebsite). Der Verkäufer wählt die Käufer für die Auktion aus, gibt die zum Verkauf angebotenen Flächen an und stellt zusätzliche Kriterien für die Anzeige bereit. Jeder Käufer ist Inhaber einer Interessengruppe.

Der Verkäufer stellt dem Browser den Code zur Bewertung von Geboten zur Verfügung. Dieser umfasst den Wert der einzelnen Gebote, die Creative-URL und andere von den einzelnen Käufern zurückgegebene Daten. Während der Auktion können der Gebotscode von Käufern und der Gebotscode vom Verkäufer Daten von seinen Schlüssel/Wert-Diensten empfangen. Nachdem eine Anzeige ausgewählt und aus Datenschutzgründen in einem Fenced Frame dargestellt wurde, können der Verkäufer und der gewinnende Käufer das Auktionsergebnis melden.

  1. Ein Nutzer besucht eine Website, auf der Anzeigen geschaltet werden.
  2. Mit dem Verkäufercode wird eine Auktion gestartet. Der Verkäufer legt fest, welche Werbefläche verkauft wird und wer ein Gebot abgeben darf, sowie eine Methode zur Bewertung dieser Gebote.
  3. Der Code des eingeladenen Käufers wird ausgeführt, um unter anderem ein Gebot und eine URL für ein relevantes Creative zu generieren. Mit dem Gebotsskript können Echtzeitdaten vom Schlüssel/Wert-Dienst des Käufers abgefragt werden, etwa zum verbleibenden Budget für Werbekampagnen.
  4. Der Verkäufercode bewertet jedes Gebot und wählt den Gewinner. Bei dieser Logik werden der Gebotswert und andere Daten verwendet, um den gewünschten Gebotswert zurückzugeben und eine Anzeige abzulehnen, die den Gewinner der kontextbezogenen Anzeige nicht übertreffen kann. Der Verkäufer kann seinen eigenen Schlüssel/Wert-Dienst für Echtzeitdaten verwenden. Bevor eine Auktion beginnt, sucht der Verkäufer nach der am besten geeigneten kontextbezogenen Anzeige für die verfügbare Anzeigenfläche.
  5. Die erfolgreiche Anzeige wird als Konfigurationsobjekt für Fenced-Frames zurückgegeben, wenn das Flag resolveToConfig in der Auktionskonfiguration festgelegt ist. Die Konfiguration wird verwendet, um den Fenced Frame zum Anzeigen-Creative aufzurufen. Dabei wird die URL des Creatives sowohl für den Verkäufer als auch für den Publisher ausgeblendet. Wenn das Flag resolveToConfig auf false gesetzt oder nicht übergeben wird, wird die erfolgreiche Anzeige als undurchsichtige URN zurückgegeben, die zum Rendern der Anzeige in einem iFrame verwendet werden kann. Das Fenced Frame-Konfigurationsobjekt ist ab M114 verfügbar.
  6. Die Auktion wird für den Verkäufer und die gewinnenden Käufer erfasst.

Über einen Meldemechanismus für verlierende Käufer wird derzeit diskutiert.

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

Mit dem Protected Audience API-Dienst für Schlüssel/Wert-Paare können Anzeigentechnologie-Anbieter Echtzeitdaten abfragen, wenn ein Käufer ein Gebot abgibt, und Verkäufer können Anzeigen unter Wahrung des Datenschutzes bewerten. Informationen zum Protected Audience API-Schlüssel/Wert-Dienst und zu anderen Diensten finden Sie unter Protected Audience API-Dienste.

Der Schlüssel/Wert-Dienst wird in der Cloud-Infrastruktur der Anzeigentechnologie-Anbieter 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 oder zu anderen Nebenwirkungen führen. Der Schlüssel/Wert-Dienst unterstützt außerdem benutzerdefinierte Funktionen (User-Defined Functions, UDFs), mit denen Anzeigentechnologie-Anbieter ihre eigene benutzerdefinierte Logik im Schlüssel/Wert-Dienst ausführen können.

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

Der Dienstcode für den Schlüssel/Wert-Paar der Protected Audience API 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 Protected Audience API-Dienst für Schlüssel/Wert-Paare finden Sie in der API-Erklärung und der Erklärung des Vertrauensmodells.

Wie werden Echtzeitdaten in Auktionen eingebunden?

Die Käufer oder Verkäufer in einer Anzeigenauktion benötigen möglicherweise Zugriff auf Echtzeitdaten. Beispielsweise kann es sein, dass Käufer das verbleibende Budget für eine Werbekampagne berechnen möchten oder dass der Verkäufer die Creatives auf Einhaltung der Publisher-Richtlinien prüfen muss.

Um die Datenschutzanforderungen der Protected Audience API zu erfüllen, werden für Anzeigenauktionen erforderliche Echtzeitdaten über den Schlüssel/Wert-Dienst bereitgestellt. Wenn jeder Käufer navigator.joinAdInterestGroup() aufruft, gibt er eine Schlüssel/Wert-Dienst-URL sowie die Schlüssel an, die während einer Auktion an den Dienst abgefragt werden sollen. Wenn der Verkäufer eine Anzeigenauktion durch Aufrufen von navigator.runAdAuction() durchführt, stellt er ebenfalls eine URL für seinen Schlüssel/Wert-Dienst bereit. Der Schlüssel/Wert-Dienst des Verkäufers wird mit der Rendering-URL des Creatives abgefragt.

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

Um sicherzustellen, dass das System genügend Zeit für Tests hat, erwarten wir, dass wir erst nach der Einstellung von Drittanbieter-Cookies die Open-Source-Schlüssel/Wert-Dienste oder vertrauenswürdige Ausführungsumgebungen verwenden werden. Wir informieren Entwickler rechtzeitig, damit sie mit den Tests und der Einführung beginnen können, bevor diese Umstellung in Kraft tritt.

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

Selbst erhobene Daten sind Daten, die der Website des Nutzers gehören. Wenn ein Nutzer beispielsweise auf der Website des Werbetreibenden oder des Publishers seine Lieblingsfarbe angegeben hat, wird diese Farbe als eigene Daten betrachtet.

Bei einer Protected Audience-Auktion kann der Werbetreibende anhand der selbst erhobenen Daten die Mitgliedschaft in eine Interessengruppe der Anzeige bestimmen und Daten als userBiddingSignals an die Interessengruppe übergeben. Die selbst erhobenen Daten des Werbetreibenden stehen den Käufern nur während der Gebotserstellung zur Verfügung und sind für die Verkäufer nicht verfügbar.

Wenn der Werbetreibende beispielsweise die Lieblingsfarbe des Nutzers kennt, kann der Wert in der Interessengruppenkonfiguration 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 auch seine selbst erhobenen Daten übergeben, indem er beim Starten der Auktion die Signale in der Auktionskonfiguration festlegt, und kann steuern, wer diese Daten erhält. Wenn ein Publisher die selbst erhobenen Daten als auctionSignals übergibt, stehen sie sowohl Käufern als auch Verkäufern zur Verfügung. Wenn die Daten als sellerSignals übergeben werden, stehen sie nur dem Verkäufer zur Verfügung. Wenn sie als perBuyerSignals übergeben werden, stehen sie nur für die angegebenen Käufer zur Verfügung. Der Publisher kann auch Erstanbieterdaten an Komponentenauktionen übergeben. Publisher und Auktionsteilnehmer sollten sich vorher darauf einigen, welche selbst erhobenen Daten freigegeben werden müssen und wie die Daten formatiert werden müssen.

Im folgenden Beispiel wird beschrieben, wie die selbst erhobenen Daten vom Publisher an verschiedene Auktionsteilnehmer übergeben werden können:

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

Eine ausführlichere Übersicht über die Protected Audience API finden Sie im Entwicklerleitfaden für die Protected Audience API.

Entwickler

Wenn Sie bereit sind, mit der Protected Audience API zu arbeiten, lesen Sie den Artikel Testen und teilnehmen.

Wir haben einen API-Entwicklerleitfaden verfasst und eine Protected Audience API-Demo erstellt, die eine Schritt-für-Schritt-Anleitung für die grundlegende Bereitstellung der Protected Audience API enthält. Im Demovideo zur Protected Audience API wird die Funktionsweise des Democodes und die Verwendung der Chrome-Entwicklertools für das Debugging der Protected Audience API erläutert.

Reagieren und Feedback geben