Eventos

Un evento que tu servidor vio —un lead calificado, una venta cerrada fuera del sitio— atado al visitante que tu Datil Pixel ya sigue ( user.anonymous_id , el identificador del píxel en el navegador). Se registra una vez por event_id ; el correo y el teléfono se guardan solo como SHA-256 y solo con el consentimiento del visitante.

Enviar un evento#

POST /api/v1/events Bearer

Registra el evento. Repetir el mismo event_id responde 200 con duplicate: true .

Content-Type: application/json

Cuerpo de la solicitud

event_id string requerido

Tu identificador del evento, único.

event_name string requerido

page_view , view_content , add_to_cart , initiate_checkout , lead , purchase o custom .

custom_name string

Con custom : su nombre.

event_time string

ISO 8601; ahora si falta.

url string

La página del evento, con sus UTM.

user objeto

anonymous_id (el visitante del píxel), email , phone .

context objeto

ip_address , user_agent , gclid , fbclid , fbc , fbp , utm_* .

value number

El valor del evento.

currency string

ISO 4217.

order_id string

El pedido de una venta.

offering_id string

La oferta: su id o su clave.

consent objeto

ad_storage , analytics_storage , ad_user_data , ad_personalization : granted o denied ; sin ellos, la configuración de tu píxel.

Devuelve · 201 con el evento · 200 con duplicate: true · 422 con errors .

cURL

curl -X POST https://edge.datil.com/api/v1/events \
  -H "Authorization: Bearer $DATIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "event_id": "lead_8f21c0",
  "event_name": "lead",
  "event_time": "2026-09-27T14:32:11Z",
  "url": "https://tienda.example/cotizar?utm_source=fb",
  "user": {
    "anonymous_id": "dpx.1.k3j9x2m1p8q4",
    "email": "ana@example.com"
  },
  "context": {
    "ip_address": "203.0.113.42",
    "user_agent": "Mozilla/5.0"
  }
}'

Respuesta · 201

{
  "object": "event",
  "event_id": "lead_8f21c0",
  "received": 1,
  "duplicate": false
}

Enviar un evento#

Cookies