Skip to main content
POST
Send server-side event
Usa este endpoint para informar de una sola conversión del backend. Para enviar varios eventos en una misma petición, usa POST /server-events/batch. Genera la X-API-Key que necesitas desde tu sitio de seguimiento: Análisis → Seguimiento de conversiones → Configurar el seguimiento de conversiones y luego Configuración de seguimiento → Rastrear vía API en tu sitio. Consulta Enviar eventos de servidor para ver ejemplos de código en Node.js, Python, PHP y cURL.

Autorizaciones

X-API-Key
string
header
requerido

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

Cuerpo

application/json
site_id
string
requerido

Tracking site ID

Required string length: 1 - 64
event_name
string
requerido

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

Opciones disponibles:
granted,
denied,
pending

Respuesta

Event accepted

success
boolean
requerido
Ejemplo:

true

event_id
string<uuid>
requerido
message
string
requerido
Ejemplo:

"Event received"