Conectar Mixpanel a Elido

Elido envía un evento link_click a la API de ingesta de Mixpanel cada vez que alguien hace clic en uno de tus enlaces cortos. Si tu equipo ya trabaja en Mixpanel, la interacción con los enlaces aparece junto a los eventos de tu producto sin añadir un script de seguimiento en ningún sitio.

Solo se reenvían los clics. El reenvío de eventos de conversión a Mixpanel está planificado.

Lo que necesitas

• Un proyecto de Mixpanel.
• El Project Token del proyecto. En el modelo de Mixpanel no es un secreto, pero Elido lo almacena cifrado.
• Saber cuál es la residencia de datos de tu proyecto: US, EU o India.
• El rol Admin o Owner en tu workspace de Elido (el permiso conversions.manage).

Paso 1: Busca el token y la residencia de tu proyecto

1. Inicia sesión en Mixpanel y abre Settings → Project Settings.
2. En Access Keys, copia el Project Token. No uses el API Secret ni una cuenta de servicio; Elido no los necesita.
3. Comprueba el valor de Data Residency del proyecto. Elegirás el mismo en Elido.

Paso 2: Conecta en Elido

1. Ve a Dashboard → Integrations → Mixpanel.
2. Haz clic en Connect Mixpanel.
3. Pega el token en Project Token.
4. Configura Data residency para que coincida con tu proyecto:
   • United States envía a api.mixpanel.com (el valor predeterminado).
   • EU envía a api-eu.mixpanel.com.
   • India envía a api-in.mixpanel.com.
5. Haz clic en Save. El panel ahora muestra Connected y el token ocultando todos los caracteres salvo los cuatro primeros y los cuatro últimos.

El reenvío cubre todos los enlaces del workspace; no hay un interruptor por enlace. Comienza aproximadamente 5 minutos después de guardar, y un token o una residencia modificados, o una desconexión, surten efecto dentro del mismo plazo.

Paso 3: Prueba la conexión

Haz clic en Test connection. Elido envía un evento link_click con elido_test: true y el slug _test, y muestra la respuesta de Mixpanel debajo del botón: el estado HTTP, el host al que se envió y el cuerpo de la respuesta.

Que la prueba pase no es una confirmación. El endpoint /track de Mixpanel no comprueba si el token es válido ni si el proyecto reside en esa región, así que un token incorrecto o una región incorrecta también pueden superar la prueba. En cambio, un fallo sí es real: Mixpanel rechazó el evento y el mensaje explica el motivo.

Qué envía Elido

Cada clic se convierte en un evento:

{
  "event": "link_click",
  "properties": {
    "token": "your-project-token",
    "distinct_id": "elido-link-4711",
    "time": 1789000000,
    "workspace_id": 42,
    "link_id": 4711,
    "slug": "spring-26",
    "destination": "https://example.com/spring",
    "country": "DE",
    "device": "mobile",
    "ip": "203.0.113.7"
  }
}

• distinct_id es elido-link- más el ID del enlace, por lo que es un valor por enlace, no por visitante.
• time es la hora del clic en segundos Unix.
• destination es la URL a la que se envió al visitante.
• country es un código de país de dos letras y device, el tipo de dispositivo.
• ip es la dirección IP del visitante; Mixpanel la usa para su propia geolocalización.
• El evento de prueba añade elido_test: true.

Se reenvía cada clic registrado, incluidos los clics que los análisis de Elido marcan como sospechosos o como tráfico de bots. Si Mixpanel no está disponible, Elido reintenta una vez después de un segundo y luego descarta ese evento; no hay cola pendiente ni replay. Para consultar un recorrido campo por campo e ideas para informes, visita Eventos link_click de Mixpanel.

Cómo funciona distinct_id y cuáles son sus límites

Como distinct_id corresponde a cada enlace, cada clic en el mismo enlace cuenta como el mismo "usuario" de Mixpanel. Eso significa lo siguiente:

• Los Uniques de link_click cuentan enlaces, no personas. Usa el recuento total de eventos.
• Los embudos de link_click a tu evento de registro o compra no se relacionarán, porque esos eventos pertenecen a un distinct_id diferente.
• El límite de hot-shard de Mixpanel se aplica por distinct_id, así que el primer enlace afectado sería uno con mucha actividad.

Para seguir hoy a una persona desde el clic hasta el registro, añade etiquetas UTM a la URL de destino y deja que el SDK de Mixpanel de tu página de destino las capture; después identifica allí al usuario como lo harías normalmente.

Solución de problemas

La prueba de Test connection pasa, pero no aparece nada en Mixpanel. Comprueba primero el token: vuelve a copiarlo desde Settings → Project Settings → Access Keys. Después compara Data residency con la configuración del proyecto. Ambos errores superan la prueba, como se explicó arriba.

La prueba de Test connection falla. Lee el error y el cuerpo de la respuesta debajo del botón; provienen directamente de Mixpanel. Corrige el token o la residencia, haz clic en Update key, guarda y vuelve a probar.

Los eventos llegan al proyecto equivocado. Los tokens son específicos de cada proyecto. Si tienes varios, asegúrate de haber copiado el token del proyecto que querías.

Los clics reales no aparecen justo después de conectar. El reenvío puede tardar aproximadamente 5 minutos en comenzar. Haz clic en un enlace corto después de ese plazo y revisa la vista Events.

Los usuarios de Mixpanel no coinciden con tus usuarios identificados. Es lo esperado: el distinct_id de Elido corresponde a cada enlace. Consulta la sección anterior para conocer la solución mediante UTM.