Skip to main content
POST
Send server-side event
Mit diesem Endpunkt melden Sie eine einzelne Konversion aus dem Backend. Für mehrere Ereignisse in einer Anfrage nutzen Sie POST /server-events/batch. Den nötigen X-API-Key erzeugen Sie bei Ihrer Tracking-Website: Analysen → Konversionsverfolgung → Konversionsverfolgung einrichten, dann Tracking-Einrichtung → Über API verfolgen. Codebeispiele in Node.js, Python, PHP und cURL finden Sie unter Server-Ereignisse senden.

Autorisierungen

X-API-Key
string
header
erforderlich

Site-scoped server API key generated from Dashboard > Analytics > Conversion Tracking > Script/API > API tab

Body

application/json
site_id
string
erforderlich

Tracking site ID

Required string length: 1 - 64
event_name
string
erforderlich

Event name (normalized to lowercase/underscore by API)

Required string length: 1 - 64
scan_session_id
string<uuid>

QR scan session id from scnv redirect

event_id
string<uuid>

Unique event ID for deduplication

event_time
string<date-time>

Event occurrence time

user_identifiers
object
conversion_value
object
properties
object

Custom properties. Max serialized size 10KB. Do not include raw email addresses.

Consent signal propagated from browser-side tracking

Verfügbare Optionen:
granted,
denied,
pending

Antwort

Event accepted

success
boolean
erforderlich
Beispiel:

true

event_id
string<uuid>
erforderlich
message
string
erforderlich
Beispiel:

"Event received"