Protected Audience: Integrationsleitfaden

Bei der Implementierung von Protected Audience (früher FLEDGE) auf Android-Geräten ist in der Regel eine Integration zwischen Werbetreibenden-Apps, Publisher-Apps, Verkäufern und Käufern erforderlich. Dieser Leitfaden richtet sich an Partner, die benutzerdefinierte Zielgruppen verwalten und Auktionen abhalten möchten, einschließlich AdTech-Netzwerken, die sowohl als Käufer als auch als Verkäufer agieren. Unterschiedliche Werbekampagnen können unterschiedliche Ziele haben und nicht alle Funktionen für geschützte Zielgruppen sind für alle Anwendungsfälle geeignet. In diesem Leitfaden werden nach Möglichkeit die Schritte beschrieben, die für die Unterstützung bei speziellen Fällen erforderlich sind.

Zur Vorbereitung auf die groß angelegte Produktionsbereitstellung von Protected Audience können Partner mit dem Testen beginnen, indem sie die Integrationspunkte mit anderen Parteien simulieren. Dieser Leitfaden soll Ihnen bei der Planung der Integration helfen. Er bietet einen umfassenden Überblick darüber, wie Sie Protected Audience in Ihre Android-Apps einbinden. Dazu gehören möglicherweise Funktionen, die in der aktuellen Phase der Privacy Sandbox in der Android-Entwicklervorschau noch nicht implementiert sind. In diesen Fällen erhalten Sie eine Zeitleiste.

Der Workflow für die Protected Audience-Integration besteht aus vier wichtigen Schritten, die von verschiedenen Arten von AdTech-Partnern ausgeführt werden:

1. Der Käufer erstellt benutzerdefinierte Zielgruppen.
2. Im Rahmen der Anzeigenauswahl wird eine Gewinneranzeige ausgewählt.
   1. Die Anzeigenauswahl wird von der App des Verkäufers initiiert.
   2. In Anzeigendiensten wird der Code für die käuferseitige Filterung und Gebotsabgabe ausgeführt.
   3. Anzeigendienste führen Entscheidungscode für die Sell-Side 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 erreicht.
• Publisher: Ein Unternehmen, das Anzeigeninventar verkauft, das neben seinen Inhalten verfügbar ist.
• Buyer: Ein AdTech-Unternehmen, das Werbetreibenden den Kauf von Anzeigeninventar erleichtert.
• Verkäufer: Ein Anbieter von Anzeigentechnologien, der Publishern den Verkauf von Anzeigeninventar erleichtert.
• Netzwerk: Ein Anbieter von Anzeigentechnologien, der sowohl als Käufer als auch als Verkäufer fungiert.
• Eigentümer und Betreiber: Ein Unternehmen, das als Publisher, Verkäufer und Käufer fungiert.
• Integrationspartner: Alle Unternehmen, mit denen Sie zusammenarbeiten müssen, um Protected Audience erfolgreich zu integrieren.

Voraussetzungen, Einbindung des Integrationspartners und Einrichtung

In diesem Abschnitt werden einige erste Aktivitäten beschrieben, mit denen Sie die Funktionsweise von Protected Audience kennenlernen, die ersten Schritte mit der Integration von Protected Audience ausführen und mit Ihren Integrationspartnern die Implementierung von Protected Audience besprechen können. Diese Aktivitäten können parallel erfolgen.

Protected Audience

Im ersten Schritt sollten Sie sich mit den Protected Audience APIs und ‑Diensten vertraut 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 Sie für Ihre Anwendungsfälle benötigen, sowie die Dienste, die für die Einbindung in Protected Audience erforderlich sind.
3. Senden Sie uns Feedback zum Design und zur Implementierung von Protected Audience APIs, Diensten und Dokumentation.
4. Melden Sie sich an, um Updates zu erhalten, damit Sie immer über die neuesten Privacy Sandbox-Funktionen informiert sind.

Beispiel-Apps einrichten und testen

Sobald Sie mit den Grundlagen von Protected Audience vertraut sind, sollten Sie die Beispiel-Apps einrichten und testen.

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

Integrationspartner

