Erste Schritte mit Attributionsberichten

Hier erfährst du alles über die Einrichtung, einschließlich der Einrichtung und eines kurzen Überblicks.

Berichtstyp auswählen

Mit der Attribution Reporting API können Sie zwei Arten von Berichten erstellen: auf Ereignisebene und zusammenfassende Berichte. Berichte auf Ereignisebene erfordern weniger Einrichtung als zusammengefasste Berichte oder zusammenfassende Berichte, daher sind sie ein guter Ausgangspunkt. Zusammenfassungsberichte erfordern die Integration mit dem Aggregationsdienst. Bei Berichten auf Ereignisebene ist dies nicht der Fall.

Sie können Berichte sowohl für Berichte auf Ereignisebene als auch für zusammenfassende Berichte einrichten. Sie sind komplementär.

Berichte auf Ereignisebene

In Berichten auf Ereignisebene werden bestimmte Anzeigenklicks oder -ansichten (auf Anzeigenseite) mit Daten auf der Conversion-Seite verknüpft. Um den Datenschutz der Nutzer zu wahren, indem die Zusammenführung der Nutzeridentität über mehrere Websites hinweg eingeschränkt wird, sind die Conversion-Daten sehr begrenzt und die Daten sind ungenau.

Zusammenfassende Berichte

Ein zusammenfassender Bericht ist ein Bericht vom Typ „Attribution Reporting API“ und „Private Aggregation API“. Ein zusammenfassender Bericht enthält aggregierte Nutzerdaten und kann detaillierte Conversion-Daten mit Störfaktoren enthalten. Zusammenfassungsberichte bestehen aus zusammengefassten Berichten.

Implementierung

Probieren Sie einfach die folgenden Schritte aus.

Beachten Sie, dass für eine bestimmte Ereignisquelle sowohl ein Bericht auf Ereignisebene als auch ein aggregierter Bericht erstellt werden kann. Die Demo führt Sie durch den Vorgang.

Berichterstellung auf Ereignisebene

Die folgenden Schritte sind mindestens erforderlich, um Berichte auf Ereignisebene zu erstellen:

  1. Registrieren Sie eine Quelle. Eine Anleitung finden Sie unter Attributionsquellen registrieren. Die Schritte für Klicks und Aufrufe sind unterschiedlich.

  2. Registrieren Sie einen Trigger. Eine Anleitung finden Sie unter Attributionstrigger registrieren.

  3. Richten Sie einen Endpunkt mit der folgenden URL ein:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
    Im Beispielcode in „adtech.js“ finden Sie die Methode post. Weitere Informationen zu .well-known

Weitere Informationen zu Berichten auf Ereignisebene

Zusammenfassungsbericht erstellen

Führen Sie zum Erstellen von Zusammenfassungsberichten die folgenden allgemeinen Schritte aus:

  1. Registrieren Sie eine Quelle. Eine Anleitung finden Sie unter Attributionsquellen registrieren. Die Schritte für Klicks und Aufrufe sind unterschiedlich. Weitere Informationen finden Sie im Hilfeartikel Registrierung der Attributionsquelle.

  2. Registrieren Sie einen Trigger. Eine Anleitung finden Sie unter Attributionstrigger registrieren.

  3. Richten Sie einen Endpunkt für aggregierte Berichte mit der folgenden URL ein:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
    Im Beispielcode in adtech.js finden Sie die Methode post. Weitere Informationen zu .well-known

  4. Sie können Berichte als Batch senden und zur weiteren Verarbeitung durch den Aggregation Service verarbeiten. Dadurch werden zusammenfassende Berichte erstellt. Weitere Informationen finden Sie unter Aufeinanderfolgende aggregierte Berichte.

Weitere Informationen zu Zusammenfassungsberichten

Wie Sie Berichte zur Fehlerbehebung einrichten, erfahren Sie in der Reihe zur Fehlerbehebung bei Attributionsberichten.

Zusammenfassungsberichte – zusätzliche Konzepte

Neben den hier aufgeführten Implementierungsschritten helfen Ihnen die folgenden Konzepte bei der Planung Ihrer Strategie für zusammenfassende Berichte:

Optionale Schritte

  1. Filter einrichten (optional):
    1. Folgen Sie der Anleitung unter Benutzerdefinierte Regeln mithilfe von Filtern definieren.
    2. Weitere Informationen zu Filtern für aggregierte Berichte finden Sie in der Erläuterung im Abschnitt „Trigger“.

Nicht vergessen: Funktionserkennung

Prüfen Sie vor der Verwendung der API, ob sie auf der Seite nicht mithilfe einer Berechtigungsrichtlinie blockiert wurde. Führen Sie dazu den folgenden Code aus:

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

Wenn diese Prüfung der Featureerkennung den Wert „true“ zurückgibt, ist die API in dem Kontext (auf der Seite) zulässig, in dem die Prüfung ausgeführt wird.

Diese Prüfung allein ist keine Garantie dafür, dass die API auf dieser Seite verwendet werden kann. Möglicherweise hat der Nutzer die API in seinen Browsereinstellungen deaktiviert oder er hat andere Einstellungen, die verhindern, dass die API verwendet werden kann. Aus Datenschutzgründen kann dies nicht programmatisch überprüft werden.

Nächste Schritte

Wenn Sie bereit sind, mit der Implementierung zu beginnen, sehen Sie sich diese Dokumente an:

Einrichtung

Hintergrund

Demos und Tools

Planung

Wenn Sie sich noch in der Planungsphase befinden, schauen Sie sich diese Dokumente an: