Conectar Mixpanel ao Elido

O Elido envia eventos de clique e conversão para o Mixpanel no lado do servidor. Se você já usa o Mixpanel para rastrear o comportamento dos usuários, adicionar eventos do Elido oferece o engajamento dos links na mesma análise de funil — sem JavaScript no lado do cliente.

O que você precisa#

• Um projeto Mixpanel.
• O Project Token do projeto (não é segredo — é seguro colá-lo aqui).

Etapa 1 — Encontre o token do seu projeto#

1. Faça login no Mixpanel.
2. Vá para Settings → Project → Access Keys.
3. Copie o Project Token. É uma string de 32 caracteres. Não confunda com o Secret (usado para importar dados em lote; o Elido usa o endpoint de rastreamento padrão).

Etapa 2 — Configure no Elido#

1. Vá para Dashboard → Conversões → Mixpanel → Configurar encaminhamento.
2. Cole o token do projeto.
3. (Opcional) Escolha quais eventos encaminhar: link.clicked, conversion.recorded ou ambos.
4. Clique em Salvar. O Elido envia um evento de teste imediatamente.

Como o distinct_id é mapeado#

O Mixpanel requer um distinct_id para atribuir eventos a um usuário. O Elido o mapeia da seguinte forma:

1. Se você incluir um parâmetro mixpanel_distinct_id na URL de destino do seu link curto (ou passá-lo para a API de Conversões), o Elido usa esse valor diretamente. Isso proporciona vinculação perfeita de sessão.
2. Caso contrário, o Elido usa um hash do click_id do Elido. Isso cria um ID anônimo estável por clique. Funis que cruzam cliques e eventos do servidor não serão costurados automaticamente — mas a análise por link funcionará corretamente.

Para a maioria dos casos de uso (análise de campanhas de links, atribuição de conversão), a opção 2 é suficiente. Para mapeamento de jornada no nível do usuário, implemente a opção 1.

Propriedades de eventos enviadas ao Mixpanel#

Cada evento do Elido inclui:

{
  "event": "elido_click",
  "properties": {
    "token": "your-project-token",
    "distinct_id": "clk_abc123-hashed",
    "time": 1715515200,
    "link_slug": "spring-2026",
    "destination_url": "https://example.com/spring",
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "spring-2026",
    "country": "DE",
    "device": "mobile",
    "browser": "Chrome"
  }
}

Eventos de conversão também incluem value e currency.

Solução de problemas#

Eventos não aparecendo na visualização ao vivo do Mixpanel — Confirme que o token do projeto está correto. Um token errado retorna HTTP 200 do Mixpanel (aceita silenciosamente), mas o evento nunca aparece. Verifique copiando o token caractere por caractere.

Eventos aparecendo em um projeto diferente — Tokens do Mixpanel são específicos de cada projeto. Se você tem vários projetos, confirme que copiou do projeto correto em Settings → Project.

O distinct_id não corresponde aos usuários existentes no Mixpanel — Você precisa passar o mixpanel_distinct_id na URL de destino do seu link curto do Elido ou via API de Conversões. Sem ele, o Elido gera um ID anônimo que não corresponderá aos seus usuários identificados existentes.

Apenas vendo o evento de teste, não eventos reais — Verifique se os tipos de eventos estão habilitados em Dashboard → Conversões → Mixpanel → Configurar eventos. Tanto link.clicked quanto conversion.recorded podem ser ativados independentemente.