Vereinbaren Sie mit Ihren Integrationspartnern Besprechungen, um die Tests und die Einführung von Protected Audience auf Android zu besprechen, einschließlich der Form der Signale, die zwischen den Parteien übergeben werden. Für Käufer sollten Diskussionen Strategien zum Erstellen und Zusammenführen von benutzerdefinierten Zielgruppen umfassen. Dazu kann auch die Definition von Zielgruppen gehören. Legen Sie gemeinsam mit Ihren Integrationspartnern Zeitpläne für die Integration fest, vom ersten Test bis zur Einführung, und welche Bereiche die einzelnen Parteien im Design verantworten.

Betaeinrichtung (im 4. Quartal verfügbar)

Registrieren Sie Ihre Organisation für die Privacy Sandbox für Android. Die Registrierung ist erforderlich, damit Anbieter von Anzeigentechnologien 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 zum vollständigen Speichern von Anzeigen auf Servern werden Zielgruppeninformationen und Remarketing-Anzeigen jetzt auf dem Gerät gespeichert. Kontextbezogene Anzeigen, die für das Targeting nicht auf geräteinternen Daten basieren, werden weiterhin auf Servern gespeichert. Werbetechnologieplattformen müssen erweitert werden, um die Anzeigennachfrage zu berücksichtigen, die auf Server und Geräte verteilt ist.

Gebots- und Auktionsprozesse finden auf dem Gerät statt

Neben Auktionen auf Servern haben Anbieter von Anzeigentechnologien jetzt die Möglichkeit, die auf dem Gerät gespeicherte Anzeigennachfrage zu bewerten und zu kalkulieren.

Ein gängiger Ansatz besteht darin, dass AdTech-Anbieter Auktionen für kontextbezogene Anzeigen durchführen, wie sie es heute tun. Nach Abschluss der Auktion kann ein Verkäufer eine Auktion auf dem Gerät ausführen, um die auf dem Gerät gespeicherte Nachfrage nach Remarketing zu bewerten. Da diese Prozesse jetzt auf dem Gerät ausgeführt werden, ist es wichtig, die vorhandenen Limits zu beachten, damit die Auktion in verschiedenen Remarketing-Anwendungsfällen wie von den verschiedenen Integrationspartnern vorgesehen ausgeführt wird.

Datenstrategie

Anbieter von Anzeigentechnologien sollten die Datentypen berücksichtigen, die in Auktionen verwendet werden. Heutzutage werden diese Informationen aus verschiedenen Quellen erfasst und dann auf einem Server zentralisiert. Bei Protected Audience-Auktionen gibt es mehrere Möglichkeiten, diese Daten anzugeben. Beispiel: Echtzeitsignale wie das verbleibende Budget stammen von einem Schlüssel/Wert-Dienst als vertrauenswürdige Signale, während Kontextsignale wie die Tageszeit von Verkäufern gesendet werden, wenn eine Auktion ausgeführt wird. Diese Signale werden in den entsprechenden Abschnitten dieses Leitfadens ausführlicher erläutert.

Lösung erstellen

Es gibt mehrere wichtige Phasen für die Durchführung einer Auktion mit Protected Audience. Käufer müssen die Zielgruppe erstellen, Gebotsdaten angeben, Anzeigen auf Zielgruppen ausrichten und Gebote einrichten. Der Verkäufer muss die Auktion konfigurieren und auslösen, die Anzeigen bewerten und einen Gewinner auswählen. Für einige dieser Phasen ist die Zusammenarbeit zwischen beiden Parteien erforderlich, damit die Auktion korrekt ausgeführt werden kann. In den folgenden Abschnitten werden die einzelnen Phasen ausführlich beschrieben und es wird ausdrücklich darauf hingewiesen, welche Partei für die Implementierung verantwortlich ist.

Käufer: Zielgruppe zusammenstellen

Käufer verwalten in der Regel benutzerdefinierte Zielgruppen. Da benutzerdefinierte Zielgruppen auf dem Gerät verwaltet werden, ist die API zur Verwaltung benutzerdefinierter Zielgruppen für die Aufrufe auf dem Gerät konzipiert.

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

