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

事件级报告：将（广告端）的特定广告点击或观看与转化端数据相关联。为了通过限制跨网站联接用户身份来保护用户隐私，转化端数据非常有限，并且数据非常嘈杂。

Zusammenfassende Berichte

摘要报告是一种 Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，摘要报告具有更大的灵活性和数据模型，尤其是对于某些应用场景（例如转化价值）。

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: