Protected Audience API – Übersicht

On-Device-Auktionen für Anzeigen zur Auslieferung 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 Konzepte, geht aber nicht auf viele technische Details ein.

• Wenn Sie im Werbe- oder AdTech-Bereich tätig sind, erhalten Sie einen Überblick über Funktionsweise von Protected Audience.
• Wenn Sie Entwickler oder Softwareentwickler sind, Weitere Informationen finden Sie im Entwicklerleitfaden zur Protected Audience API. detaillierte technische Details zur API. Lesen Sie die aktuellen Status von ausstehenden Protected Audience-Funktionen.

Im Glossar finden Sie die Begriffe, die in folgenden Bereichen verwendet werden: Dokumentation zu Protected Audience. Am Ende dieses Artikels erfahren Sie, wie Sie angeben und Feedback geben.

Was ist die Protected Audience API?

Die Protected Audience API ist eine Privacy Sandbox. um Remarketing und benutzerdefinierte Zielgruppen zu unterstützen. Drittanbieter können das Surfverhalten von Nutzern nicht websiteübergreifend verfolgen.

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

Die Protected Audience API ist der erste Test, der in Chromium im Rahmen der TURTLEDOVE-Angebotsfamilie. Die der Unterschied zwischen Protected Audience und TURTLEDOVE bezieht sich in erster Linie auf die Trennung die Rolle des Käufers und Verkäufers auf dem Gerät. In den folgenden Abschnitten wird erläutert, wie die Protected Audience API funktioniert.

Protected Audience API in einer Minute

Einen ausführlichen Überblick über die Protected Audience API finden Sie in den Entwicklerleitfaden für die Protected Audience API

</ph> <ph type="x-smartling-placeholder"></ph> :

Die Protected Audience API nutzt Interessengruppen, damit Websites Anzeigen schalten, die für ihre Nutzer relevant sind.

Wenn ein Nutzer beispielsweise eine Website besucht, auf der für seine Produkte geworben werden soll, einen Inhaber einer Interessengruppe, z. B. Die Demand-Side-Plattform (DSP) kann den Browser des Nutzers auffordern, die 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.example.
• Konfigurationsinformationen der Interessengruppe, auf die der Browser zugreifen kann Gebotscode, Anzeigencode und Echtzeitdaten, wenn der Inhaber der Gruppe ein Gebot in einer Anzeigenauktion abgeben.

