Protected Audience: Integrationsleitfaden

Bei Protected Audience (früher FLEDGE) auf Android-Implementierungen ist in der Regel eine Integration zwischen Werbetreibenden-Apps, Publisher-Apps, Verkäufern und Käufern erforderlich. Diese Anleitung richtet sich an Partner, die benutzerdefinierte Zielgruppen verwalten und Auktionen durchführen möchten, einschließlich Werbetechnologie-Netzwerken, die sowohl als Käufer als auch als Verkäufer fungieren. Verschiedene Werbekampagnen können unterschiedliche Ziele haben und nicht alle Protected Audience-Funktionen werden für alle Anwendungsfälle verwendet. In diesem Leitfaden werden die Schritte beschrieben, die für spezielle Fälle erforderlich sind.

Zur Vorbereitung auf die Produktionsbereitstellung von Protected Audience im großen Maßstab können Partner mit dem Testen beginnen, indem sie die Integrationspunkte mit anderen Parteien simulieren. Dieser Leitfaden bietet einen umfassenden Überblick darüber, wie Sie Protected Audience in Ihre Android-Apps einbinden können. Dazu können auch Funktionen gehören, die in der aktuellen Phase der Privacy Sandbox für Android-Entwicklervorschau noch nicht implementiert sind. In diesen Fällen wird eine Zeitachse angegeben.

Der Workflow für die Protected Audience-Integration besteht aus vier Hauptschritten, die von verschiedenen Arten von Ad-Tech-Partnern ausgeführt werden:

1. Der Käufer erstellt benutzerdefinierte Zielgruppen.
2. Beim Ablauf der Anzeigenauswahl wird eine Gewinneranzeige ausgewählt.
   1. Die App des Verkäufers initiiert die Anzeigenauswahl.
   2. Über Anzeigendienste wird der Filter- und Gebotscode auf der Käuferseite ausgeführt.
   3. Anzeigendienste führen den Entscheidungsfindungscode für die Verkäuferseite aus.
3. Die erfolgreiche Anzeige wird in der App des Verkäufers gerendert.
4. Berichte zu Anzeigenimpressionen werden sowohl dem Käufer als auch dem Verkäufer zur Verfügung gestellt.

Das folgende Diagramm veranschaulicht diese Schritte:

Terminologie

• Werbetreibender: Ein Unternehmen, das Nutzer durch den Kauf von Anzeigeninventar anspricht.
• Publisher: Ein Unternehmen, das Anzeigeninventar verkauft, das neben seinen Inhalten verfügbar ist.
• Käufer: Ein Ad-Tech-Unternehmen, das Werbetreibenden den Kauf von Anzeigeninventar ermöglicht.
• Verkäufer: Ein Anzeigentechnologieunternehmen, das Publisher beim Verkauf von Anzeigeninventar unterstützt.
• Netzwerk: Ein Ad-Tech-Unternehmen, das sowohl als Käufer als auch als Verkäufer fungiert.
• Eigene Verwaltung: Ein Unternehmen, das als Publisher, Verkäufer und Käufer fungiert.
• Integrationspartner: Alle Unternehmen, mit denen Sie zusammenarbeiten müssen, um die Protected Audience API erfolgreich zu integrieren.

Voraussetzungen, Zusammenarbeit mit Integrationspartnern und Einrichtung

In diesem Abschnitt werden einige erste Aktivitäten beschrieben, die Ihnen helfen sollen, die Funktionsweise von Protected Audience zu verstehen, mit der Integration von Protected Audience zu beginnen und sich mit Ihren Integrationspartnern über die Implementierung von Protected Audience auszutauschen. Diese Aktivitäten können parallel stattfinden.

Protected Audience kennenlernen

Der erste Schritt besteht darin, sich mit den Protected Audience APIs und ‑Diensten vertraut zu machen.

1. Lesen Sie zuerst den Designvorschlag, um sich mit der Protected Audience API und ihren Funktionen vertraut zu machen.
2. Im Entwicklerleitfaden erfahren Sie, wie Sie den Code und die API-Aufrufe einbinden, die für Ihre Anwendungsfälle erforderlich sind, sowie die Dienste, die für die Integration mit Protected Audience benötigt werden.
3. Feedback zum Design und zur Implementierung von Protected Audience-APIs, -Diensten und -Dokumentation geben.
4. Melden Sie sich an, um Updates zu erhalten und über die neuesten Privacy Sandbox-Funktionen auf dem Laufenden zu bleiben.