Wenn Sie keinen eigenen SDK-Code auf Geräten haben, können Sie mit einem bestehenden Integrationspartner zusammenarbeiten, der auch SDK-Anbieter ist. Suchen Sie einen Partner und arbeiten Sie mit ihm zusammen, um einen Vertrag und einen Ablauf für die Definition und Verwaltung von benutzerdefinierten Zielgruppen zu definieren. In diesem Leitfaden wird unabhängig vom Ansatz der Begriff „Käufer“ verwendet. Beispiele für Ansätze:

• Lassen Sie den Werbetreibenden die Zielgruppe definieren. Ein 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 die benutzerdefinierte Zielgruppe im Namen des Käufers mit dem Client zu verknüpfen.
• Das SDK kann der Eigentümer der Zielgruppe sein. Werbetreibende arbeiten mit einem SDK-Anbieter zusammen, um die Zielgruppe zu definieren. Das SDK überwacht App-Ereignisse und fügt den Nutzer zur Zielgruppe hinzu, sobald die entsprechenden Kriterien erfüllt sind. Der Käufer wird benachrichtigt, dass ein Nutzer der Zielgruppe hinzugefügt wurde.

Remarketing-Kampagne als Prototyp erstellen: Benutzerdefinierte Zielgruppe entwerfen

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

Protected Audience erstellt einen Container für die benutzerdefinierte Zielgruppe, der einem bestimmten benutzerdefinierten Nutzer-Engagement zugeordnet ist, das vom Werbetreibenden definiert wurde. Dazu gehören eine Reihe von Anzeigen, die dieser Zielgruppe präsentiert werden können, sowie eine Reihe von benutzerdefinierten Gebotslogiken und Daten, die während einer Auktion zum Filtern und Preisen der Anzeigen verwendet werden können.

Einrichten und Prototyp erstellen

• Verwenden Sie die Custom Audience API, 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 mit benutzerdefinierten Zielgruppen eine Vielzahl von Anwendungsfällen unterstützen. Dazu gehört auch die Definition der Gebotslogik für die Art der Anzeige oder Kampagne, auf die diese Zielgruppe ausgerichtet ist, die Definition der Liste der infrage kommenden Anzeigen und ähnliche Aspekte. In diesem Abschnitt finden Sie Designüberlegungen zum Ausfüllen und Verwenden einiger wichtiger Felder in einer benutzerdefinierten Zielgruppe.

URL der 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. In unserem Entwicklerhandbuch werden die erforderlichen Methodensignaturen beschrieben. Die Gebotslogik hat während der Auktion Zugriff auf bestimmte Signale zum Nutzer, wie in den folgenden Abschnitten beschrieben. Die Gebotslogik und die Einrichtung von Nutzersignalen werden weiter unten in diesem Artikel erläutert.

Signale für die Gebotseinstellung

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 einfließen zu lassen. Dazu gehören unter anderem folgende Informationen:

• Andere Zielgruppen, denen der Nutzer hinzugefügt wurde.
• Informationen, die der Werbetreibende selbst über den Nutzer hat.

Da diese Signale während der Auktion verfügbar sind, können die Käufer während der Auktion folgende Aktionen ausführen:

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

Daten für die vertrauenswürdige Gebotseinstellung

Im Rahmen der Implementierung von Protected Audience können Käufer während der Auktion über einen Schlüssel/Wert-Dienst auf Echtzeitinformationen zugreifen. Als vorübergehenden Mechanismus können Käufer und Verkäufer diese Gebotssignale aus beliebigen Diensten abrufen, auch aus einem von ihnen selbst betriebenen. Das häufigste Beispiel ist die Suche nach dem verbleibenden Budget für Anzeigen. Während der Entwicklung ist es möglich, diesen Dienst zu mocken und anhand dieses Mock-Endpunkts zu 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, die Sie bei der Auswahl der Schlüsselstruktur berücksichtigen sollten:

• Eine einfache Möglichkeit besteht darin, einen Schlüssel anzugeben, der der zu erstellenden Zielgruppe 1:1 zugeordnet ist. Der Schlüssel/Wert-Dienst kann dann alle relevanten Informationen zur Zielgruppe enthalten.
• Budget und Anzeigenstatus sind wichtige Faktoren, die Sie in Echtzeit im Blick behalten sollten.
• Maximalgebot oder andere Signale, die zur Preisgestaltung einer Anzeige in einer Auktion verwendet werden können. Sie können diese Informationen auch zusammen mit der Anzeige in einer AdData-Liste angeben. Wenn Sie sie jedoch in einem Schlüssel/Wert-Dienst speichern, können sie bei Bedarf leichter aktualisiert werden.