Wenn der Nutzer später eine Website mit verfügbarer Werbefläche besucht, (ein Sell-Side-Anbieter (SSP) oder die Website, können mithilfe von Protected Audience eine Anzeigenauktion durchführen, um die am besten geeigneten Anzeigen auszuwählen. die der Nutzer sieht. Der Verkäufer ruft die navigator.runAdAuction() , die eine Liste der Interessengruppeninhaber bereitstellt, die zur Gebotsabgabe eingeladen wurden.

Gebote können nur von Interessengruppen abgegeben werden, in denen der Browser Mitglied ist und deren Inhaber zur Gebotsabgabe eingeladen wurden.

Der Gebotscode wird von einer URL abgerufen, die in der Konfiguration. Dieser Code liefert Daten über die Interessengruppe und Informationen vom Verkäufer sowie Kontextdaten zum und im Browser angezeigt.

Jede Interessengruppe, für die ein Gebot abgegeben wird, wird als Käufer bezeichnet.

Wenn der Browser die Funktion zum Ausführen der Anzeigenauktion aufruft, generiert ein Gebot mithilfe der Echtzeitdaten des Protected Audience-Schlüssel/Wert-Dienst: Der Verkäufer erhält diese Gebote sowie verkäufereigene Echtzeitdaten und Bewertungen, Gebot Das Gebot mit der höchsten Punktzahl gewinnt die Auktion.

Die erfolgreiche Anzeige wird in einem Fened Frame Die URL des Anzeigen-Creatives wird im Gebot angegeben und der Ursprung muss mit einer URL im die in der Konfiguration der Interessengruppe bereitgestellte Liste enthält.

Der Verkäufer kann das Auktionsergebnis melden (reportResult()) und der Käufer kann ihre Siege melden (reportWin()).

Weitere Informationen zu Protected Audience-Auktionsdatenberichten

Wozu wird die Protected Audience API benötigt?

Wenn Sie die Interessen der Nutzer kennen, können relevantere Anzeigen geschaltet werden, als nur die Auswahl Anzeigen basierend auf dem Website-Content (Kontext-Targeting) oder anhand von Informationen von einem Nutzer für die Website bereitgestellt wird, auf der die Anzeige erscheint (Ausrichtung auf selbst erhobene Daten).

Früher haben Werbeplattformen durch Tracking ihrer auf verschiedenen Websites. Browser müssen Anzeigenplattformen aktivieren, um eine Auswahl treffen zu können. relevanten Anzeigen, sodass Content-Publisher Werbeeinnahmen erzielen können, ohne Verfolgung.

Ziel der Protected Audience API ist es, die Webplattform näher an einen Zustand zu bringen, in dem die nicht auf den Werbetreibenden oder die Anzeigentechnologie-Plattformen, über die Interessen der Person.

Wie kann ich die Protected Audience API ausprobieren?

• Im Entwicklerleitfaden zur Protected Audience API werden folgende Informationen beschrieben: wie die API verwendet und lokal getestet wird.

• protected-audience-demo.web.app bietet eine Schritt-für-Schritt-Anleitung für die grundlegende Bereitstellung von Protected Audience für Werbetreibende und Publisher Websites. Im Demovideo zu Protected Audience wird die Funktionsweise dieses Codes erläutert und eine Vorschau angezeigt. wie Sie Chrome-Entwicklertools zur Fehlerbehebung nutzen können.

Welche Browserkonfiguration ist verfügbar?

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

Für Chrome ist geplant, dass Nutzer die Liste der Interessengruppen aufrufen und verwalten können die sie auf verschiedenen Websites hinzugefügt wurden. Genau wie beim Datenschutz Sandbox-Technologien, die Nutzereinstellungen können sich mit dem Feedback der Nutzer ändern, Regulierungsbehörden usw.

Wir aktualisieren die verfügbaren Einstellungen in Chrome, während die Protected Audience API weiterentwickelt wird. basierend auf Tests und Feedback. Zukünftig werden wir detailliertere Einstellungen zur Verwaltung der Protected Audience API und zugehöriger Daten.

API-Aufrufer können nicht auf die Gruppenmitgliedschaft zugreifen, wenn Nutzer im Inkognitomodus surfen. und die Mitgliedschaft 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 blockieren. entweder als Website-Inhaber oder als einzelner Nutzer.

Wichtige Konzepte

Suchen Sie weitere Informationen zur Protected Audience-Terminologie? Weitere Informationen finden Sie im Glossar zur Privacy Sandbox

Was ist eine Interessengruppe?

Eine Protected Audience API-Interessengruppe steht für eine Gruppe von Personen mit gemeinsamen Interessen. der einer Remarketing-Liste entspricht.

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

Der Inhaber bittet den Browser des Nutzers, die Mitgliedschaft seiner Interessengruppe hinzuzufügen, indem er die JavaScript-Funktion navigator.joinAdInterestGroup() aufrufen und dabei Folgendes angeben: wie Daten zu Anzeigen, die für die Interessengruppe relevant sind, und eine URL für das bei der Gebotsabgabe verwendete JavaScript. Daten zu Interessengruppen (etwa die Anzeigen) aktualisiert und eine Interessengruppe kann bis zu 30 Tage lang aktiviert werden.

Typen von Interessengruppen

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

In Chrome sind bis zu 1.000 Interessengruppen pro Inhaber und bis zu 1.000 Interessengruppen möglich Verantwortlichen. Diese Grenzwerte sind als Schutzmaßnahmen gedacht, die im normalen Betrieb nicht erreicht werden sollen.

Was ist ein Käufer?

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

Beispiel:

• Werbetreibender: Agiert selbst.
• Demand-Side-Plattform (DSP): Handeln für Werbetreibende
• Inhaber der Interessengruppe: arbeitet für mehrere Werbetreibende.

Käufer haben drei Aufgaben:

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

Diese Jobs werden programmatisch in Form von Code ausgeführt, der vom Käufer bereitgestellt und ausgeführt wird. Protected Audience API-Anzeigenauktion.

Wenn ein Käufer den Browser eines Nutzers auffordert, den Gruppen, bei denen er Mitglied ist, eine Interessengruppe hinzuzufügen, indem er die Methode JavaScript-Funktion navigator.joinAdInterestGroup()), stellt der Käufer dem Browser Folgendes bereit:

• Eine URL für den Gebotscode, die verwendet wird, wenn der Verkäufer eine Anzeigenauktion durchführt.
• und möglicherweise URLs für Anzeigen-Creatives für die Interessengruppe. (Anzeigen-URLs können später mit einem Update.)
• 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 zur Meldung des Auktionsergebnisses enthalten.

Wer führt eine Anzeigenauktion durch?

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

Beispiel:

• Content-Publisher: Das Hosten von Anzeigeninhalten auf seiner Website ist selbstständig.
• Supply-Side-Plattform (SSP): Zusammenarbeit mit dem Publisher und Bereitstellung anderer Dienste
• Drittanbieter-Skript: Handeln für einen Publisher, um die Teilnahme an Anzeigenauktionen zu ermöglichen

Mit der Protected Audience API hat ein Verkäufer für Werbeflächen drei Jobs:

• Publisher-Regeln durchsetzen, indem Sie festlegen, welche Käufer und Gebote aktiv sind
• Auktionslogik ausführen: JavaScript-Ausführung in worklets zum Berechnen eines Wunschwert für jedes Gebot.
• Melden Sie das Auktionsergebnis.

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

Wie funktioniert eine Anzeigenauktion der Protected Audience API?

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

</ph> <ph type="x-smartling-placeholder"></ph>

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

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

Der Verkäufer stellt dem Browser Code zur Verfügung, um Gebote zu bewerten. Dieser enthält den Wert jedes Gebots, den Anzeigen-Creative-URL und andere vom Käufer zurückgegebene Daten ein. Während der Auktion von Käufern erhalten und der Gebotswert des Verkäufers Daten von der Schlüssel/Wert-Dienste. Sobald Sie eine Anzeige ausgewählt und angezeigt werden (in einem abgegrenzten Frame), Datenschutz) 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. Mit dem Code des Verkäufers wird eine Auktion gestartet. Der Verkäufer gibt an, welche Werbefläche und wer ein Gebot abgeben kann, sowie eine Methode zur Bewertung dieser Gebote.
3. Mit dem Code des eingeladenen Käufers wird ein Gebot und die URL für eine relevante Anzeige generiert. Creative und andere Daten. Das Gebotsskript kann Echtzeitdaten abfragen, etwa das verbleibende Kampagnenbudget, aus dem Schlüssel/Wert-Paar-
4. Über den Code des Verkäufers wird jedes Gebot bewertet und das erfolgreiche Gebot ermittelt. Diese Logik verwendet die Gebotswert und andere Daten, um das gewünschte Gebot zurückzugeben und eine Anzeige abzulehnen, die ist unschlagbar den Gewinner der kontextbezogenen Anzeige. Der Verkäufer kann eine eigene Schlüssel/Wert-Dienst für Echtzeitdaten Vorher 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 Fenced-Frame-Konfigurationsobjekt zurückgegeben, wenn in der Auktionskonfiguration das Flag resolveToConfig festgelegt ist. Die Konfiguration wird verwendet, um über den Fenced Frame zum Creative zu gelangen. Die URL des Creatives wird 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 opaker URN zurückgegeben, mit dem die Anzeige in einem iFrame gerendert werden kann. Das Fenced-Frame-Konfigurationsobjekt ist ab M114 verfügbar.
6. Die Auktion wird dem Verkäufer und den erfolgreichen Käufern gemeldet.

Ein Meldeverfahren für unterlegene Käufer wird derzeit diskutiert.

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

Mit dem Protected Audience API-Schlüssel-/Wert-Dienst können Anzeigentechnologie-Anbieter Echtzeitdaten abfragen, wenn ein Gebot vom Käufer abgegeben wird. Außerdem können Verkäufer unter Wahrung des Datenschutzes die Anzeigenbewertung bewerten. Weitere Informationen zum Schlüssel/Wert-Paar-Dienst der Protected Audience API und zu anderen finden Sie unter Protected Audience API-Dienste.

Der Schlüssel/Wert-Dienst wird in der eigenen Cloud-Infrastruktur der Anzeigentechnologie bereitgestellt und in einer vertrauenswürdigen Ausführungsumgebung ausgeführt. Eine Anfrage an einen Schlüssel/Wert-Dienst darf 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-Anbieter innerhalb des Schlüssel/Wert-Diensts ihre eigene benutzerdefinierte Logik ausführen können.