Beispiel-Apps einrichten und testen

Nachdem Sie sich mit den Grundlagen von Protected Audience vertraut gemacht haben, sollten Sie die Beispiel-Apps einrichten und testen.

1. Wenn Sie mit der Integration beginnen möchten, richten Sie Ihre Entwicklungsumgebung mit der aktuellen Privacy Sandbox-Entwicklervorschau ein.
2. Richten Sie die erforderlichen Serverendpunkte ein. Verwenden Sie die Beispiel-Mocks mit Ihrer bevorzugten API-Testlösung, um diesen Prozess zu starten.
3. Forken Sie den Code in unserer Beispiel-App und führen Sie ihn aus, um sich mit der Verwaltung benutzerdefinierter Zielgruppen, dem Workflow für die Anzeigenauswahl und der Berichterstellung zu Impressionen vertraut zu machen.

Zusammenarbeit mit Integrationspartnern

Planen Sie Gespräche mit Ihren Integrationspartnern, um Tests und die Einführung von Protected Audience unter Android zu besprechen, einschließlich der Art der Signale, die zwischen den Parteien weitergegeben werden. Für Käufer sollten die Gespräche Strategien zum Erstellen und Beitreten von benutzerdefinierten Zielgruppen umfassen, einschließlich der Definition von Zielgruppen. Arbeiten Sie mit Ihren Integrationspartnern zusammen, um Zeitpläne für die Integration festzulegen, von den ersten Tests bis zur Einführung, und um festzulegen, für welche Bereiche die einzelnen Parteien im Design verantwortlich sind.

Beta-Einrichtung (im 4. Quartal verfügbar)

Registrieren Sie Ihre Organisation für die Privacy Sandbox für Android. Die Registrierung ist erforderlich, damit Anzeigentechnologie-Entwickler die Richtlinien der Privacy Sandbox einhalten. Außerdem können sie so ihre Identität über mehrere SDKs und Domains hinweg definieren.

Hinweise zur Architektur

Mit Protected Audience können sowohl Käufer als auch Verkäufer Anzeigenauktionen auf dem Gerät ausführen. Sie und Ihre Integrationspartner sollten bei Ihren Designs mehrere wichtige Aspekte berücksichtigen:

Zielgruppen und Remarketing-Anzeigen werden auf dem Gerät gespeichert.

Im Gegensatz zur heutigen Speicherung von Anzeigen auf Servern werden Zielgruppeninformationen und Remarketing-Anzeigen auf dem Gerät gespeichert. Kontextbezogene Anzeigen, für deren Targeting keine Daten auf dem Gerät erforderlich sind, werden weiterhin auf Servern gehostet. Werbetechnologieplattformen müssen erweitert werden, um die Anzeigenanfrage zu berücksichtigen, die auf Server und Geräte verteilt ist.

Gebots- und Auktionsprozesse finden auf dem Gerät statt.

Neben der Durchführung von Auktionen auf Servern haben Ad-Tech-Plattformen jetzt die Möglichkeit, die auf dem Gerät gespeicherte Anzeigennachfrage zu bewerten und zu ranken.

Ein gängiger Ansatz ist, dass AdTech-Unternehmen Auktionen für kontextbezogene Anzeigen wie bisher durchführen. Nach Abschluss der Auktion kann ein Verkäufer eine Auktion für das Gerät durchführen, um die auf dem Gerät gespeicherte Remarketing-Nachfrage zu bewerten. Da diese Prozesse jetzt auf dem Gerät ausgeführt werden, ist es wichtig, die bestehenden Einschränkungen zu beachten, um zu prüfen, ob die Auktion in verschiedenen Remarketing-Anwendungsfällen wie von den verschiedenen Integrationspartnern vorgesehen abläuft.

Datenstrategie

Ad-Tech-Plattformen sollten die Datentypen berücksichtigen, die in Auktionen verwendet werden. Heute werden diese Informationen aus verschiedenen Quellen gesammelt und dann auf einem Server zentralisiert. Für Protected Audience-Auktionen gibt es verschiedene Möglichkeiten, diese Daten zu übergeben. Beispiel: Echtzeitsignale wie das verbleibende Budget stammen als vertrauenswürdige Signale von einem Key-Value-Dienst, während Kontextsignale wie die Tageszeit von Verkäufern gesendet werden, wenn sie eine Auktion durchführen. Diese Signale werden in den entsprechenden Abschnitten dieser Anleitung genauer erläutert.

Lösung entwickeln

Für die Durchführung einer Auktion mit Protected Audience sind mehrere wichtige Phasen erforderlich. Käufer müssen die Zielgruppe erstellen, Gebotsdaten bereitstellen, Anzeigen auf Zielgruppen ausrichten und Gebote einrichten. Der Verkäufer muss die Auktion konfigurieren und auslösen, die infrage kommenden Anzeigen bewerten und einen Gewinner auswählen. In einigen dieser Phasen ist eine Zusammenarbeit zwischen beiden Parteien erforderlich, damit die Auktion ordnungsgemäß ausgeführt werden kann. In den folgenden Abschnitten wird jede Phase detailliert beschrieben und es wird explizit angegeben, welche Partei für die Implementierung verantwortlich ist.

Käufer: Zielgruppe aufbauen

Käufer verwalten in der Regel benutzerdefinierte Zielgruppen. Da benutzerdefinierte Zielgruppen auf dem Gerät verwaltet werden, ist die API zur Verwaltung benutzerdefinierter Zielgruppen so konzipiert, dass sie auf dem Gerät aufgerufen wird.

Wenn Sie ein eigenes SDK in der App des Werbetreibenden haben, können Sie diesen Code direkt mit joinCustomAudience() implementieren.

Wenn Sie keinen eigenen SDK-Code auf Geräten haben, können Sie eine Partnerschaft mit einem bestehenden Integrationspartner in Betracht ziehen, der auch ein SDK-Anbieter ist. Identifizieren Sie diesen Partner und arbeiten Sie mit ihm zusammen, um einen Vertrag und einen Ablauf für die Definition und Verwaltung benutzerdefinierter Zielgruppen zu erstellen. In diesem Leitfaden wird der Begriff „Käufer“ unabhängig vom verwendeten Ansatz verwendet. Beispiele für Ansätze:

• Lassen Sie den Werbetreibenden die Zielgruppe definieren. Das SDK eines Integrationspartners auf dem Gerät kann App-Ereignisse an den Käufer senden. Wenn vordefinierte Kriterien erfüllt sind, sendet der Käufer eine Nachricht an das SDK, um im Namen des Käufers der benutzerdefinierten Zielgruppe auf dem Client beizutreten.
• Das SDK kann die Zielgruppe direkt besitzen. Werbetreibende arbeiten mit einem SDK-Anbieter zusammen, um die Zielgruppe zu definieren. Das SDK überwacht App-Ereignisse und fügt die Zielgruppe zum richtigen Zeitpunkt hinzu. Außerdem wird der Käufer benachrichtigt, dass ein Nutzer der Zielgruppe hinzugefügt wurde.

Prototyp einer Remarketing-Kampagne: Benutzerdefinierte Zielgruppe erstellen

Eine benutzerdefinierte Zielgruppe ist eine Gruppe von Nutzern mit ähnlichen Interessen, denen personalisierte Anzeigen präsentiert werden können. Käufer können Werbetreibenden helfen, benutzerdefinierte Zielgruppen in ihren Apps basierend auf Nutzeraktivitäten zu erstellen.

Bei Protected Audience wird ein Container für die benutzerdefinierte Zielgruppe erstellt, der einer bestimmten benutzerdefinierten Nutzerinteraktion entspricht, die vom Werbetreibenden definiert wird. Dazu gehören eine Sammlung von infrage kommenden Anzeigen, die dieser Zielgruppe präsentiert werden können, sowie eine Sammlung von benutzerdefinierter Gebotslogik und Daten, die während einer Auktion zum Filtern und Festlegen des Preises der Anzeigen verwendet werden können.

Einrichten und Prototyp erstellen

• Verwenden Sie die API für benutzerdefinierte Zielgruppen, um eine Zielgruppe auf dem Gerät zu erstellen und zu speichern, die später in einer Auktion verwendet werden kann.
• Weitere Informationen zur Implementierung und API-Nutzung finden Sie im Entwicklerleitfaden.

Designaspekte

Käufer können eine Vielzahl von Anwendungsfällen unterstützen, indem sie benutzerdefinierte Zielgruppen konfigurieren. Dazu gehört, die Gebotslogik für den Anzeigentyp oder die Kampagne zu definieren, auf die diese Zielgruppe ausgerichtet ist, die Liste der infrage kommenden Anzeigen festzulegen und ähnliche Überlegungen anzustellen. Dieser Abschnitt enthält Designüberlegungen zum Einrichten und Verwenden einiger wichtiger Felder in einer benutzerdefinierten Zielgruppe.

