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. Für Zusammenfassungsberichte ist eine Einbindung in den Zusammenfassungsdienst erforderlich. Berichte auf Ereignisebene hingegen 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 Berichtstyp für die Attribution Reporting API und die Private Aggregation API. Ein Zusammenfassungsbericht enthält aggregierte Nutzerdaten und kann detaillierte Conversion-Daten mit Rauschen enthalten. Zusammenfassende Berichte bestehen aus zusammengefassten Berichten. Sie bieten mehr Flexibilität und ein umfangreicheres Datenmodell als Berichte auf Ereignisebene, insbesondere für einige Anwendungsfälle wie Conversion-Werte.

Implementierung

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

Für eine bestimmte Ereignisquelle ist es möglich, sowohl ein und einen aggregierten Bericht. Die In der Demo findest du eine Schritt-für-Schritt-Anleitung.

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): <ph type="x-smartling-placeholder">
      </ph>
    1. Folgen Sie dazu der Anleitung unter Benutzerdefinierte Regeln mithilfe von Filtern definieren
    2. Details zu Filtern für aggregierbare Berichte finden Sie in im Trigger-Abschnitt des Erklärung.

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 über die 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: