Protected Audience API

On-Device-Anzeigenauktionen zur Bereitstellung von Remarketing und benutzerdefinierten Zielgruppen ohne websiteübergreifendes Drittanbieter-Tracking.

An wen richtet sich dieser Artikel?

In diesem Artikel werden die Grundlagen der Protected Audience API behandelt und einige zugrunde liegende Konzepte erläutert. Die technischen Details werden dabei aber nicht sehr ausführlich beschrieben.

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 für Remarketing und benutzerdefinierte Zielgruppen. Sie wurde entwickelt, damit Drittanbieter das Surfverhalten von Nutzern nicht websiteübergreifend erfassen 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 das erste Experiment der TURTLEDOVE-Angebote, das in Chromium implementiert wird. Der Unterschied zwischen Protected Audience und TURTLEDOVE besteht hauptsächlich in der Trennung der Rolle des Anzeigenkä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.

Jede Phase des Protected Audience API-Lebenszyklus im Überblick
Lebenszyklus der Protected Audience API: größere Version ansehen

Die Protected Audience API nutzt Interessengruppen, damit Websites Anzeigen präsentieren 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 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 Anzeigen auszuwählen, die dem Nutzer am besten präsentiert werden. Der Verkäufer ruft die Funktion navigator.runAdAuction() auf. Sie enthält eine Liste der Inhaber von Interessengruppen, die zu einem Gebot eingeladen wurden.

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

Der Gebotscode wird von einer URL abgerufen, die in der Konfiguration der Interessengruppe angegeben ist. Dieser Code liefert Daten zur Interessengruppe und Informationen vom Verkäufer sowie kontextbezogene Daten über die 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 der einzelnen Käufer ein Gebot mithilfe von Echtzeitdaten, die von ihrem Protected Audience-Schlüssel/Wert-Dienst bereitgestellt werden. Dann erhält der Verkäufer diese Gebote sowie verkäufereigene Echtzeitdaten und bewertet jedes Gebot. Das Gebot mit der höchsten Punktzahl gewinnt die Auktion.

Die erfolgreiche Anzeige wird in einem eingegrenzten Frame dargestellt. Die URL des Creatives ist im Gebot angegeben und der Ursprung muss mit einer URL 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 (reportWin()) angeben.

Weitere Informationen zu Auktionsberichten für Protected Audience

Wozu dient die Protected Audience API?

Wenn Sie die Nutzerinteressen verstehen, können Sie relevantere Anzeigen schalten, als nur Anzeigen basierend auf dem Websiteinhalt auswählen (Kontext-Targeting) oder Informationen verwenden, die ein Nutzer der Website bereitgestellt hat, auf der die Anzeige erscheint (Ausrichtung auf selbst erhobene Daten).

Traditionell haben Werbeplattformen mehr über die Interessen der Nutzer erfahren, indem sie ihr Verhalten websiteübergreifend verfolgen. 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 näher an einen Status zu versetzen, bei dem der Browser des Nutzers auf seinem Gerät – nicht der Werbetreibende oder die AdTech-Plattformen – Informationen zu den Interessen dieser Person enthält.

Wie kann ich die Protected Audience API testen?

  • Im Entwicklerleitfaden für die Protected Audience API wird beschrieben, wie die API verwendet und lokale Tests durchgeführt werden.

  • 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 Demovideo zu Protected Audience erfahren Sie, wie dieser Code funktioniert und wie Sie die Chrome-Entwicklertools zur Fehlerbehebung verwenden.

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 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, aufrufen und verwalten können. Wie bei den Privacy Sandbox-Technologien ändern sich auch die Nutzereinstellungen unter Berücksichtigung des Feedbacks von Nutzern, Aufsichtsbehörden und anderen Personen.

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

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

Kann ich die Protected Audience API deaktivieren?

Hier erfahren Sie, wie Sie den Zugriff auf die Protected Audience API als Websiteinhaber oder einzelner Nutzer blockieren können.