URL für Gebotslogik

Da Auktionen auf dem Gerät ausgeführt werden, müssen Käufer einen Endpunkt bereitstellen, der die Gebotslogik als JavaScript zurückgeben kann. Die erforderlichen Methodensignaturen sind in unserem Entwicklerleitfaden beschrieben. Die Gebotslogik hat während der Auktion Zugriff auf bestimmte Signale zum Nutzer, wie in den nächsten Abschnitten beschrieben. Die Gebotslogik und die Einrichtung von Nutzersignalen werden weiter unten in diesem Artikel erläutert.

Nutzersignale für die Gebotseinstellung

Die Käufer können UserBiddingSignals verwenden, um Informationen, die der Werbetreibende oder der Käufer selbst über den Nutzer hat, in zukünftige Auktionen auf dem Gerät einzubinden. Dazu gehören unter anderem folgende Informationen:

• Andere Zielgruppen, denen der Nutzer hinzugefügt wurde.
• Erstanbieter-Insights, die der Werbetreibende über den Nutzer hat.

Da diese Signale während der Auktion verfügbar sind, können Käufer benutzerdefinierte Gebotsvorgänge ausführen, darunter:

• Gebote basierend auf Gebotssignalen erhöhen oder senken.
• Bestimmte Anzeigen aus der Auktion herausfiltern.

Vertrauenswürdige Gebotsdaten

Im Rahmen der Protected Audience-Implementierung können Käufer während der Auktion über einen Schlüssel/Wert-Dienst auf Echtzeitinformationen zugreifen. Als vorübergehende Lösung können Käufer und Verkäufer diese Gebotssignale von einem beliebigen Dienst abrufen, auch von einem, den sie selbst betreiben. Das häufigste Beispiel ist das Abrufen des Restbudgets für Anzeigen. Während der Entwicklung ist es möglich, diesen Dienst zu simulieren. Sie können dann gegen diesen simulierten Endpunkt entwickeln. Eine Anleitung zur Einrichtung finden Sie im Verzeichnis FledgeServerSpec in unserem Beispiel-App-Repository auf GitHub.

Das Feld TrustedBiddingData besteht aus einer URL und einer Reihe von Schlüsseln. Hier sind einige Überlegungen zur Gestaltung der Schlüsselstruktur:

• Eine Möglichkeit besteht darin, einen Schlüssel einzufügen, der 1:1 der erstellten Zielgruppe entspricht. Der Schlüssel/Wert-Dienst kann dann alle relevanten Informationen zur Zielgruppe enthalten.
• Budget und Anzeigenstatus sind wichtige Aspekte, die in Echtzeit berücksichtigt werden müssen.
• Maximaler Gebotsbetrag oder andere Signale, die verwendet werden können, um den Preis einer Anzeige in einer Auktion zu bestimmen. Diese Informationen können in einer AdData-Liste in die Anzeige aufgenommen werden. Wenn sie jedoch in einem Schlüssel/Wert-Dienst gespeichert werden, können sie bei Bedarf aktualisiert werden.

AdData-Liste

Beim Erstellen einer Remarketing-Kampagne berücksichtigen Werbetreibende in der Regel viele verschiedene Arten von Anzeigen, die einem Nutzer in einer Zielgruppe präsentiert werden sollen. So können beispielsweise verschiedene Rabatte beworben werden, die auf den bisherigen Interaktionen eines Nutzers mit der App basieren. Eine benutzerdefinierte Zielgruppe enthält eine AdData-Liste mit infrage kommenden Anzeigen.

Die Menge der Informationen, die für jede Anzeige angegeben werden, liegt im Ermessen der Käufer. Beachten Sie Folgendes:

• Die Liste AdData kann auf zwei Arten aktualisiert werden:
  • Wenn die App eine sichtbare Aktivität im Vordergrund hat, kann sie die Liste initiieren, wenn sie einen Nutzer einer benutzerdefinierten Zielgruppe hinzufügt.
  • Bei einer täglichen Aktualisierung wird der Abruf im Hintergrund initiiert. Das Gerät sendet eine Anfrage an die daily_update_url, die im joinCustomAudience-Aufruf enthalten ist, und erwartet eine Antwort mit einer aktualisierten AdData-Liste.
