Protected Audience: Integrationsleitfaden

Protected Audience (früher FLEDGE) in Android-Implementierungen beinhaltet in der Regel die Integration zwischen Werbetreibenden-Apps, Publisher-Apps, Verkäufern und Käufern. Dieser Leitfaden richtet sich an Partner, die benutzerdefinierte Zielgruppen verwalten und Auktionen durchführen 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 Protected Audience-Funktionen werden für alle Anwendungsfälle verwendet. In diesem Leitfaden werden nach Möglichkeit die Schritte aufgeführt, die erforderlich sind, um speziellere Fälle zu unterstützen.

Zur Vorbereitung auf die groß angelegte Produktionsbereitstellung von Protected Audience können Partner mit Tests beginnen, indem sie die Integrationspunkte mit anderen Parteien simulieren. In diesem Leitfaden erhalten Sie einen umfassenden Überblick über die Einbindung von Protected Audience in Ihre Android-Apps als Unterstützung bei der Integrationsplanung. Dazu können auch Funktionen gehören, die in der aktuellen Phase der Privacy Sandbox in der Android-Entwicklervorschau noch nicht implementiert sind. In diesen Fällen erhalten Sie eine Anleitung zum Zeitplan.

Der Workflow für die Protected Audience-Integration umfasst vier wichtige Schritte, die von verschiedenen Arten von Anzeigentechnologie-Partnern abhängen:

1. Der Käufer erstellt benutzerdefinierte Zielgruppen.
2. Bei der Anzeigenauswahl wird die erfolgreiche Anzeige ermittelt.
   1. Durch die App des Verkäufers wird die Anzeigenauswahl initiiert.
   2. Anzeigendienste führen Filter- und Gebotscode auf Käuferseite aus.
   3. Anzeigendienste führen den Entscheidungscode auf der 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:

Der Workflow für die benutzerdefinierte Zielgruppenverwaltung und Anzeigenauswahl in Protected Audience.

Terminologie

• Werbetreibender: Ein Unternehmen, das Nutzer über den Kauf von Anzeigeninventar begeistert.
• Publisher: Ein Unternehmen, das Anzeigeninventar verkauft, das neben seinen Inhalten verfügbar ist.
• Käufer: Ein Unternehmen für Anzeigentechnologie, das Werbetreibenden den Kauf von Anzeigeninventar erleichtert.
• Verkäufer: Ein Unternehmen für Anzeigentechnologie, das Publishern den Verkauf von Anzeigeninventar erleichtert.
• Netzwerk: Ein Unternehmen für Anzeigentechnologie, das sowohl als Käufer als auch als Verkäufer fungiert.
• Inhaber 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 zu integrieren.

Voraussetzungen, Integrationspartner einbeziehen und einrichten

In diesem Abschnitt werden einige erste Aktivitäten beschrieben, damit Sie verstehen, wie Protected Audience funktioniert, wie Sie Protected Audience integrieren und wie Sie Ihre Integrationspartner bei einer Protected Audience-Implementierung unterstützen können. Diese Aktivitäten können parallel erfolgen.

Einführungsleitfaden für Protected Audience-Funktionen

.

Mit der Protected Audience API vertraut machen

Machen Sie sich zuerst mit den APIs und Diensten von Protected Audience vertraut.

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

Beispiel-Apps einrichten und testen

Sobald Sie mit den Grundlagen zu 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 aktuellen Privacy Sandbox-Entwicklervorschau ein.
2. Richten Sie die erforderlichen Serverendpunkte ein. Verwenden Sie die Beispielmodelle mit Ihrer bevorzugten API-Testlösung, um diesen Prozess zu starten.
3. Erstellen Sie den Code in unserer Beispiel-App und führen Sie ihn aus, um sich mit der benutzerdefinierten Zielgruppenverwaltung, dem Workflow für die Anzeigenauswahl und den Berichten zu Impressionen vertraut zu machen.

Engagement mit dem Integrationspartner

Vereinbare einen Termin mit deinen Integrationspartnern, um die Tests und die Einführung von Protected Audience auf Android zu besprechen, einschließlich der Form der zwischen den Parteien weitergegebenen Signale. Für Käufer sollten die Diskussionen Strategien zum Erstellen und Verknüpfen benutzerdefinierter Zielgruppen enthalten, einschließlich Diskussionen über die Definition von Zielgruppen. Arbeiten Sie mit Ihren Integrationspartnern zusammen, um Zeitpläne für die Integration zu definieren, von den ersten Tests bis zur Einführung, und um die Bereiche festzulegen, für die jede Partei im Design verantwortlich ist.

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

Registrieren Sie Ihre Organisation bei der Privacy Sandbox für Android. Die Registrierung ist erforderlich, damit AdTech-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

Sowohl für Käufer als auch für Verkäufer bietet Protected Audience die Möglichkeit, Anzeigenauktionen auf dem Gerät auszuführen. Sie und Ihre Integrationspartner sollten bei Ihren Designs einige wichtige Aspekte berücksichtigen:

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

Im Gegensatz zur vollständigen Speicherung von Anzeigen auf Servern werden Zielgruppeninformationen und Remarketing-Anzeigen auf dem Gerät gespeichert. Kontextbezogene Anzeigen, die für die Ausrichtung keine Gerätedaten benötigen, verbleiben auf den Servern. AdTech-Plattformen müssen erweitert werden, um den Anzeigenbedarf zu berücksichtigen, der zwischen Servern und Geräten verteilt wird.

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

AdTech-Plattformen können nicht nur Auktionen auf Servern ausführen, sondern jetzt auch die auf dem Gerät gespeicherte Anzeigennachfrage mit Preis- und Rangangabe versehen.

Ein gängiger Ansatz besteht darin, dass Anzeigentechnologie-Anbieter wie gewohnt Auktionen für kontextbezogene Anzeigen durchführen. Nach Abschluss der Auktion kann ein Verkäufer auf dem Gerät eine Auktion 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 Limits zu berücksichtigen, damit die Auktionsausführung gemäß den Vorgaben der verschiedenen Integrationspartner in einer Vielzahl von Remarketing-Anwendungsfällen beendet wird.

Datenstrategie

AdTech-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. Protected Audience-Auktionen bieten verschiedene Möglichkeiten zur Übergabe dieser Daten. Beispiel: Echtzeitsignale wie das verbleibende Budget stammen von einem Schlüssel/Wert-Paar-Dienst als vertrauenswürdige Signale, während kontextbezogene Signale wie die Tageszeit von Verkäufern gesendet werden, wenn eine Auktion durchgeführt wird. Diese Signale werden in den entsprechenden Abschnitten dieses Leitfadens ausführlicher erläutert.

Lösung erstellen

Auktionen mit Protected Audience API werden in mehreren wichtigen Phasen durchgeführt. Die 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 Anzeigen der Kandidaten bewerten und einen Gewinner bestimmen. In einigen dieser Phasen ist eine Zusammenarbeit zwischen beiden Parteien erforderlich, damit die Auktion richtig durchgeführt werden kann. In den folgenden Abschnitten wird jede Phase im Detail beschrieben und es wird explizit darauf hingewiesen, welche Partei für die Implementierung verantwortlich ist.

Käufer: Eine Zielgruppe aufbauen

Käufer verwalten in der Regel benutzerdefinierte Zielgruppen. Da benutzerdefinierte Zielgruppen auf dem Gerät verwaltet werden, muss die API zum Verwalten von benutzerdefinierten Zielgruppen auf dem Gerät aufgerufen werden.

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

Wenn du keinen eigenen SDK-Code auf Geräten hast, kannst du mit einem bestehenden Integrationspartner zusammenarbeiten, der ebenfalls SDK-Anbieter ist. Bestimmen Sie diesen Partner und definieren Sie gemeinsam mit ihm einen Vertrag und einen Ablauf zum Definieren und Verwalten benutzerdefinierter Zielgruppen. In diesem Leitfaden wird unabhängig davon, welcher Ansatz verwendet wird, der Begriff „Käufer“ verwendet. Hier einige Beispiele für Ansätze:

• Bitten Sie als Käufer den Werbetreibenden, die Zielgruppe zu definieren. Ein Integrationspartner-SDK 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 für den 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, schließt die Zielgruppe zum entsprechenden Zeitpunkt ab und benachrichtigt den Käufer, dass ein Nutzer der Zielgruppe hinzugefügt wurde.