Wichtige Konzepte

Möchten Sie mehr über die Protected Audience-Terminologie erfahren? Weitere Informationen finden Sie im Glossar der 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 mit unterschiedlichen Anwendungsfällen.

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 bereitgestellt, die für die Interessengruppe relevant sind, und eine URL für JavaScript, das bei der Gebotsabgabe verwendet wird. Daten zu Interessengruppen (z. B. Anzeigen) können aktualisiert werden. Eine Interessengruppe kann bis zu 30 Tage lang aktiviert sein.

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

Owner 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, auch wenn diese Nutzer andere Websites besuchen. Publisher können möglicherweise Gebühren für die Schaltung von Anzeigen für bestimmte Zielgruppensegmente erheben.
AdTech DSP Kategorie von Produkten 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 Artikel dieser Kategorie verkauft werden und die mit dem Anzeigentechnologie-Unternehmen zusammenarbeiten.

Chrome erlaubt bis zu 1.000 Interessengruppen pro Inhaber und bis zu 1.000 Interessengruppeninhaber. Diese Grenzwerte sind als Leitplanken gedacht und sollen im normalen Betrieb nicht erreicht werden.

Was ist ein Käufer?

In der Protected Audience API ist ein Käufer eine Partei, die Inhaber einer Interessengruppe ist und in 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.
  • Melden Sie das Auktionsergebnis.

Diese Jobs werden programmatisch mit 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 bittet, 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, die 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 durch eine Aktualisierung hinzugefügt werden. * Eine Liste der abzufragenden Datenschlüssel und die URL des Schlüssel/Wert-Paar-Dienstes des Käufers, damit der Gebotscode während einer Auktion Echtzeitdaten abrufen kann.

Der Käufercode 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, der Anzeigeninhalte auf seiner Website hostet
  • Supply-Side-Plattform (Supply-Side-Plattform: SSP): Zusammenarbeit mit dem Publisher und Bereitstellung weiterer Dienste
  • Drittanbieter-Skript: Handeln im Namen eines Publishers, um die Teilnahme an Anzeigenauktionen zu ermöglichen.

Mit der Protected Audience API hat ein Verkäufer von Werbeflächen drei Aufgaben:

  • Publisher-Regeln durchsetzen, um anzugeben, welche Käufer und welche Gebote aktiv 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 Protected Audience API-Anzeigenauktion?

Im folgenden Diagramm sind die einzelnen Phasen einer Protected Audience API-Anzeigenauktion dargestellt. Hier finden Sie eine größere Version.

Sechs Phasen einer Protected Audience API-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-Arbeitsplätzen 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 an, welche Fläche zum Verkauf steht, und gibt zusätzliche Kriterien für die Anzeige an. 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 vom Käufer zurückgegebene Daten. Während der Auktion kann der Gebotscode von Käufern und der Gebotscode des Verkäufers Daten von seinen Schlüssel/Wert-Diensten empfangen. Nachdem eine Anzeige ausgewählt und präsentiert wurde (aus Datenschutzgründen in einem Fencing Frame), 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 gibt an, welche Werbefläche verkauft wird, wer ein Gebot abgeben darf, und legt eine Methode für die Bewertung dieser Gebote fest.
  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 das verbleibende Budget der Werbekampagne.
  4. Der Code des Verkäufers bewertet jedes Gebot und wählt den Gewinner aus. Diese Logik verwendet den Gebotswert und andere Daten, um den Wunschwert eines Gebots zurückzugeben und eine Anzeige abzulehnen, die den kontextbezogenen Anzeigengewinner nicht übertreffen kann. Der Verkäufer kann seinen eigenen Schlüssel/Wert-Dienst für Echtzeitdaten verwenden. Vor Beginn einer Auktion ermittelt der Verkäufer die beste kontextbezogene Anzeige für die verfügbare Anzeigenfläche.
  5. Die erfolgreiche Anzeige wird als Fence-Frame-Konfigurationsobjekt zurückgegeben, wenn das Flag resolveToConfig in der Auktionskonfiguration festgelegt ist. Die Konfiguration wird verwendet, um im abgegrenzten Frame zum Anzeigen-Creative zu navigieren. 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 Fence-Frame-Konfigurationsobjekt ist ab M114 verfügbar.
  6. Die Auktion wird dem Verkäufer und den gewinnenden Käufern gemeldet.

