HTTP Attribution-Reporting-Register-Source Header

Der HTTP-Header Attribution-Reporting-Register-Source ist ein Response-Header, mit dem der Server eine Attribution-Source (Ad-Impression oder Click) beim Browser registriert. Ermöglicht spätere Zuordnung von Conversions zu Ad-Interaktionen.

Typ

Response-Header

Syntax

Der Header enthält JSON mit Attribution-Source-Konfiguration.

http 
Attribution-Reporting-Register-Source: {"source_event_id":"123","destination":"https://shop.example"}
Attribution-Reporting-Register-Source: {"source_event_id":"456","destination":"https://app.example","expiry":604800}

Direktiven

Die Direktiven definieren die Attribution-Source im JSON-Format.

source_event_id
Eindeutige ID für die Ad-Impression oder Click-Event (64-bit unsigned integer als String).
destination
URL der Site auf der Conversions erwartet werden. Muss HTTPS sein.
expiry
Optional, Gültigkeit in Sekunden (Standard: 30 Tage, Maximum: 30 Tage).
priority
Optional, Priorität bei mehreren konkurrierenden Sources (Standard: 0).

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für den Attribution-Reporting-Register-Source-Header.

Beispiel 1 Ad Impression Registration

http 
Attribution-Reporting-Register-Source: {"source_event_id":"987654","destination":"https://shop.example.com"}

Server registriert Ad-Impression mit ID 987654, Browser speichert für Conversion-Attribution auf shop.example.com.

Beispiel 2 Click mit Custom Expiry

http 
Attribution-Reporting-Register-Source: {"source_event_id":"123456","destination":"https://app.example.com","expiry":259200,"priority":100}

Click-Source gültig 3 Tage mit hoher Priorität, überschreibt ältere Sources bei Konflikten.

Beispiel 3 Multi-Destination Source

http 
Attribution-Reporting-Register-Source: {"source_event_id":"111222","destination":["https://shop.example.com","https://checkout.example.com"]}

Attribution Source Registration Flow

Attribution Source Registration bei Ad-Impression

Vorteile für die Systemarchitektur

  • Flexible Attribution-Windows: Custom Expiry ermöglicht unterschiedliche Attribution-Zeiträume
  • Prioritäts-Steuerung: Wichtige Touchpoints können höher gewichtet werden
  • Multi-Site-Attribution: Conversion-Tracking über mehrere Advertiser-Domains

Spezifikation

Attribution Reporting API – Privacy Sandbox https://wicg.github.io/attribution-reporting-api/

Weitere Spezifikationen

Attribution-Reporting-Eligible Header, Attribution-Reporting-Register-Trigger Header