Prototyp für 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 Werbetreibende dabei unterstützen, in ihren Apps benutzerdefinierte Zielgruppen zu erstellen, die auf Nutzeraktivitäten basieren.

Protected Audience erstellt einen Container für die benutzerdefinierte Zielgruppe, der einer bestimmten vom Werbetreibenden definierten benutzerdefinierten Nutzerinteraktion zugeordnet wird. Dazu gehören eine Reihe möglicher Anzeigen, die für diese Zielgruppe ausgeliefert werden können, sowie eine Sammlung benutzerdefinierter Gebotslogik und Daten, die während einer Auktion verwendet werden können, um die Anzeigen zu filtern und Preise festzulegen.

Einrichtung 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 zur API-Nutzung finden Sie im Entwicklerhandbuch.

Designaspekte

Käufer können eine Vielzahl von Anwendungsfällen erfüllen, indem sie benutzerdefinierte Zielgruppen konfigurieren. Dazu gehört unter anderem das Definieren der Gebotslogik für den Anzeigentyp oder die Kampagne, auf die diese Zielgruppe ausgerichtet ist, und die Definition einer Liste möglicher Anzeigen. Dieser Abschnitt enthält Designüberlegungen zum Ausfüllen und Verwenden einiger wichtiger Felder in einer benutzerdefinierten Zielgruppe.

Gebotslogik-URL

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 Nutzersignale, wie in den nächsten Abschnitten beschrieben. Die Einrichtung der Gebotslogik und Nutzersignale wird weiter unten in diesem Artikel erläutert.

Signale für Gebote von Nutzern

Mit UserBiddingSignals können die Käufer Informationen über den Nutzer, die der Werbetreibende oder der Käufer selbst hat, bei zukünftigen Auktionen auf dem Gerät weitergeben. Dazu können folgende Informationen gehören:

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

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

• Die Gebote lassen sich je nach Signalsignal erhöhen oder verringern.
• Sie können bestimmte Anzeigen aus der Auktion herausfiltern.

Trusted Bidding-Daten

Im Rahmen der Protected Audience-Implementierung können Käufer während der Auktion über einen Schlüssel/Wert-Paar-Dienst auf Echtzeitinformationen zugreifen. Vorübergehend können Käufer und Verkäufer diese Gebotssignale von jedem Dienst abrufen, auch von selbst betriebenen Diensten. Das häufigste Beispiel ist das Nachschlagen des verbleibenden Budgets für Anzeigen. Während der Entwicklung ist es möglich, einen simulierten Dienst für diesen Dienst zu erstellen und ihn für die Entwicklung zu nutzen. Eine Einrichtungsanleitung 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 beim Entwerfen, welche Art von Schlüsselstruktur verwendet werden sollte:

• Ein einfacher Ansatz besteht darin, einen Schlüssel einzufügen, der 1:1 der erstellten Zielgruppe zuordnet. Der Schlüssel/Wert-Dienst kann dann alle relevanten Informationen zur Zielgruppe enthalten.
• Budget und Anzeigenstatus müssen in Echtzeit berücksichtigt werden.
• Das Höchstgebot oder andere Signale, die für den Preis einer Anzeige in einer Auktion verwendet werden können. Es ist möglich, diese Informationen mit der Anzeige in eine AdData-Liste aufzunehmen, aber wenn sie in einem Schlüssel/Wert-Paar-Dienst gespeichert werden, können sie einfacher nach Bedarf aktualisiert werden.

Liste der Anzeigendaten

Beim Erstellen einer Remarketing-Kampagne ziehen Werbetreibende in der Regel viele verschiedene Arten von Anzeigen in Betracht, die einem Nutzer in einer Zielgruppe präsentiert werden. Beispielsweise bieten sie verschiedene Rabatte basierend auf der bisherigen Interaktion eines Nutzers mit der App an. Eine benutzerdefinierte Zielgruppe enthält eine AdData-Liste mit möglichen Anzeigen.

Die Käufer entscheiden, welche Informationen für jede Anzeige enthalten sein sollen. Beachten Sie Folgendes:

• Die Liste AdData kann auf zwei Arten aktualisiert werden:
  • Wenn die App im Vordergrund eine sichtbare Aktivität hat, kann die Liste initiiert werden, wenn ein Nutzer einer benutzerdefinierten Zielgruppe hinzugefügt wird.
  • Während eines täglichen Updates wird der Abruf im Hintergrund gestartet. Das Gerät sendet eine Anfrage an den im joinCustomAudience-Aufruf enthaltenen daily_update_url 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-Paar-Dienst des Käufers, 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 Ihrer Anzeige eine Creative-ID hinzufügen, können Sie bestimmte Aktionen für bestimmte Creatives ausführen. Beispielsweise können Werbetreibende bestimmte Creatives pausieren und Sie diese Creative-IDs aus dem Echtzeit-Schlüssel/Wert-Dienst abrufen und dann mit Anzeigen in der AdData-Liste abgleichen.

AdData sollte eine render_url enthalten. Die Rendering-URL der erfolgreichen Remarketing-Anzeige wird verwendet, um die Anzeige zu rendern. Hier einige Überlegungen:

• Die Rendering-URL hat einen k-Anonymitätsschwellenwert. Verwenden Sie daher keine Eingrenzungsparameter. Weitere Informationen über diesen 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 anzeigen möchten, betten Sie Produkt-IDs als Parameter in die URL ein.

Beim Prototyping ist das einzige Pflichtfeld das renderUri, das auf die Rendering-Assets der Anzeige verweist. Das Metadatenfeld in AdData kann beim Erstellen der Lösung ignoriert werden. Wenn Sie Ihre Lösung in Richtung Produktion bewegen, sollten Sie überlegen, welche Metadaten für Sie relevant sind, da diese bei der Gebotsgenerierung zur Anpassung Ihres Gebotspreises verwendet werden können.

Aktivierungs- und Ablaufzeit

Die Felder für Aktivierung und Ablaufzeit eignen sich für Anwendungsfälle, bei denen eine benutzerdefinierte Zielgruppe nur innerhalb eines vordefinierten Zeitraums für Auktionen infrage kommt. Beachten Sie, dass es bestimmte Einschränkungen dafür gibt, wie lange eine Aktivierungszeit verzögert werden kann, sowie das Delta zwischen der Aktivierungs- und der 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 so konfigurieren, dass ein Zeitstempel 7 Tage in der Zukunft liegt.
  • Die Zielgruppe kann Gebote abgeben, wenn seit dem letzten Öffnen der App 7 Tage vergangen sind.
• Saisonale Zielgruppe (eine Zielgruppe, die in naher Zukunft nur zu einem bestimmten Zeitraum gültig ist)
  • Käufer können im Voraus benutzerdefinierte Zielgruppen definieren, die nur zu einer vorab festgelegten Zeit in der Zukunft für Gebote infrage kommen sollen.
  • Wenn ein Werbetreibender beispielsweise im Jahr 2022 eine Kampagne zum Ende des Sommers in den USA geschaltet hat, kann sein Käufer joinCustomAudience anrufen und activation_time so konfigurieren, dass er Samstag, den 20. August 2022 ist. Wenn die Kampagne nur eine Woche lang aktiv ist, 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 der Speicherbereinigung unterzogen.

Käufer und Verkäufer: Anzeigenauswahl

Für die Anzeigenauswahl ist eine Zusammenarbeit zwischen Käufern und Verkäufern erforderlich. Dies kann als Prozess in vier Schritten betrachtet werden:

1. Die 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 mögliche Anzeige und ein Gebot auszuwählen.
4. Die Entscheidungslogik des Verkäufers wird ausgeführt, um die Kandidaten zu bewerten und eine erfolgreiche Anzeige auszuwählen.

Um die Entwicklung zu vereinfachen, können Sie simulierte Serviceantworten für Käufer und für Verkäufer erstellen, einschließlich Gebots- und Bewertungslogik. So können Sie sich auf die Entwicklung der für Ihren Anwendungsfall relevanten Aspekte konzentrieren. Eine Anleitung zum Einrichten von Mock-Endpunkten finden Sie im FledgeServerSpec-Verzeichnis auf GitHub. Im Entwicklerleitfaden finden Sie eine Anleitung dazu, wie Sie den Remote-JavaScript-Abruf überschreiben können.

