Erste Schritte mit Attributionsberichten

In diesem Leitfaden finden Sie einen Überblick und eine Einrichtungsanleitung für Attributionsberichte auf Ereignisebene und Zusammenfassungsberichte, die die Attribution Reporting API verwenden.

Zuerst lernen Sie Folgendes:

  • Unterscheidung zwischen Attribution Reporting API-Berichtstypen

  • Schritte zur API-Implementierung und Berichterstellung ausführen

  • Referenz- und Fehlerbehebungsinformationen finden

Berichtstyp auswählen

Mit der Attribution Reporting API lassen sich die Leistungsdaten von Werbekampagnen mit unterschiedlichem Detaillierungsgrad und Datenschutz effektiv messen. Dazu stehen zwei verschiedene Berichtstypen zur Verfügung:

  • Berichte auf Ereignisebene:Sie enthalten detaillierte Daten, mit denen ein bestimmter Anzeigenklick oder -aufruf (die Quelle) mit entsprechenden Conversion-Daten (dem Auslöser) verknüpft wird. Berichte auf Ereignisebene schränken die Menge der Conversion-Daten ein und fügen Berichten Rauschen hinzu. Sie eignen sich ideal für Anwendungsfälle, in denen die Attribution einzelner Ereignisse wichtig ist, z. B. zur Messung der Kampagnenreichweite.

  • Zusammenfassungsberichte:Sie enthalten aggregierte Nutzerdaten und können detailliertere Conversion-Informationen mit zusätzlichem Rauschen enthalten. Sie werden sowohl mit der Attribution Reporting API als auch mit der Private Aggregation API aus Aggregatberichten erstellt und bieten ein umfangreicheres Datenmodell als Berichte auf Ereignisebene. Zusammenfassungsberichte sind besonders nützlich für Szenarien, in denen aggregierte Statistiken erforderlich sind, z. B. zum Berechnen von Conversion-Werten oder zum Analysieren der Kampagnenleistung in verschiedenen Nutzersegmenten.

Implementierungsübersicht

In den folgenden Abschnitten werden die allgemeinen Schritte zum Generieren der einzelnen Berichtstypen beschrieben. Sie können sich auch die Attribution Reporting API Demo ansehen, um eine Schritt-für-Schritt-Anleitung für den gesamten Prozess zu erhalten.

Voraussetzung:Ihre Websites müssen SSL/TLS-Zertifikate (HTTPS) haben, bevor Sie Quellen und Trigger registrieren und Berichte erhalten können.

Berichte auf Ereignisebene erstellen

So generieren Sie Berichte auf Ereignisebene:

  1. Quelle registrieren:Ein Anzeigenklick oder eine Anzeigenimpression wird mit Attributionsinformationen verknüpft. Eine detaillierte Anleitung finden Sie unter Attributionsquellen registrieren und Registrierung von Attributionsquellen. Der Registrierungsprozess unterscheidet sich leicht für Klicks und Aufrufe.

  2. Trigger registrieren:Ein Conversion-Ereignis wird erfasst und mit einer zuvor registrierten Quelle verknüpft. Eine Anleitung finden Sie unter Attribution-Trigger registrieren.

  3. Berichtsendpunkt einrichten:Erstellen Sie einen Endpunkt auf Ihrem Server, um Berichte auf Ereignisebene zu empfangen. Die Endpunkt-URL sollte das folgende Format haben: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution. Ein Beispiel für die Methode POST finden Sie im Beispielcode in adtech.js. Weitere Informationen zu .well-known finden Sie in der Wikipedia.

Weitere Informationen zu Berichten auf Ereignisebene finden Sie im Erklärartikel zu Berichten auf Ereignisebene.

Erstellung von Zusammenfassungsberichten

  1. Quelle registrieren:Das funktioniert genauso wie bei Berichten auf Ereignisebene. Weitere Informationen finden Sie unter Attributionsquellen registrieren und Registrierung von Attributionsquellen.

  2. Trigger registrieren:Das funktioniert genauso wie bei Berichten auf Ereignisebene. Weitere Informationen finden Sie unter Attributionstrigger registrieren.

  3. Berichtsendpunkt einrichten:Erstellen Sie einen Endpunkt, um aggregierte Berichte zu empfangen. Die URL sollte {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution lauten. Ein Beispiel für die POST-Methode finden Sie unter adtech.js und Informationen zu .well-known unter Wikipedia.

  4. Berichte in Batches zusammenfassen und senden:Fassen Sie die zusammengefassten Berichte in Batches zusammen und senden Sie sie zur Verarbeitung an den Aggregationsdienst. Der Aggregationsdienst generiert dann Zusammenfassungsberichte. Weitere Informationen finden Sie unter Strategien für Batching.

Weitere Informationen zu Zusammenfassungsberichten finden Sie im Aggregatable Report Explainer.

Zusätzlich zu den Implementierungsschritten können Ihnen die folgenden Themen bei der Planung Ihrer Strategie für Übersichtsberichte helfen:

Filter einrichten (optional)

Wenn Sie die Zuweisungsdaten, die Sie erhalten, genauer steuern möchten, können Sie Filter einrichten.

Durch das Filtern können Sie die Datenanalyse verfeinern, indem Sie bestimmte Teilmengen von Daten für Ihre Analyse isolieren und so das Rauschen reduzieren. Außerdem können Sie damit die Leistung bestimmter Werbekampagnen und Conversion-Ereignisse erfassen, um genauere Analysen zu erhalten.

Informationen zum Einrichten von Filtern finden Sie unter Benutzerdefinierte Regeln mit Filtern definieren und im Abschnitt zu Triggern der Registrierung von Attributions-Triggern.

Prüfen, ob die API aktiviert ist

Prüfen Sie vor der Verwendung der API mit dem folgenden Code, ob sie aktiviert ist:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

Mit dieser Prüfung wird ermittelt, ob die API im aktuellen Kontext zulässig ist. Die Browsereinstellungen der Nutzer oder andere Faktoren können jedoch weiterhin die Verwendung der API verhindern. Aus Datenschutzgründen gibt es keine programmatische Möglichkeit, die API-Verwendbarkeit definitiv zu bestätigen.

Nächste Schritte

In den folgenden Abschnitten finden Sie weitere Informationen zu den ersten Schritten mit Attributionsberichten.

Implementierung

Hintergrund und Konzepte

Demos und Tools

Planung