AdData-Liste

Beim Erstellen einer Remarketing-Kampagne berücksichtigen Werbetreibende in der Regel viele verschiedene Arten von Anzeigen, die Nutzern in einer Zielgruppe präsentiert werden sollen. So können beispielsweise unterschiedliche Rabatte beworben werden, die auf früheren Interaktionen des Nutzers mit der App basieren. Eine benutzerdefinierte Zielgruppe enthält eine AdData-Liste mit Anzeigen, die als geeignet eingestuft wurden.

Die Anzahl der Informationen, die für jede Anzeige enthalten sein sollen, 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 erstellen, wenn ein Nutzer einer benutzerdefinierten Zielgruppe hinzugefügt wird.
  • Bei einem täglichen Update wird der Abruf im Hintergrund gestartet. 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 während der Auktion angefordert werden. Vor der Auktion sendet das Gerät eine Anfrage an den Schlüssel/Wert-Dienst der Käufer, der im Feld trustedBiddingData von joinCustomAudience angegeben wurde. Der Schlüssel/Wert-Dienst ist ein neuer Dienst, der Teil der Implementierung von Protected Audience durch Käufer 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 diese Creative-IDs aus dem Echtzeit-Schlüssel/Wert-Dienst abrufen und dann mit Anzeigen in der Liste AdData abgleichen.

AdData sollte einen render_url enthalten. Die Render-URL der ausgewählten Remarketing-Anzeige wird zum Rendern der Anzeige verwendet. Folgende Punkte sollten Sie dabei berücksichtigen:

• Die Render-URL hat einen k-Anonymitätsgrenzwert. Vermeiden Sie daher eng gefasste Parameter. Weitere Informationen zu diesem Grenzwert für die k-Anonymität 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, können Sie Produkt-IDs als Parameter in die URL einbetten.

Beim Erstellen des Prototyps ist nur das Feld renderUri erforderlich. Es verweist auf die Rendering-Assets der Anzeige. Das Metadatenfeld in AdData kann beim Erstellen der Lösung ignoriert werden. Wenn Sie Ihre Lösung in die Produktion überführen, sollten Sie überlegen, welche Metadaten für Sie relevant sind, da sie bei der Gebotserstellung verwendet werden können, um den Gebotspreis anzupassen.

Aktivierungszeit 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. Es gibt bestimmte Einschränkungen für die Verzögerung der Aktivierungszeit und für die Zeitspanne zwischen Aktivierung und Ablaufzeit. Beispiele für 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.
  • Die Zielgruppe kann für Gebote verwendet werden, 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 naher Zukunft gültig ist)
  • Käufer können benutzerdefinierte Zielgruppen im Voraus definieren, für die Gebote nur in einem bestimmten Zeitraum in der (nahen) Zukunft abgegeben werden sollen.
  • Wenn ein Werbetreibender beispielsweise 2022 eine Kampagne zum Ende des Sommers in den USA hat, kann sein Käufer joinCustomAudience aufrufen und activation_time auf Samstag, den 20. August 2022 konfigurieren. Wenn die Kampagne nur eine Woche 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

Die Anzeigenauswahl erfordert die Zusammenarbeit zwischen Käufern und Verkäufern. Dieser Vorgang kann in vier Schritte unterteilt werden:

1. Verkäufer legen eine Vermittlungsstrategie fest.
2. Verkäufer konfigurieren die Auktion und initiieren die Anzeigenauswahl.
3. Käufer werden über die vom Verkäufer definierte Konfiguration zur Teilnahme an der Auktion eingeladen. Die Gebotslogik des Käufers wird ausgeführt, um eine Anzeigen- und Gebotsvorlage auszuwählen.
4. Die Entscheidungslogik des Verkäufers wird ausgeführt, um die Kandidaten zu bewerten und eine Gewinneranzeige auszuwählen.