Verkäufer: Vermittlungsstrategie definieren

Protected Audience unterstützt die abfolgebasierte Vermittlung. Dieser Bereich befindet sich in der Entwicklung. Weitere Informationen werden bereitgestellt, sobald diese verfügbar sind. Sehen Sie sich vorerst den Designvorschlag für die abfolgebasierte Vermittlung in Protected Audience an.

Verkäufer: Auktion konfigurieren

Der Verkäufer ist für die Konfiguration der Auktion und die Bereitstellung von Informationen für den Anzeigenauswahlprozess verantwortlich. Verkäufer können entscheiden, ob sie Informationen allen oder nur ausgewählten Parteien zur Verfügung stellen möchten. Dazu können Informationen gehören, die Ihnen vorliegen, oder Informationen, die Sie im Namen der Käufer angeben.

Einrichtung und Prototyp erstellen

• Ein Verkäufer kann eine Auktion konfigurieren und initiieren, 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 zur API-Nutzung finden Sie im Entwicklerhandbuch.

Designaspekte

Dieser Abschnitt enthält Designüberlegungen zum Ausfüllen und Verwenden wichtiger Felder bei einer Anzeigenauswahlkonfiguration.

• Die private Ausführungsumgebung enthält nur Anzeigen mit benutzerdefinierten Zielgruppen auf dem Gerät. Wenn Sie also vorher eine kontextbezogene Anzeigenanfrage senden, können Sie die 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 erfassen. Anhand dieser Informationen können Sie dann die Anzeigenauswahl konfigurieren.

• Da viele Käufer benutzerdefinierte Zielgruppen auf dem Gerät erstellen können, müssen Verkäufer im Feld Benutzerdefinierte Zielgruppenkäufer die Käufer angeben, die in den Vorgang 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 das Verfahren einbeziehen möchte.
  • Eine Liste von Käufern, die angeben, dass sie an ihrer Anzeigenreaktion teilnehmen möchten. Diese Option ist nützlich, wenn der Verkäufer mit Anzeigenplattformen arbeitet und möglicherweise nicht alle Käufer vollständig kennt.

• Der Verkäufer kann auf unterschiedliche Weise Informationen an den Prozess weitergeben:

  • Das Feld für Signale zur Anzeigenauswahl ist für alle Käufer und Verkäufer verfügbar, die im Rahmen der privaten Laufzeit an der Auktion teilnehmen. Geben Sie damit Informationen über die Werbechance an, z. B. die Anzeigengröße und das Anzeigenformat.
  • Das Feld Signale pro Käufer wird zur Verwendung bei der Gebotsabgabe an einen bestimmten Käufer weitergeleitet. Diese Informationen werden vom Käufer zur Verfügung gestellt und Sie als Verkäufer müssen überlegen, wie Sie diese Informationen auf dem Gerät erhalten, damit sie während der Anzeigenauswahl verwendet werden können.
  • Das Feld Verkäufersignale ist die letzte Möglichkeit, über die der Verkäufer Informationen an den Prozess weitergeben kann. Sie als Verkäufer nutzen diese Signale beim Bewerten von Anzeigen und beim Filtern von Anzeigen, z. B. beim Aktivieren einer Markensicherheitsprüfung.

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

Einrichtung und Prototyp erstellen

• Käufer können ihre Gebotslogik der JavaScript-Funktion generateBid() hinzufügen, die beim Erstellen einer CustomAudience über den Parameter biddingLogicUrl bereitgestellt wird. Sie können mithilfe der bereitgestellten Spezifikation einen fiktiven Dienst einrichten oder diesen Endpunkt auf einem echten Server implementieren.
• Weitere Informationen zur Implementierung und zur API-Nutzung finden Sie im Entwicklerhandbuch.

Designaspekte

• Die Gebotslogik wird auf dem Gerät ausgeführt und einige in der Auktion verwendete Signale werden in Echtzeit abgefragt. Informationen zu Einschränkungen finden Sie in der Liste der Einschränkungen.
• Für einige Anzeigenanwendungsfälle ist es wichtig, mit dem Verkäufer zusammenzuarbeiten, um sicherzustellen, dass Sie mehrere Anzeigenkandidaten haben und deren Gebote auf dem Gerät berücksichtigt werden.

