Erste Schritte mit Attributionsberichten

Hier erfahren Sie, wo Sie anfangen sollten. Dazu gehören auch die Einrichtung und eine kurze Übersicht.

Berichtstyp auswählen

Mit der Attribution Reporting API können Sie zwei Arten von Berichten erstellen: Berichte auf Ereignisebene und Zusammenfassungsberichte. Berichte auf Ereignisebene erfordern weniger Einrichtung als aggregierte Berichte oder zusammenfassende Berichte und sind daher ein guter Ausgangspunkt. Zusammenfassungsberichte müssen in den Zusammenfassungsdienst eingebunden werden, Berichte auf Ereignisebene nicht.

Sie können Berichte sowohl für Berichte auf Ereignisebene als auch für zusammenfassende Berichte einrichten. Sie ergänzen sich.

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

Sie können beginnen, indem Sie die folgenden Schritte ausprobieren.

Für eine bestimmte Ereignisquelle ist es möglich, sowohl einen Bericht auf Ereignisebene als auch einen aggregierten Bericht zu generieren. Die Demo führt Sie durch den Prozess.

Berichterstellung auf Ereignisebene

Führen Sie mindestens die folgenden Schritte aus, um Berichte auf Ereignisebene zu erstellen:

  1. Quelle registrieren Eine Anleitung finden Sie unter Attributionsquellen registrieren. Die Schritte unterscheiden sich für Klicks und Aufrufe.

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

  3. Richten Sie einen Endpunkt ein mit der folgenden URL:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution.
    Im Beispielcode in adtech.js finden Sie Informationen zur Methode POST und in Wikipedia weitere Informationen zu .well-known.

Weitere Informationen finden Sie in der Erläuterung zu Berichten auf Ereignisebene.

Zusammenfassungsbericht erstellen

Gehen Sie wie folgt vor, um Zusammenfassungsberichte zu erstellen:

  1. Quelle registrieren Eine Anleitung finden Sie unter Attributionsquellen registrieren. Die Schritte unterscheiden sich für Klicks und Aufrufe. Weitere Informationen finden Sie unter Attributionsquelle registrieren.

  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 Informationen zur Methode POST und in Wikipedia weitere Informationen zu .well-known.

  4. Erstellen Sie Berichte im Batch und senden Sie sie zur weiteren Verarbeitung durch den Aggregationsdienst, der zusammenfassende Berichte erstellt. Weitere Informationen finden Sie unter Zusammengefasste aggregierte Berichte.

Weitere Informationen finden Sie in der Erläuterung zu aggregierten Berichten.

Weitere Informationen zum Einrichten von Fehlerbehebungsberichten finden Sie in der Reihe zur Fehlerbehebung für Attributionsberichte.

Zusammenfassungsberichte – zusätzliche Konzepte

Zusätzlich zu den hier aufgeführten Implementierungsschritten helfen Ihnen die folgenden Konzepte bei der Planung Ihrer zusammenfassenden Berichterstellungsstrategie:

Optionale Schritte

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

Funktionserkennung nicht vergessen

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 Funktionserkennung den Wert „true“ zurückgibt, wird die API in dem Kontext (Seite) zugelassen, in dem die Prüfung ausgeführt wird.

Beachten Sie, dass diese Prüfung allein keine Garantie dafür ist, dass die API auf dieser Seite verwendet werden kann. Der Nutzer hat die API möglicherweise in seinen Browsereinstellungen deaktiviert oder die API kann aufgrund anderer Einstellungen nicht verwendet werden. Aus Datenschutzgründen gibt es keine Möglichkeit, dies programmatisch zu überprüfen.

Nächste Schritte

Wenn Sie bereit sind, mit der Implementierung zu beginnen, lesen Sie diese Dokumente:

Einrichtung

Hintergrund

Demos und Tools

Planung

Wenn Sie sich noch in der Planungsphase befinden, werfen Sie einen Blick in diese Dokumente: