Seguimiento con píxel | Convertmax Docs

Usa los endpoints de píxel cuando necesites enviar eventos de Convertmax desde entornos donde una simple solicitud GET es más fácil que ejecutar JavaScript.

Para el modelo completo de eventos y los nombres de evento admitidos, consulta Seguimiento de eventos.

Endpoints admitidos

Convertmax admite ambas rutas de estilo píxel:

GET /px/<event_type>
GET /pixel

Ambas devuelven un GIF transparente de 1x1 después de que el evento se acepta.

Autenticación

Las solicitudes enviadas al host compartido de Convertmax admiten cualquiera de estos parámetros de query:

key=<api_key>

Para hosts de píxel personalizados con marca propia como https://t.acme.com, Convertmax puede inferir la cuenta a partir del mapeo del host, por lo que no se requiere una clave pública en la solicitud del píxel.

Campos de query comunes

Puedes pasar datos del evento directamente en la query string:

visitor o uid para el ID del visitante
session_id o sid para el ID de sesión
e para el nombre del evento en /pixel
data.page, data.title, u otros campos anidados data.*
properties.* para propiedades personalizadas anidadas
gclid, fbclid, msclk, ttclid, y otros identificadores de clic

Convertmax también acepta un payload data codificado en base64 para los casos en los que sea más fácil empaquetar el evento en un solo parámetro.

Normalización de nombres de evento

Las solicitudes de píxel normalizan automáticamente algunos alias comunes:

page se convierte en page_view
pageview se convierte en page_view
purchase se convierte en convert
add_to_cart se convierte en add_cart
t se convierte en custom

Ejemplo básico de baliza

<img
  src="https://event.convertmax.io/px/page_view?key=<api_key>&visitor=visitor_123&session_id=session_abc&data.page=https%3A%2F%2Fexample.com%2Flanding"
  alt=""
  height="1"
  width="1"
/>

Ejemplo corto con `/pixel`

<img
  src="https://event.convertmax.io/pixel?key=<api_key>&e=pageview&uid=visitor_123&sid=session_abc"
  alt=""
  height="1"
  width="1"
/>

Ejemplo de payload en base64

<img
  src="https://event.convertmax.io/px/convert?key=<api_key>&data=eyJ2aXNpdG9yIjoidmlzaXRvcl8xMjMiLCJkYXRhIjp7InBhZ2UiOiJodHRwczovL2V4YW1wbGUuY29tL2NoZWNrb3V0In19"
  alt=""
  height="1"
  width="1"
/>

Relleno retroactivo del referrer

Si el navegador puede enviar un referrer y quieres que Convertmax lo use como la URL de la página, agrega:

process_headers=true

Cuando esa marca está presente, Convertmax puede rellenar data.page a partir del referrer de la solicitud si no proporcionaste page explícitamente.

Hosts de píxel propios con marca (first-party)

Convertmax puede aceptar solicitudes de píxel en un host con marca propia como:

https://t.acme.com/pixel?e=pageview&uid=123

En estas solicitudes de píxel con marca propia, el worker puede inferir la cuenta a partir del host mismo, por lo que no necesitas incluir key en la URL.

Los dominios de píxel personalizados con marca propia son configurados por el equipo de Convertmax para que las solicitudes a tu host de tracking resuelvan automáticamente a la cuenta correcta.

Casos de uso recomendados

plataformas de marketing antiguas que solo admiten URLs de baliza
páginas renderizadas en servidor donde quieres un respaldo sin JavaScript
recolección propia (first-party) en subdominios con marca propia
pings ligeros de vista de página y conversión desde entornos restringidos