• Zusätzliche Informationen zu Anzeigen können zum Zeitpunkt der Auktion angefordert werden. Vor der Auktion sendet das Gerät eine Anfrage an den Schlüssel/Wert-Dienst des Käufers, der im Feld trustedBiddingData von joinCustomAudience angegeben wurde. Der Schlüssel/Wert-Dienst ist ein neuer Dienst, der Teil der Protected Audience-Implementierung von Käufern ist. Weitere Informationen zu diesem Dienst finden Sie weiter unten in diesem Dokument.
• Wenn Sie eine Creative-ID für Ihre Anzeige angeben, können Sie bestimmte Aktionen für bestimmte Creatives ausführen. Werbetreibende können beispielsweise bestimmte Creatives pausieren. Sie möchten dann die entsprechenden Creative-IDs aus dem Echtzeit-Schlüssel/Wert-Dienst abrufen und mit Anzeigen in der Liste AdData abgleichen.

AdData sollte einen render_url enthalten. Die Render-URL der erfolgreichen Remarketing-Anzeige wird verwendet, um die Anzeige zu rendern. Hier einige Punkte, die Sie beachten sollten:

• Die Render-URL hat einen k-Anonymitätsschwellenwert. Vermeiden Sie daher die Einbeziehung von eingeschränkten Parametern. Weitere Informationen zu diesem k-Anonymitätsschwellenwert werden zu einem späteren Zeitpunkt veröffentlicht.
• Diese URL sollte alle Informationen enthalten, die zum Rendern der Anzeige erforderlich sind. Wenn Sie beispielsweise bestimmte Produkte präsentieren möchten, betten Sie Produkt-IDs als Parameter in die URL ein.

Beim Prototyping ist nur das Feld renderUri erforderlich, das auf die Rendering-Assets der Anzeige verweist. Das Metadatenfeld in AdData kann beim Erstellen Ihrer Lösung ignoriert werden. Wenn Sie Ihre Lösung in Richtung Produktion weiterentwickeln, sollten Sie überlegen, welche Metadaten für Sie relevant sind, da sie bei der Gebotsgenerierung verwendet werden können, um Ihren Gebotspreis anzupassen.

Aktivierungs- und Ablaufzeit

Mit den Feldern für Aktivierungs- und Ablaufzeit können Sie Anwendungsfälle unterstützen, in denen eine benutzerdefinierte Zielgruppe nur innerhalb eines vordefinierten Zeitraums für Auktionen infrage kommen soll. Beachten Sie, dass es bestimmte Einschränkungen für die Dauer der Verzögerung der Aktivierungszeit und die Differenz zwischen Aktivierungs- und Ablaufzeit gibt. Beispiel-Anwendungsfälle:

• Inaktiver Nutzer (z.B. ein Nutzer, der in den letzten 7 Tagen nicht mit der App des Werbetreibenden interagiert hat)
  • Jedes Mal, wenn der Nutzer die App öffnet, kann der Käufer joinCustomAudience aufrufen und activation_time als Zeitstempel für sieben Tage in der Zukunft konfigurieren.
  • Gebote für die Zielgruppe sind zulässig, wenn seit dem letzten Öffnen der App durch den Nutzer sieben Tage vergangen sind.
• Saisonale Zielgruppe (eine Zielgruppe, die nur in einem bestimmten Zeitraum in der nahen Zukunft gültig ist)
  • Ein Käufer kann im Voraus benutzerdefinierte Zielgruppen definieren, die nur während eines bestimmten Zeitraums in der (nahen) Zukunft für Gebote infrage kommen sollen.
  • Wenn ein Werbetreibender beispielsweise 2022 in den USA eine Kampagne zum Ende des Sommers durchführt, kann der Käufer joinCustomAudience anrufen und activation_time auf Samstag, den 20. August 2022, festlegen. Wenn die Kampagne nur eine Woche lang läuft, kann der Käufer das Ablaufdatum auf den 27. August 2022 festlegen. Danach wird die benutzerdefinierte Zielgruppe bei der Anzeigenauswahl von der Plattform herausgefiltert und schließlich gelöscht.

Käufer und Verkäufer: Anzeigenauswahl

Für die Anzeigenauswahl ist eine Zusammenarbeit zwischen Käufern und Verkäufern erforderlich. Dieser Prozess kann in vier Schritte unterteilt werden:

