Skip to main content
POST
Send server-side event
Utilisez ce point de terminaison pour déclarer une seule conversion venue du backend. Pour envoyer plusieurs événements dans une même requête, utilisez POST /server-events/batch. Générez la X-API-Key nécessaire depuis votre site de suivi : Analyses → Suivi des conversions → Configurer le suivi des conversions, puis Configuration du suivi → Suivre via l’API sur votre site. Voir Envoyer des événements serveur pour des exemples de code en Node.js, Python, PHP et cURL.

Autorisations

X-API-Key
string
header
requis

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

Corps

application/json
site_id
string
requis

Tracking site ID

Required string length: 1 - 64
event_name
string
requis

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

Options disponibles:
granted,
denied,
pending

Réponse

Event accepted

success
boolean
requis
Exemple:

true

event_id
string<uuid>
requis
message
string
requis
Exemple:

"Event received"