Erste Schritte mit Attributionsberichten

In diesem Leitfaden finden Sie eine Übersicht und eine Anleitung zur Einrichtung von Berichten auf Ereignisebene und Zusammenfassungsberichten zur Attribution mit der Attribution Reporting API.

Zuerst lernen Sie Folgendes:

  • Attribution Reporting API-Berichtstypen unterscheiden

  • API implementieren und Berichte generieren

  • Referenz- und Fehlerbehebungsinformationen

Berichtstyp auswählen

Die Attribution Reporting API bietet zwei verschiedene Berichtstypen, mit denen Sie die Leistung von Werbekampagnen mit unterschiedlichen Detail- und Datenschutzgraden effektiv messen können:

  • Berichte auf Ereignisebene:Hier finden Sie detaillierte Daten, die einen bestimmten Anzeigenklick oder -aufruf (die Quelle) mit den entsprechenden Conversion-Daten (der Trigger) verknüpfen. Berichte auf Ereignisebene beschränken die Menge der Conversion-Daten und erhöhen die Fehlerquote. Sie eignen sich ideal für Anwendungsfälle, bei denen die Attribution einzelner Ereignisse entscheidend ist, z. B. für die Messung der Kampagnenreichweite.

  • Zusammenfassungsberichte:Enthalten aggregierte Nutzerdaten und können detailliertere Conversion-Informationen mit zusätzlichen Störfaktoren enthalten. Sie werden sowohl mit der Attribution Reporting API als auch mit der Private Aggregation API erstellt und basieren auf zusammengefassten Berichten. Sie bieten ein umfangreicheres Datenmodell als Berichte auf Ereignisebene. Zusammenfassungsberichte sind besonders nützlich für Szenarien, in denen aggregierte Statistiken erforderlich sind, z. B. für die Berechnung von Conversion-Werten oder die Analyse der Kampagnenleistung in Nutzersegmenten.

Implementierungsübersicht

In den folgenden Abschnitten werden die allgemeinen Schritte zum Erstellen der einzelnen Berichtstypen beschrieben. In der Attribution Reporting API-Demo finden Sie eine detaillierte Anleitung für den gesamten Prozess.

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

Berichte auf Ereignisebene erstellen

In den folgenden Schritten wird beschrieben, wie Sie Berichte auf Ereignisebene generieren:

  1. Quelle registrieren:Hiermit wird ein Anzeigenklick oder eine Anzeigenaufruf mit Attributionsinformationen verknüpft. Eine ausführliche Anleitung finden Sie unter Attributionsquellen registrieren und Registrierung von Attributionsquellen. Die Registrierung für Klicks und Aufrufe unterscheidet sich geringfügig.

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

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

Weitere Informationen zu Berichten auf Ereignisebene finden Sie im Hilfeartikel Berichte auf Ereignisebene.

Erstellung von Zusammenfassungsberichten

  1. Quelle registrieren:Wie bei Berichten auf Ereignisebene. Weitere Informationen finden Sie unter Attributionsquellen registrieren und Registrierung von Attributionsquellen.

  2. Trigger registrieren:Wie bei Berichten auf Ereignisebene. Weitere Informationen finden Sie unter Attributionstrigger registrieren.

  3. Berichtsendepunkt einrichten:Erstellen Sie einen Endpunkt, um zusammengefasste Berichte zu erhalten. 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 in der Wikipedia.

  4. Berichte im Batch zusammenstellen und senden:Sie können zusammengefasste Berichte im Batch zusammenstellen und zur Verarbeitung an den Aggregationsdienst senden. Der Aggregationsdienst generiert dann Zusammenfassungsberichte. Weitere Informationen finden Sie unter Strategien für Batch-Uploads.

Weitere Informationen zu Zusammenfassungsberichten finden Sie im Hilfeartikel Erläuterung zu aggregierten Berichten.

Zusätzlich zu den Implementierungsschritten helfen Ihnen die folgenden Themen bei der Planung Ihrer Strategie für Zusammenfassungsberichte:

Filter einrichten (optional)

Mithilfe von Filtern können Sie die Attributionsdaten, die Sie erhalten, genauer steuern.

Durch das Filtern werden bestimmte Teilmengen von Daten für die Analyse isoliert, wodurch Störfaktoren reduziert werden. Außerdem können Sie damit die Leistung bestimmter Werbekampagnen und Conversion-Ereignisse genauer erfassen.

Informationen zum Einrichten von Filtern finden Sie unter Benutzerdefinierte Regeln mithilfe von Filtern definieren. Im Abschnitt „Trigger“ der Registrierung von Attributionstriggern finden Sie Details zu Berichten, die aggregiert werden können.

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
}

Diese Prüfung gibt an, ob die API im aktuellen Kontext zulässig ist. Die Browsereinstellungen des Nutzers oder andere Faktoren können jedoch verhindern, dass die API verwendet wird. Aus Datenschutzgründen gibt es keine programmatische Möglichkeit, die Nutzerfreundlichkeit der API 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