Seguimiento de enlaces en Klaviyo: clics en enlaces cortos como métrica personalizada

El seguimiento de enlaces de Klaviyo mediante Elido es del lado del servidor y funciona en un solo sentido: cada clic en uno de tus enlaces cortos se publica en la Events API de Klaviyo como un evento de una métrica personalizada llamada Elido Link Click. El evento incluye el slug y el ID del enlace, el país y el dispositivo, el destino al que se envió al visitante y la hora del clic. La métrica se crea en el primer uso, y puedes representarla en gráficos, filtrarla y crear informes sobre ella como sobre cualquier otra.

Lo que no hace es colocar el clic en el perfil de un suscriptor. Cada evento se identifica mediante un ID anónimo asociado al enlace, así que un enlace en el que hacen clic 4.000 personas aparece en Klaviyo como un perfil anónimo con 4.000 eventos en su cronología. Ese único hecho determina para qué sirve la integración. Voy a recorrer el payload, la configuración, lo que los flujos y segmentos pueden hacer con él y cómo se compara con el seguimiento de clics nativo de Klaviyo.

Si tus enlaces todavía no tienen etiquetas coherentes, corrígelo primero. El artículo fundamental sobre seguimiento de UTMs de principio a fin explica la convención, y Klaviyo solo ve lo que lleva el enlace.

Qué envía Elido a Klaviyo en cada clic

Un clic, un POST. El forwarder llama a https://a.klaviyo.com/api/events/ con tu clave privada en el encabezado Authorization: Klaviyo-API-Key y un encabezado revision: 2023-02-22. Este es el endpoint documentado en la referencia Create Event de Klaviyo.

Este es el cuerpo completo, con valores de ejemplo:

{
  "data": {
    "type": "event",
    "attributes": {
      "time": "2026-09-21T09:14:22Z",
      "properties": {
        "workspace_id": 12,
        "link_id": 4711,
        "slug": "autumn-drop",
        "country": "DE",
        "device": "mobile",
        "destination": "https://shop.example/autumn?utm_source=instagram",
        "ip": "203.0.113.24"
      },
      "metric": {
        "data": {
          "type": "metric",
          "attributes": { "name": "Elido Link Click" }
        }
      },
      "profile": {
        "data": {
          "type": "profile",
          "attributes": { "anonymous_id": "elido-link-4711" }
        }
      }
    }
  }
}

Eso es todo. No incluye correo electrónico, número de teléfono, campos UTM como propiedades separadas, referente ni navegador.

Algunos detalles importan cuando empiezas a filtrar. destination es la URL que recibió realmente este visitante, después de cualquier regla de enrutamiento de enlaces inteligentes, así que un enlace que envía los iPhone a la App Store y a todos los demás a tu tienda produce dos valores de destination. device es uno de mobile, tablet o desktop. Las etiquetas UTM solo existen dentro de la cadena destination, así que no es posible filtrar directamente por utm_campaign; filtra por slug, que normalmente es una clave más limpia de todos modos.

Los crawlers que se identifican en su user agent se descartan en la redirección y nunca se reenvían. Los clics que las heurísticas propias de Elido marcan como sospechosos sí se envían, y el evento no incluye ninguna propiedad que lo indique.

Un perfil anónimo por enlace y por qué

Cada evento de Klaviyo tiene que indicar un perfil, identificado por un correo electrónico, un número de teléfono, un ID externo, un ID de Klaviyo o un anonymous_id. Elido siempre envía el último, formado por elido-link- más el ID del enlace.

Así que cada clic en autumn-drop llega al mismo perfil. El primer clic lo crea y todos los siguientes se añaden a su cronología.

Esto tiene tres consecuencias, y la tercera me sorprendió.

Primero, los recuentos funcionan y las personas son desconocidas. Funcionan los clics totales, los clics por enlace, por país y por dispositivo. Todo lo que sea "único" cuenta enlaces, no personas.

Segundo, el perfil anónimo no tiene correo electrónico ni teléfono. Puede estar en un segmento, pero no puede recibir un mensaje.

Tercero, los clics del mismo segundo se agrupan. El forwarder no envía un unique_id, y la referencia de Klaviyo indica que, sin uno, deduplica según la hora del evento hasta el segundo, para el mismo perfil y métrica. Como el perfil es por enlace, dos personas que hacen clic en el mismo enlace dentro del mismo segundo se convierten en un solo evento. En un enlace de newsletter que recibe clics poco a poco, nunca lo notarás. En un enlace de una story grande de Instagram, donde llegan varios clics por segundo en el pico, el recuento de Klaviyo quedará por debajo del recuento de tus analíticas de clics de Elido. La ventaja es que el único reintento del forwarder no puede duplicar el recuento, porque un evento reintentado tiene la misma hora.

¿Por qué no usar un ID por visitante? La redirección no sabe quién es el visitante, y prefiero que no deje una cookie en un dominio que el visitante nunca eligió visitar. Es la misma decisión que tomamos para el seguimiento de enlaces en Mixpanel, donde distinct_id es por enlace por la misma razón.

Configurar el seguimiento de enlaces de Klaviyo en Elido

La configuración consiste en un campo.

1. En Klaviyo, ve a Settings, después a API keys, y crea una clave de API privada. La referencia Create Event indica events:write como el alcance que necesita. Las notas de configuración dentro de la aplicación de Elido también mencionan profiles:write; empezaría solo con events y añadiría el segundo si Klaviyo devuelve 403.
2. En tu workspace de Elido, abre Integrations, elige la tarjeta de Klaviyo y haz clic en Connect Klaviyo.
3. Pega la clave en Private API Key y guarda. Elido la cifra en reposo y después solo la muestra enmascarada.
4. Espera unos cinco minutos. La configuración de la integración se almacena en caché en el lado del forwarding, así que es posible que los primeros clics posteriores al guardado no se envíen.
5. Haz clic en uno de tus propios enlaces desde un teléfono, abre después Analytics > Metrics en Klaviyo y busca Elido Link Click.

El botón Test connection publica un evento de prueba (marcado como elido_test: true) en Klaviyo y muestra la respuesta de Klaviyo, así que una clave revocada o de solo lectura falla en ese momento. Demuestra que la clave funciona, no que la métrica llega al perfil que esperas. Que la métrica aparezca en Klaviyo después de un clic real es la prueba.

No hay un interruptor por enlace. Se reenvía cada clic del workspace, incluidos los enlaces que nunca pensaste usar para marketing. Las agencias que gestionan muchos clientes deberían dar a cada cliente su propio workspace antes de conectar nada.

Seguimiento de clics nativo de Klaviyo frente a la métrica de Elido

Klaviyo ya registra los clics en sus propios correos y mensajes de texto, y para el trabajo a nivel de suscriptor ese seguimiento nativo gana. Reescribe cada enlace mediante su dominio de seguimiento, registra Clicked Email o Clicked SMS en el perfil del destinatario y marca los escáneres probables con una propiedad Bot Click que puedes excluir de los informes.

La métrica de Elido resulta útil en todos los demás lugares: el enlace de la biografía de Instagram, un código QR en un embalaje, un enlace que un socio envía desde su propia newsletter o un enlace en las notas de un podcast. Ninguno de esos clics pasa por el rastreador de Klaviyo. Con el forwarder activado, aparecen en la misma cuenta que las métricas de correo, así que un dashboard de Klaviyo puede colocar "hizo clic en el enlace de otoño desde cualquier lugar" junto a "hizo clic en el correo de otoño".

Hay una interacción que debes vigilar. En los correos activos, Klaviyo añade un parámetro _kx a cada enlace para que su script en el sitio pueda identificar a la persona que hizo clic en tu web. Si el enlace de tu correo es un enlace corto de Elido, _kx llega a la URL corta, y la redirección de Elido no transfiere los parámetros de consulta entrantes al destino. Se pierde la identificación en el sitio. Mi regla: dentro de los correos de Klaviyo, enlaza directamente a tu propio sitio y deja que Klaviyo lo rastree; usa enlaces cortos para los canales a los que Klaviyo no puede llegar.