Zur Vereinfachung der Entwicklung können Sie Dienstantworten für Käufer und Verkäufer simulieren, einschließlich Gebots- und Bewertungslogik. So können Sie sich darauf konzentrieren, das zu entwickeln, was für Ihren Anwendungsfall relevant ist. Eine Anleitung zum Einrichten von Mock-Endpunkten findest du im Verzeichnis FledgeServerSpec auf GitHub. Im Entwicklerleitfaden erfährst du, wie du das Abrufen von JavaScript aus der Ferne überschreiben kannst.

Verkäufer: Vermittlungsstrategie definieren

Protected Audience soll die abfolgebasierte Vermittlung unterstützen. Dieser Bereich befindet sich noch in der Entwicklungsphase. Sobald weitere Informationen verfügbar sind, werden wir sie hier veröffentlichen. Weitere Informationen finden Sie im Designvorschlag für die abfolgebasierte Vermittlung in geschützten Zielgruppen.

Verkäufer: Auktion konfigurieren

Verkäufer sind dafür verantwortlich, die Auktion zu konfigurieren und Informationen für die Anzeigenauswahl bereitzustellen. Verkäufer können festlegen, ob Informationen für alle oder nur für ausgewählte Parteien verfügbar sein sollen. Dazu gehören Informationen, die Sie haben, oder Informationen, 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 finden Sie Designüberlegungen zum Ausfüllen und Verwenden wichtiger Felder in einer Konfiguration für die Anzeigenauswahl.

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

• Bevor Sie den Workflow für die Anzeigenauswahl starten, sollten Sie eine Anzeigenanfrage senden, um Informationen von Käufern zu erhalten. Verwenden Sie diese Informationen dann, um die Anzeigenauswahl zu konfigurieren.

• Da viele Käufer auf dem Gerät benutzerdefinierte Zielgruppen erstellt haben könnten, müssen Verkäufer im Feld Käufer für benutzerdefinierte Zielgruppen angeben, welche Käufer 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 der Käufer, 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 an den Prozess weitergeben:

  • Das Feld für Signale zur Anzeigenauswahl ist für alle Käufer und Verkäufer verfügbar, die an der Auktion in der privaten Laufzeit teilnehmen. Geben Sie hier Informationen zur Werbefläche an, z. B. Anzeigengröße und -format.
  • Das Feld Signale pro Käufer wird an einen bestimmten Käufer weitergeleitet, damit es bei seinen Geboten verwendet werden kann. Diese Informationen werden vom Käufer bereitgestellt. Sie als Verkäufer müssen überlegen, wie Sie diese Informationen auf dem Gerät abrufen, um sie bei der Anzeigenauswahl zu verwenden.
  • Das Feld Verkäufersignale ist die letzte Möglichkeit für den Verkäufer, Informationen an das System weiterzugeben. Als Verkäufer verwenden Sie diese Signale, um Anzeigen zu bewerten und zu filtern, z. B. um eine Markensicherheitsüberprüfung zu aktivieren.

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

Einrichten und Prototyp erstellen

• Käufer können die Gebotslogik der generateBid()-JavaScript-Funktion hinzufügen, die aus dem biddingLogicUrl-Parametersatz bereitgestellt wird, wenn sie eine CustomAudience erstellen. Sie können einen Mock-Dienst mit der angegebenen 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 in der Auktion verwendete Signale werden in Echtzeit abgefragt. Weitere Informationen finden Sie in der Liste der Einschränkungen.
• Bei einigen Anwendungsfällen für Anzeigen ist es wichtig, mit dem Verkäufer zusammenzuarbeiten, damit mehrere Anzeigenkandidaten und ihre Gebote auf dem Gerät berücksichtigt werden.

Gebotslogik entwerfen

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

Daten zu Geboten für die Anzeigenbereitstellung

Echtzeitsignale für Gebote mit Schlüssel/Wert-Diensten

Als Käufer können Sie während einer Auktion Echtzeitsignale von einem von Ihnen genutzten Schlüssel/Wert-Dienst abrufen. Eine erste Implementierung dieses Dienstes finden Sie im öffentlichen Privacy Sandbox-Repository. Sie können auch einen eigenen Dienst erstellen. Die URL für diesen Dienst wird in einer benutzerdefinierten Zielgruppe als trustedBiddingUrl angegeben. Die Plattform versucht dann, die Daten abzurufen und über die trusted_bidding_signals parameter für Ihre generateBid-Funktion verfügbar zu machen. Sie müssen Ihre eigene Schlüsselstruktur festlegen.