1. Verkäufer definieren eine Vermittlungsstrategie.
2. Verkäufer konfigurieren die Auktion und initiieren die Anzeigenauswahl.
3. Käufer werden mit der vom Verkäufer definierten Konfiguration zur Teilnahme an der Auktion eingeladen. Die Gebotslogik des Käufers wird ausgeführt, um eine infrage kommende Anzeige und ein Gebot auszuwählen.
4. Die Entscheidungslogik des Verkäufers wird ausgeführt, um die Kandidaten zu bewerten und eine Gewinneranzeige auszuwählen.

Um die Entwicklung zu erleichtern, können Sie Dienstantworten für Käufer und Verkäufer simulieren, einschließlich der Gebots- und Scoring-Logik. So können Sie sich auf die Entwicklung konzentrieren, die für Ihren Anwendungsfall relevant ist. Eine Anleitung zum Einrichten von Mock-Endpunkten finden Sie im Verzeichnis FledgeServerSpec auf GitHub. Eine Anleitung zum Umgehen des Abrufs von Remote-JavaScript finden Sie im Entwicklerleitfaden.

Verkäufer: Vermittlungsstrategie definieren

Protected Audience soll die Vermittlungsabfolge unterstützen. Dieser Bereich befindet sich in der Entwicklung. Weitere Informationen folgen, sobald sie verfügbar sind. Sehen Sie sich vorerst den Designvorschlag für die abfolgebasierte Vermittlung in Protected Audience an.

Verkäufer: Auktion konfigurieren

Verkäufer sind für die Konfiguration der Auktion und die Bereitstellung von Informationen für die Anzeigenauswahl verantwortlich. Verkäufer können wählen, ob sie Informationen für alle oder nur für ausgewählte Parteien verfügbar machen möchten. Dazu können Informationen gehören, die Sie haben oder die Sie im Namen von Käufern angeben.

Einrichten und Prototyp erstellen

• Ein Verkäufer kann eine Auktion konfigurieren und starten, indem er ein AdSelectionConfig-Objekt einrichtet und die AdSelection API verwendet. Lösen Sie die Auktion durch Aufrufen von selectAds() aus.
• Weitere Informationen zur Implementierung und API-Nutzung finden Sie im Entwicklerleitfaden.

Designaspekte

In diesem Abschnitt werden Designüberlegungen zum Einbinden und Verwenden von Schlüsselfeldern in einer Konfiguration für die Anzeigenauswahl beschrieben.

• Die private Ausführungsumgebung umfasst nur Anzeigen für benutzerdefinierte Zielgruppen auf dem Gerät. Wenn Sie also zuerst eine kontextbezogene Anzeigenanfrage senden, können Sie zusätzliche Nachfrage berücksichtigen.

• Bevor Sie den Workflow zur Anzeigenauswahl starten, müssen Sie eine Anzeigenanfrage ausführen, um Informationen von Käufern zu erfassen. Anschließend können Sie diese Informationen verwenden, um die Anzeigenauswahl zu konfigurieren.

• Da viele Käufer benutzerdefinierte Zielgruppen auf dem Gerät erstellt haben könnten, müssen Verkäufer das Feld custom audience buyers (Käufer benutzerdefinierter Zielgruppen) verwenden, um die spezifischen Käufer anzugeben, die in den Prozess einbezogen werden sollen. Es gibt viele Möglichkeiten, diese Liste zu erstellen. Beispiele:

  • Eine statische Liste von Käufern, die der Verkäufer immer in den Prozess einbeziehen möchte.
  • Eine Liste von Käufern, die an der Anzeigenantwort teilnehmen möchten. Diese Option ist nützlich, wenn der Verkäufer mit Anzeigenplattformen zusammenarbeitet und möglicherweise nicht alle Käufer kennt.

• Der Verkäufer kann Informationen auf verschiedene Arten in den Prozess einfügen:

  • Das Feld für Signale zur Anzeigenauswahl ist für alle Käufer und den Verkäufer verfügbar, die an der Auktion in der privaten Laufzeitumgebung teilnehmen. Damit können Sie Informationen zur Anzeigenmöglichkeit angeben, z. B. Anzeigengröße und ‑format.
  • Das Feld Signale pro Käufer wird an einen bestimmten Käufer weitergeleitet, damit er es in seinem Gebotsverfahren verwenden kann. Diese Informationen werden vom Käufer bereitgestellt. Sie als Verkäufer müssen überlegen, wie Sie diese Informationen auf dem Gerät für die Anzeigenauswahl abrufen können.
  • Das Feld Verkäufersignale ist die letzte Möglichkeit für den Verkäufer, Informationen in den Prozess einzugeben. Als Verkäufer verwenden Sie diese Signale, wenn Sie Anzeigen bewerten und filtern, z. B. um eine Markensicherheitsprüfung zu aktivieren.