Llevar los clics a perfiles de suscriptores reales

A veces sí quieres que el clic quede asociado a una persona. Hoy funcionan dos formas, y ninguna de ellas es el forwarder.

La sencilla es dejar que el seguimiento en el sitio de Klaviyo se encargue de la identidad. Envía el enlace corto compartido a un destino con etiquetas UTM y asegúrate de que el JavaScript de Klaviyo se ejecuta en esa página. Los visitantes que ya tienen una cookie de un clic anterior en un correo, o que se registran mediante un formulario, consiguen que su actividad en el sitio se asocie a su perfil. El clic en el enlace corto sigue siendo anónimo; la visita posterior no. Después comparas ambos datos a nivel de campaña, que es más general que por persona, pero representa honestamente lo que sabe cada lado.

La más compleja consiste en usar enlaces por destinatario. Para una lista pequeña y de alto valor, como una secuencia B2B o invitaciones VIP, crea un enlace corto por persona mediante la API en /v1/workspaces/{workspace_id}/links y conserva tu propia tabla de ID de enlace y correo electrónico. Suscríbete a eventos de enlaces mediante webhooks, busca el correo cuando llegue un clic y publica tu propio evento en Klaviyo usando ese correo como identificador del perfil. Son quizá cuarenta líneas de código, y es la única vía que coloca un clic de Elido en un suscriptor identificado. Yo no lo haría para una newsletter de 200.000 personas.

Si echabas de menos los recuentos de clics de varios canales dentro de Klaviyo, elige un plan y conecta un workspace, y dirige tu próxima campaña social mediante enlaces de marca.

Límites actuales del forwarder

Hay cinco cosas que debes saber antes de basar un informe en él.

La entrega se hace con el mejor esfuerzo. Un POST fallido se reintenta una vez después de un segundo, luego se descarta y no se pone nada en cola para más tarde.

La Events API tiene un rate limit por cuenta, de 350 solicitudes por segundo en ráfagas y 3.500 por minuto de forma sostenida. Ese presupuesto se comparte con cualquier otra aplicación que escriba eventos en tu cuenta. Un pico de campaña superior a unos 58 clics por segundo, mantenido durante un minuto, recibirá respuestas 429, y después del único reintento esos clics desaparecerán de Klaviyo.

El encabezado de revisión es antiguo. Klaviyo mantiene cada revisión de la API durante dos años antes de retirarla, y las solicitudes a una revisión retirada son atendidas por la siguiente más antigua disponible. La revisión 2023-02-22 ya ha superado ese plazo, así que hoy el forwarder funciona mediante fall-forward. Funciona. Aun así, me gustaría que se actualizara el encabezado.

La IP del visitante se envía como una propiedad del evento. Espera que se almacene como cualquier otra propiedad, así que trátala como dato personal en tus registros de actividades de tratamiento. La guía de residencia de datos de la UE para equipos de marketing explica cómo valorar esta cuestión.

Solo clics. Las conversiones no forman parte del payload, así que registra los ingresos donde vive la identidad del cliente, que para la mayoría de las tiendas es la propia integración de comercio electrónico de Klaviyo.

Relacionado en el blog

• Seguimiento de UTMs de principio a fin - la convención de etiquetado de la que depende la unión a nivel de campaña.
• Seguimiento de enlaces en Mixpanel - el mismo patrón de forwarder, con la misma identidad por enlace.
• Webhooks para eventos de enlaces - el componente básico para los eventos de clic por destinatario.
• Atribución de clics en correos para Mailchimp, Brevo y Klaviyo - una visión más amplia de las plataformas de correo electrónico.
• Clics en enlaces cortos frente a sesiones de GA4 - por qué los recuentos de clics y las sesiones de analítica nunca coinciden.
• Monitorización de URL con Datadog - el mismo forwarder de clics, enviando datos a un dashboard de Datadog.