Kontext- und Nutzersignale

Die Funktion generateBid 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 Informationen, 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 Gebotslogik übergeben. Dieser Wert wird derzeit als leeres Objekt übergeben. Wenn Sie der Meinung sind, dass ein kontextbezogenes Signal über den Nutzer für Ihren Anwendungsfall relevant sein könnte, reichen Sie Feedback ein.

Das Feld per_buyer_signals wird für Ihre Gebotslogik verfügbar gemacht. Diese Werte werden vom Verkäufer beim Erstellen der Auktionskonfiguration festgelegt. Käufer und Verkäufer müssen zusammenarbeiten, damit diese Daten auf dem Gerät vorhanden sind und an Ihre Gebotslogik übergeben werden. Beispiele für die Verwendung dieses Felds:

• Filterung für Markensicherheit Der Verkäufer kann den Käufern einige Klassifizierungsinformationen zur App mitteilen, für die eine Anzeige angefordert wird. Der Käufer kann diese Informationen verwenden, um bestimmte Anzeigen herausfiltern zu lassen.
• Senden eines Embeddings für ein ML-Modell, das Kontextinformationen berücksichtigt.

Verkäufer: Gewinneranzeige bewerten und auswählen

Einrichten und Prototyp erstellen

• Verkäufer können die Bewertungslogik der JavaScript-Funktion scoreAd() hinzufügen, die beim Erstellen der AdSelectionConfig aus dem Parametersatz scoringLogicUrl bereitgestellt wird. Sie können einen Mock-Dienst mit der angegebenen Spezifikation einrichten oder diesen Endpunkt auf einem echten Server implementieren.
• Weitere Informationen zur Implementierung und API-Nutzung finden Sie im Entwicklerleitfaden.

Bewertungslogik für Designs

Verkäufer implementieren die Bewertungslogik 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 die Bewertungslogik auf dem Gerät Zugriff auf zusätzliche Informationen, die als Parameter an die scoreAd-Funktion übergeben werden.

Daten zur Bewertung der Versorgung

Echtzeit-Bewertungssignale mit Schlüssel/Wert-Diensten

Als Verkäufer können Sie während einer Auktion Echtzeitsignale von einem von Ihnen genutzten Schlüssel/Wert-Dienst abrufen. Eine erste Implementierung dieses Dienstes finden Sie im öffentlichen Privacy Sandbox-Repository. Die URL für diesen Dienst wird in der Auktionskonfiguration als trustedScoringUri angegeben. Die Plattform versucht, die Daten abzurufen und über den Parameter trusted_scoring_signals für Ihre scoreAd-Funktion verfügbar zu machen. Sie sollten Ihre 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 Bewertungsfunktion übergeben. Dieses Feld enthält JSON-Objekte, deren 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 Bewertungslogik übergeben. Dieser wird als leeres Objekt übergeben. Wenn Sie der Meinung sind, dass ein Signal zum Nutzer für Ihren Anwendungsfall relevant sein könnte, reichen Sie Feedback ein.

Verkäufer: Anzeige rendern

Verkäufer müssen die Gewinneranzeige rendern. Weitere Informationen dazu, wie die Gewinneranzeigen gerendert werden, finden Sie im Designvorschlag. Dieser Bereich befindet sich noch in der Entwicklungsphase.

Impressionsergebnisse erfassen

Einrichten und Prototyp erstellen

• Käufer und Verkäufer können der JavaScript-Funktion reportWin(), die über den Parameter biddingLogicUrl bzw. scoringLogicUrl ausgeliefert wird, Berichtslogik hinzufügen. Sie können einen Mock-Dienst mit der angegebenen 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 außerdem eine Attribution Reporting API zum Verwalten von Berichten auf Ereignisebene und zusammengefassten Berichten. Weitere Informationen finden Sie im Integrationsleitfaden.

Persönliche Empfehlungen

• Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
• Entwicklerleitfaden für die Protected Audience API auf Android-Geräten
• Targeting auf benutzerdefinierte Zielgruppen mit der Protected Audience API unterstützen
• Frequency Capping für geschützte Zielgruppen