Käufer oder Verkäufer stellen eine Liste von „Schlüsseln“ zur Verfügung. , um die von einem Protected Audience API-Schlüssel-/Wert-Dienst benötigten Daten anzugeben. 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 Schlüssel/Wert-Dienst der Protected Audience API finden Sie auf der Erklärende API und in der Erklärung zu Vertrauensmodellen.

Wie werden Echtzeitdaten bei Auktionen berücksichtigt?

Käufer oder Verkäufer in einer Anzeigenauktion benötigen möglicherweise Zugriff auf Echtzeitdaten. Daten. Beispielsweise können Käufer das verbleibende Budget in einer Kampagne berechnen Verkäufer möglicherweise aufgefordert, ihre Creatives auf Einhaltung der Richtlinien des Publishers zu prüfen.

Um die Datenschutzanforderungen der Protected Audience API zu erfüllen, werden vom Schlüssel/Wert-Paar-Dienst Echtzeitdaten bereitgestellt, die während einer Anzeigenauktion erforderlich sind. Wenn jeder Käufer navigator.joinAdInterestGroup() aufruft, gibt er eine Dienst-URL für Schlüssel/Wert-Paare sowie die Schlüssel an, die während einer Auktion an den Dienst abgefragt werden sollen. Gleichermaßen stellt der Verkäufer eine URL für seinen Schlüssel/Wert-Dienst bereit, wenn er navigator.runAdAuction() aufruft und eine Anzeigenauktion durchführt. 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 (Bring Your Own Server) verwendet. Langfristig müssen Anzeigentechnologie-Anbieter zum Abrufen von Echtzeitdaten die Open-Source-Schlüssel-/Wert-Dienste der Protected Audience API verwenden, die in vertrauenswürdigen Ausführungsumgebungen ausgeführt werden.

Um sicherzustellen, dass das System über genügend Zeit für Tests verfügt, gehen wir davon aus, dass die Nutzung der Open-Source-Schlüssel/Wert-Dienste oder vertrauenswürdiger Ausführungsumgebungen erst irgendwann nach der Einstellung von Drittanbieter-Cookies erforderlich ist. Vor der Umstellung werden wir die Entwickler rechtzeitig darüber informieren, dass sie mit den Tests und der Einführung beginnen können.

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

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

Bei einer Protected Audience-Auktion kann der Werbetreibende anhand seiner selbst erhobenen Daten die Mitgliedschaft in der Interessengruppe der Anzeige bestimmen und Daten auch als userBiddingSignals an die Interessengruppe übergeben. Die selbst erhobenen Daten des Werbetreibenden sind nur für die Käufer bei der Gebotserstellung verfügbar, nicht für Verkäufer.

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 beim Starten der Auktion die Signale in der Auktionskonfiguration festlegt, und er kann steuern, wer diese 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 und als perBuyerSignals nur für die angegebenen Käufer verfügbar. Der Publisher kann auch Erstanbieterdaten an Komponentenauktionen übergeben. Publisher und Auktionsteilnehmer sollten sich vorher darauf einigen, welche selbst erhobenen Daten freigegeben und wie sie formatiert werden müssen.

Im folgenden Beispiel wird beschrieben, wie der Publisher die selbst erhobenen Daten 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 ausführlichen Überblick über die Protected Audience API finden Sie in den Entwicklerleitfaden für die Protected Audience API

Entwickler

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

Wir haben einen API-Entwicklerleitfaden geschrieben und eine Demo der Protected Audience API 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 erläutert. Außerdem erfahren Sie, wie Sie mit den Chrome-Entwicklertools die Protected Audience API-Fehlerbehebung nutzen können.

Interagieren und Feedback geben

• GitHub: Lesen Sie die Erläuterung. Fragen stellen und der Diskussion folgen
• Ankündigungen: In der Protected Audience API-Mailingliste können Sie frühere Ankündigungen ansehen oder ihnen beitreten.
• W3C: Erörtern Sie branchenspezifische Anwendungsfälle im Artikel Verbesserung des Web-Werbegeschäfts. Gruppieren.
• Support für Entwickler: Hier können Sie Fragen zur Implementierung und zu Best Practices stellen oder sich an Diskussionen in den Repository für den Privacy Sandbox-Entwicklersupport.
• Aktuelle Implementierung: Wenn Sie Fragen zur Implementierung von Protected Audience in Chrome haben, melden Sie den Fehler in Chromium.