Wir werden über ein Verfahren zum Melden von Verlusten von Käufern sprechen.

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 auch benutzerdefinierte Funktionen (User-Defined Functions, UDFs), mit denen Anzeigentechnologie-Nutzer ihre eigene benutzerdefinierte Logik innerhalb des Schlüssel/Wert-Dienstes 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 Schlüssel/Wert-Paare 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 in der Erklärung zum Vertrauensmodell.

Wie werden Echtzeitdaten in Auktionen eingebunden?

Die Käufer oder der Verkäufer in einer Anzeigenauktion benötigen möglicherweise Zugriff auf Echtzeitdaten. Beispielsweise können Käufer das verbleibende Budget in einer Werbekampagne berechnen oder der Verkäufer muss die Anzeigen-Creatives auf Einhaltung der Publisher-Richtlinien überprüfen.

Um die Datenschutzanforderungen der Protected Audience API zu erfüllen, werden die während einer Anzeigenauktion erforderlichen Echtzeitdaten vom Schlüssel/Wert-Dienst bereitgestellt. Wenn jeder Käufer navigator.joinAdInterestGroup() aufruft, gibt der Käufer 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 startet, indem er navigator.runAdAuction() aufruft, 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" verwendet. Langfristig müssen Anzeigentechnologie-Anbieter die Open-Source-Dienste für Schlüssel/Wert-Paare der Protected Audience API verwenden, die in vertrauenswürdigen Ausführungsumgebungen ausgeführt werden, um Echtzeitdaten abzurufen.

Damit genügend Zeit für Tests bleibt, gehen wir davon aus, dass die Open-Source-Dienste für Schlüssel/Wert-Paare oder vertrauenswürdige Ausführungsumgebungen erst nach der Einstellung von Drittanbieter-Cookies erforderlich sind. Wir werden Entwickler rechtzeitig informieren, bevor diese Umstellung erfolgt, damit sie mit dem Testen und der Akzeptanz beginnen können.

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

Selbst erhobene Daten sind Daten, die der Website zu ihren Nutzern gehören. Wenn ein Nutzer beispielsweise seine Lieblingsfarbe auf der Website des Werbetreibenden oder des Publishers angegeben hat, gilt diese Farbe als Erstanbieterdaten.

Bei einer Protected Audience-Auktion kann der Werbetreibende anhand selbst erhobener Daten die Mitgliedschaft in einer Interessengruppe ermitteln und Daten als userBiddingSignals an die Interessengruppe übergeben. Die Erstanbieterdaten des Werbetreibenden stehen Käufern nur während der Gebotsgenerierung zur Verfügung und stehen den Verkäufern nicht zur Verfügung.

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 seine selbst erhobenen Daten auch übergeben, indem er die Signale in der Auktionskonfiguration festlegt, wenn er die Auktion startet. Er kann dann steuern, wer diese Daten erhält. Wenn ein Publisher selbst erhobene 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 den angegebenen Käufern zur Verfügung. Der Publisher kann auch selbst erhobene Daten an Komponentenauktionen übergeben. Publisher und Auktionsteilnehmer sollten sich vorab darauf einigen, welche selbst erhobenen Daten geteilt werden 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 Bereitstellung der Protected Audience API enthält. Im Demovideo zur Protected Audience API wird die Funktionsweise des Democodes erläutert. Außerdem erfahren Sie, wie Sie die Chrome-Entwicklertools für die Fehlerbehebung in der Protected Audience API verwenden.

Reagieren und Feedback geben