Integrationsleitfaden für Protected Audience (früher FLEDGE) für Analyseanbieter

Im Rahmen der Privacy Sandbox schlug Chrome vor, Geschützte Zielgruppe API: Browser-API mit der Werbetreibende und AdTech-Unternehmen Anzeigen schalten können, die auf Interessengruppen ohne sich auf Drittanbieter-Cookies zu verlassen, und schützen gleichzeitig die Nutzer vor websiteübergreifenden Verfolgung.

Wenn in der Protected Audience API eine Remarketing-Anzeige die Auktion gewinnt, wird das Rendering Die URL der Anzeige wird an eine umgegrenzte Rahmen für zu verbessern. Ein Fenced Frame ist ein vorgeschlagenes HTML-Element für eingebettete Inhalte. ähnlich wie ein iFrame. Im Gegensatz zu iFrames schränkt ein Fencing Frame die Kommunikation ein. mit seinem Einbettungskontext, um dem Frame Zugriff auf websiteübergreifende Daten zu gewähren, mit dem Einbettungskontext teilen. Weitere Informationen finden Sie in der Anwendungsfälle für Fenced Frames Erklären.

Display- und In Video 360 werden verschiedene Makros für Messungen der für das Impressions- und Klick-Tracking verwendet wird. Nur ein kleiner Teil davon -Makros können im Rahmen des Creative-Rendering ersetzt werden, da kein kontextabhängiger und Auktionssignale. Beispiel: ${PUBLISHER_ID} wird ohne Änderungen unterbrochen. Anbieter-Tags für Messungen.

Dieser Leitfaden richtet sich an Partner für die Anzeigenmessung, die Ereignisse für Werbetreibende, die Display- und Video 360

Registrierung

Ab August 2023 müssen Anbieter für Messungen möglicherweise die folgenden Schritte ausführen: unten, um sich für die Nutzung von Fenced Frame Reporting APIs in Protected Audience API verwenden.

Details dazu, wie und für wen Anmelden

Integration

Impressions-Tags des Anbieters für Messungen

Anleitung zur Einrichtung:

Skript-Tags Beispiel 
<script src='https://tracking.com/a.js'>xxx</script>
 Verantwortlichkeit:Anbieter von Messungen müssen die Skript-Tags für die Verwendung aktualisieren. reportEvent API für das Impressions-Tracking (siehe Anleitung) unten).
Bild-Tags Beispiel 
<img src='https://tracking.com/'>
 Verantwortung: Display- und Aktualisierung der zu verwendenden img src-Tags in Video 360 reportEvent API für das Impressions-Tracking.

reportEvent API

Die API wurde für folgende Zwecke vorgeschlagen: nur für das Post-Rendering-Tracking. Die API besteht aus zwei Teilen: registerAdMacro und reportEvent.

  • Display- und Video 360 ist Inhaber der Funktion registerAdMacro in reportWin. Die die Funktion ein Makro-Schlüssel/Wert-Paar im Browser vor dem Tag Rendering-Aufruf an.
  • Je nach Tag-Typ werden Display- und Video 360 oder Anbieter von Messungen die Änderungen an 3PAT-Tags zur Verwendung der reportEvent API.

reportEvent benötigt nur eine einzige „destinationURL“-Eingabe, die auf mit den Servern der Analyseanbieter verbunden. Sie kann alle Makros enthalten, die in den Listen Display- und Video 360-Hilfe . Beispiel:

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

Wenn Chrome den URL-Ping in der Funktion auslöst, sucht sie nach registrierten und ersetzen Sie sie durch die Werte, bevor Sie eine HTTP GET-Anfrage an https://adtech.example

Schritte zum Aktualisieren von Script-Tags

An vorhandenen Creative-Tags werden keine Änderungen vorgenommen. Display- und Video 360-Standbild rendert die Tags des Anbieters für Messungen, ohne sie als Teil des Creatives zu ändern Payload. Wenn Anbieter für Messungen Impressions-Pings vom geschützten Zielgruppen-API-Kontext, muss er die folgenden Schritte für eine Impression ausführen Tracking:

  1. Bereiten Sie eine Impressions-URL für einen Anbieter für Messungen vor, um die Impressions-Pings zu akzeptieren. Beispiel:

    https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123

  2. reportEvent-JS beim Antworten auf ein Skript von Protected hinzufügen Audience API verwenden. Beispiel:

    window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

  3. Impressionen erfassen, wenn Pings von der in Schritt 1.

Klick-Tags des Anbieters für Messungen

Das vorhandene Klick-Tag eines Anbieters für Messungen funktioniert weiterhin für Protected Audience-Impressionen. Display- und In Video 360 werden die reserved.top_navigation-Beacon zur Registrierung von Klicks und verkettet alle Klick-Tracker von Anbietern für Messungen als Weiterleitungen erkannt. Weitere Informationen finden Sie unter Chrome-Dokumentation für Berichte zu Fenced Frame Ads API hinzu.