Käufer: Gebote für eine Anzeigenfläche abgeben

Einrichten und Prototyp erstellen

• Ein Käufer kann seine Gebotslogik der JavaScript-Funktion generateBid() hinzufügen, die über den beim Erstellen eines CustomAudience festgelegten Parametersatz biddingLogicUrl bereitgestellt wird. Sie können einen Mock-Dienst mit der bereitgestellten Spezifikation einrichten oder diesen Endpunkt auf einem echten Server implementieren.
• Weitere Informationen zur Implementierung und API-Nutzung finden Sie im Entwicklerleitfaden.

Designaspekte

• Die Gebotslogik wird auf dem Gerät ausgeführt und einige Signale, die in der Auktion verwendet werden, werden in Echtzeit abgefragt. Eine Liste der Einschränkungen finden Sie hier.
• Bei einigen Anwendungsfällen für Anzeigen ist es wichtig, mit dem Verkäufer zusammenzuarbeiten, um zu überprüfen, ob Sie mehrere Anzeigenkandidaten und ihre Gebote haben, die auf dem Gerät berücksichtigt werden sollen.

Gebotslogik entwerfen

Die Gebotslogik der Käufer muss mit JavaScript implementiert werden und wird auf dem Gerät ausgeführt. Im Entwicklerleitfaden finden Sie Informationen zur erforderlichen Signatur und Details zu den verschiedenen Parametern, die während der Auktion übergeben werden. Ihre Gebotslogik auf dem Gerät hat Zugriff auf zusätzliche Informationen, die als Parameter an Ihre generateBid()-Funktion übergeben werden.

Gebotsdaten bereitstellen

Signale für Echtzeitgebote mit Key-Value-Diensten

Als Käufer können Sie während einer Auktion Echtzeitsignale von einem Key-Value-Dienst abrufen, der Ihnen gehört. Eine erste Implementierung dieses Dienstes finden Sie im öffentlichen Privacy Sandbox-Repository. Sie können aber auch einen eigenen Dienst erstellen. Die URL für diesen Dienst wird als trustedBiddingUrl in einer benutzerdefinierten Zielgruppe angegeben. Die Plattform versucht, die Daten abzurufen und Ihrer generateBid-Funktion mit dem trusted_bidding_signals parameter zur Verfügung zu stellen. Sie müssen Ihre eigene Schlüsselstruktur erstellen.

Kontext- und Nutzersignale

Ihre generateBid-Funktion hat Zugriff auf zusätzliche Nutzersignale, wenn die Auktion auf dem Gerät ausgeführt wird. Diese Signale werden mit den Feldern contextual_signals und per_buyer_signals übergeben. Diese Felder sind alle JSON-Objekte, deren Format von Käufern und Verkäufern definiert werden muss.

Das Feld contextual_signals enthält möglicherweise relevante Informationen zum Nutzer. Das Objekt, das diese Signale enthält, wird von Protected Audience selbst erstellt und an Ihre Gebotslogik übergeben. Dies wird als leeres Objekt übergeben. Wenn Sie der Meinung sind, dass ein kontextbezogenes Signal über den Nutzer für Ihren Anwendungsfall relevant sein könnte, geben Sie Feedback, damit es berücksichtigt werden kann.

Das Feld per_buyer_signals wird für Ihre Gebotslogik zur Verfügung gestellt. Ein Verkäufer legt diese Werte beim Erstellen der Auktionskonfiguration fest. Käufer und Verkäufer müssen zusammenarbeiten, um zu überprüfen, ob diese Daten auf dem Gerät vorhanden sind und an Ihre Gebotslogik übergeben werden. Beispiele für die Verwendung dieses Felds:

• Filtern nach Markensicherheit Der Verkäufer kann den Käufern einige Klassifizierungsinformationen zur App mitteilen, in der eine Anzeige angefordert wird. Der Käufer kann diese Informationen verwenden, um bestimmte Anzeigen herauszufiltern.
• Senden einer Einbettung für ein ML-Modell, das Kontextinformationen berücksichtigt.

