Links

Píxel de conversión

Rastrea conversiones en páginas de destino que no controlas, atribuidas al clic original y a la variante A/B correspondiente.

Las pruebas A/B de enlaces cortos pueden enviar visitantes a una página de destino que no controlas: una tienda, un creador de landing pages, el sitio de un socio. Styrar mide el clic y qué variante vio el visitante, pero no tiene forma de saber si ese visitante convirtió después de la redirección.

El píxel de conversión cierra ese ciclo. Es un pequeño script que incrustas en la página de destino y que reporta conversiones a Styrar, correlacionadas con el clic exacto (y la variante A/B) que envió al visitante allí.

Cómo funciona

Cuando un enlace corto redirige a un visitante, Styrar añade un token de un solo uso styrar_ck a la URL de destino.
El script del píxel en esa página lee el token de la URL (o de localStorage, para que sobreviva a navegaciones posteriores en tu sitio) y lo mantiene listo para enviarlo con cualquier evento.
Llamas a window.styrar.track(eventName, data) — o añades un atributo data-styrar-track — cuando un visitante hace algo que vale la pena contar (se registra, finaliza la compra, inicia una prueba).
Styrar resuelve el token de vuelta al enlace original y la variante A/B, y la conversión aparece en el panel de experimentos de ese enlace.

No hay id de cuenta, id de sitio ni clave de API que configurar. El propio token es lo único que vincula un evento a tu espacio de trabajo, y está limitado a un solo clic.

Configurar un píxel de conversión

1. Encuentra tu fragmento de incrustación

Abre el panel Avanzado → Prueba A/B del enlace corto en el panel y inicia (o configura) un experimento. El panel muestra una tarjeta "Rastrear conversiones en la página de destino" con un fragmento listo para copiar:

HTML

<script src="https://api.styrar.com/v1/pixel/styrar.js" async></script>
<!-- mark a conversion -->
<button data-styrar-track="signup">Sign up</button>
<!-- or call it from your own code -->
<script>window.styrar && window.styrar.track('signup', { value: 19.99 })</script>

2. Añade la etiqueta del script a tu página de destino

Pega la etiqueta <script src="…/v1/pixel/styrar.js"> en la página a la que llegan los visitantes tras la redirección del enlace corto, en el <head> o justo antes de </body>. Esto funciona en cualquier plataforma (Shopify, Webflow, un sitio estático, tu propia app) porque el píxel y su endpoint de seguimiento usan una política CORS abierta y sin cookies.

3. Marca una conversión

Elige lo que mejor se adapte a tu página:

Declarativa, sin necesidad de JavaScript propio:

HTML

<button data-styrar-track="signup">Sign up</button>
<form data-styrar-track="checkout_complete">…</form>

Un click dispara el evento en la mayoría de los elementos; en un <form> se dispara en submit en su lugar.

Desde tu propio código, una vez que el script se haya cargado:

HTML

<script>
  window.styrar && window.styrar.track('purchase', { value: 49.99 })
</script>

4. Confirma que funciona

Activa la conversión en la página de destino y luego abre el panel de prueba A/B del enlace: el contador y la tasa de conversión de la variante se actualizan en cuanto llega el evento.

Valores de conversión personalizados

window.styrar.track(eventName, data) acepta cualquier nombre de evento y un objeto data opcional:

HTML

<script>
  window.styrar.track('purchase', {
    value: 49.99,          // numeric — stored as the event's value
    plan: 'pro_annual',    // any other field is stored alongside the event
    currency: 'USD',
  })
</script>

Campo	Tipo	Comportamiento
`eventName`	string	Obligatorio. Hasta 64 caracteres — usa lo que mejor se adapte a tu funnel: `signup`, `add_to_cart`, `purchase`, etc.
`value`	number	Solo se almacena si es un `number` de JS (por ejemplo, el ingreso del pedido). Cualquier otra cosa se ignora.
cualquier otro campo en `data`	cualquier valor JSON	Se almacena junto con el evento (hasta 4 KB serializados). Los payloads más grandes se descartan, no se truncan.

No hay un esquema que registrar de antemano: llama a track() con la forma que tenga sentido para tu página, y se conservará junto con el evento.

Reportar conversiones desde tu servidor

Si la conversión ocurre del lado del servidor (un webhook de tu proveedor de pagos, por ejemplo) en lugar de en el navegador, lee el parámetro styrar_ck de la solicitud original y publícalo directamente:

RequestPOST

Content-Type: application/json

{
  "clickToken": "the styrar_ck value",
  "eventName": "purchase",
  "value": 49.99
}

Response200 OK

{
  "ok": true
}

Esta es la misma solicitud sin autenticación que hace el píxel del navegador. No hay clave de API: el clickToken está limitado a un solo uso por clic y no es enumerable, por lo que también funciona como credencial.

Referencia de la API

Plain text

GET  /v1/pixel/styrar.js   # the embeddable script, no auth required
POST /v1/pixel/track        # records a conversion event, no auth required

Cuerpo de POST /v1/pixel/track:

Campo	Requerido	Descripción
`clickToken`	Sí	El valor de `styrar_ck` de la URL de destino o de `localStorage`
`eventName`	Sí	Hasta 64 caracteres
`value`	No	Número, por ejemplo el valor del pedido
`eventData`	No	Objeto JSON arbitrario, hasta 4 KB serializados
`pageUrl`	No	Hasta 2048 caracteres; el script envía `window.location.href` automáticamente

El endpoint siempre responde 200 { "ok": true }, incluso para un clickToken no reconocido o caducado, de modo que el píxel nunca muestra un error en una página que no controlas por completo.

Privacidad y seguridad

El píxel envía solo el token de clic, el nombre/valor/datos del evento que le pasas y la URL de la página actual. No intervienen cookies, fingerprinting ni identificadores entre sitios.
/v1/pixel/track tiene límite de tasa por IP (120 solicitudes/minuto) para absorber abusos sin afectar el tráfico normal.
clickToken es un identificador aleatorio limitado a un solo uso: no se puede adivinar a partir del código corto de un enlace ni de ningún otro valor público.

Límites

El seguimiento de conversiones requiere que el enlace tenga configurada una prueba A/B; la conversión se atribuye a la variante que vio el visitante en el momento del clic.
No hay seguimiento automático de páginas vistas: el píxel solo reporta los eventos que activas explícitamente, para mantener bajo el ruido y el volumen de solicitudes.
Aún no hay endpoint de exportación o eliminación masiva para eventos de conversión; contáctanos si necesitas que se eliminen datos de un espacio de trabajo específico.

Relacionado

Webhooks — recibe notificaciones cuando se completa una prueba A/B mediante link.experiment.completed
Enlaces cortos y códigos QR en el centro de ayuda
Rastreadores de la página de bio — Google Analytics, Meta, GTM y más en tu página de bio
Instalar este píxel por plataforma: Shopify · WordPress · Wix · Framer · Del lado del servidor