Gebotslogik entwerfen

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

Gebotsdaten bereitstellen

Signale für Echtzeitgebote mit Schlüssel/Wert-Paar-Diensten

Als Käufer können Sie während einer Auktion Echtzeitsignale von einem Schlüssel/Wert-Paar-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 in einer benutzerdefinierten Zielgruppe als trustedBiddingUrl angegeben. Die Plattform versucht dann, die Daten abzurufen und sie mit der trusted_bidding_signals parameter-Funktion für die 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. Bei diesen Feldern handelt es sich um 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önnten. Das Objekt, das diese Signale enthält, wird von Protected Audience selbst erstellt und an Ihre Gebotslogik übergeben. Wird derzeit als leeres Objekt übergeben. Wenn Sie der Meinung sind, dass ein Kontextsignal für 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. Der Verkäufer legt diese Werte beim Erstellen der Auktionskonfiguration fest. Käufer und Verkäufer müssen zusammenarbeiten, um sicherzustellen, dass diese Daten auf dem Gerät gespeichert und an Ihre Gebotslogik übergeben werden. Hier einige Anwendungsbeispiele für dieses Feld:

• Filterung nach Markensicherheit Der Verkäufer kann die Käufer über einige Klassifizierungsinformationen zu der App informieren, von der eine Anzeige angefordert wird, und 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: Erfolgreiche Anzeige bewerten und auswählen

Einrichtung und Prototyp erstellen

• Ein Verkäufer kann seine Bewertungslogik der JavaScript-Funktion scoreAd() hinzufügen, die aus dem Parameter scoringLogicUrl beim Erstellen von AdSelectionConfig bereitgestellt wird. Sie können mithilfe der bereitgestellten Spezifikation einen fiktiven Dienst einrichten oder diesen Endpunkt auf einem echten Server implementieren.
• Weitere Informationen zur Implementierung und zur API-Nutzung finden Sie im Entwicklerhandbuch.

Bewertungslogik entwerfen

Verkäufer implementieren eine Bewertungslogik in JavaScript, das auf dem Gerät ausgeführt wird. Im Entwicklerleitfaden finden Sie Informationen zur erforderlichen Signatur und zu den verschiedenen Parametern, die bei der Auktion übergeben werden. Darüber hinaus hat die Bewertungslogik auf dem Gerät Zugriff auf zusätzliche Informationen, die als Parameter an die Funktion scoreAd übergeben werden.

Bewertungsdaten bereitstellen

Signale zur Bewertung in Echtzeit mit Schlüssel/Wert-Paaren

Als Verkäufer können Sie während einer Auktion Echtzeitsignale von einem Schlüssel/Wert-Paar-Dienst abrufen, der Ihnen gehört. Eine erste Implementierung dieses Dienstes finden Sie im öffentlichen Repository der Privacy Sandbox. 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 die Funktion scoreAd verfügbar zu machen. Sie sollten Ihre eigene Schlüsselstruktur festlegen.

Kontext- und Nutzersignale

Die Funktion scoreAd 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 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 mit diesen Signalen wird von Protected Audience selbst erstellt und an Ihre Bewertungslogik übergeben. Dies wird als leeres Objekt übergeben. Wenn Sie der Meinung sind, dass ein Hinweis auf den Nutzer für Ihren Anwendungsfall relevant sein könnte, reichen Sie Feedback ein.

Verkäufer: Anzeige rendern

Verkäufer müssen die erfolgreiche Anzeige rendern. Weitere Informationen dazu, wie erfolgreiche Anzeigen gerendert werden, finden Sie im Designvorschlag. Dieser Bereich befindet sich noch im Design.

Impressionsergebnisse melden

Einrichtung und Prototyp erstellen

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

Designaspekte

Käufer und Verkäufer müssen eine reportWin-Funktion in ihren 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 für die Verwaltung von Ereignissen auf Ereignisebene und aggregierte Berichte. Weitere Informationen finden Sie im Integrationsleitfaden.