Verkäufer: Gewinneranzeige bewerten und auswählen

Einrichten und Prototyp erstellen

• Ein Verkäufer kann seine Scoring-Logik der JavaScript-Funktion scoreAd() hinzufügen, die über den Parameter scoringLogicUrl bereitgestellt wird, der beim Erstellen von AdSelectionConfig festgelegt wird. Sie können einen Mock-Dienst mit der bereitgestellten Spezifikation einrichten oder diesen Endpunkt auf einem echten Server implementieren.
• Weitere Informationen zur Implementierung und API-Nutzung finden Sie im Entwicklerleitfaden.

Bewertungslogik entwerfen

Verkäufer implementieren die Scoring-Logik in JavaScript, die auf dem Gerät ausgeführt wird. Im Entwicklerleitfaden finden Sie Informationen zur erforderlichen Signatur und Details zu den verschiedenen Parametern, die während der Auktion übergeben werden. Außerdem hat Ihre Scoring-Logik auf dem Gerät Zugriff auf zusätzliche Informationen, die als Parameter an Ihre scoreAd-Funktion übergeben werden.

Bewertungsdaten für die Lieferkette bereitstellen

Echtzeit-Bewertungssignale mit Schlüssel/Wert-Diensten

Als Verkäufer können Sie während einer Auktion Echtzeitsignale von einem Key-Value-Dienst abrufen, der Ihnen gehört. Eine erste Implementierung dieses Dienstes finden Sie im öffentlichen Privacy Sandbox-Repository. Die URL für diesen Dienst wird als trustedScoringUri in der Auktionskonfiguration angegeben. Die Plattform versucht, die Daten abzurufen und Ihrer scoreAd-Funktion über den Parameter trusted_scoring_signals zur Verfügung zu stellen. Sie sollten eine eigene Schlüsselstruktur festlegen.

Kontext- und Nutzersignale

Ihre scoreAd-Funktion hat Zugriff auf zusätzliche Nutzersignale, wenn die Auktion auf dem Gerät ausgeführt wird. Diese Signale werden über das Feld contextual_signal an Ihre Scoring-Funktion übergeben. Dieses Feld enthält ein JSON-Objekt, dessen Format von Käufern und Verkäufern definiert wird.

Das Feld contextual_signal enthält Kontextinformationen, die für den Nutzer relevant sein können. Das Objekt, das diese Signale enthält, wird von Protected Audience selbst erstellt und an Ihre Scoring-Logik übergeben. Dies wird als leeres Objekt übergeben. Wenn Sie der Meinung sind, dass ein Signal zum Nutzer für Ihren Anwendungsfall relevant sein könnte, geben Sie Feedback, damit es berücksichtigt werden kann.

Verkäufer: Anzeige rendern

Verkäufer müssen die Gewinneranzeige rendern. Weitere Informationen dazu, wie erfolgreiche Anzeigen gerendert werden, finden Sie im Designvorschlag. Dieser Bereich wird noch gestaltet.

Berichtsergebnisse für Impressionen

Einrichten und Prototyp erstellen

• Käufer und Verkäufer können der reportWin()-JavaScript-Funktion, die über den Parameter biddingLogicUrl bzw. scoringLogicUrl bereitgestellt wird, Berichtslogik hinzufügen. Sie können einen Mock-Dienst mit der bereitgestellten Spezifikation einrichten oder diesen Endpunkt auf einem echten Server implementieren.
• Weitere Informationen zur Implementierung und API-Nutzung finden Sie im Entwicklerleitfaden.

Designaspekte

Käufer und Verkäufer müssen eine reportWin-Funktion in ihrem JavaScript-Code implementieren, der von ihren konfigurierten Endpunkten zurückgegeben wird. Mit dieser Methode können Sie Daten an Ihre Server zurücksenden.

Die Privacy Sandbox bietet auch eine Attribution Reporting API zum Verwalten von Berichten auf Ereignisebene und zusammengefassten Berichten. Weitere Informationen finden Sie im Integrationsleitfaden.

Persönliche Empfehlungen

• Hinweis: Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
• Entwicklerleitfaden zur Protected Audience API für Android
• Targeting auf benutzerdefinierte Zielgruppen mit der Protected Audience API unterstützen
• Frequency Capping für Protected Audience