Conectar o Mixpanel ao Elido

O Elido envia um evento link_click para a API de ingestão do Mixpanel cada vez que alguém clica em um dos seus links curtos. Se sua equipe já trabalha com o Mixpanel, o engajamento com os links aparece junto dos eventos do seu produto, sem adicionar um script de rastreamento em nenhum lugar.

Apenas cliques são encaminhados. O encaminhamento de eventos de conversão para o Mixpanel está planejado.

O que você precisa

• Um projeto do Mixpanel.
• O Project Token do projeto. Ele não é um segredo no modelo do Mixpanel, mas o Elido ainda o armazena criptografado.
• Saber a residência de dados do seu projeto: US, EU ou India.
• A função Admin ou Owner no seu workspace do Elido (a permissão conversions.manage).

Etapa 1: encontre o token e a residência do seu projeto

1. Faça login no Mixpanel e abra Settings → Project Settings.
2. Em Access Keys, copie o Project Token. Não use o API Secret nem uma conta de serviço; o Elido não precisa deles.
3. Verifique o valor de Data Residency do projeto. Você escolherá o mesmo valor no Elido.

Etapa 2: conecte no Elido

1. Vá para Dashboard → Integrations → Mixpanel.
2. Clique em Connect Mixpanel.
3. Cole o token em Project Token.
4. Defina Data residency para corresponder ao seu projeto:
   • United States envia para api.mixpanel.com (o padrão).
   • EU envia para api-eu.mixpanel.com.
   • India envia para api-in.mixpanel.com.
5. Clique em Save. O painel agora mostra Connected e o token mascarado, exibindo apenas os quatro primeiros e os quatro últimos caracteres.

O encaminhamento inclui todos os links do workspace; não há uma opção por link. Ele começa cerca de 5 minutos depois de você salvar, e uma alteração no token ou na residência, assim como uma desconexão, entra em vigor dentro desse mesmo intervalo.

Etapa 3: teste a conexão

Clique em Test connection. O Elido envia um evento link_click com elido_test: true e o slug _test, e mostra a resposta do Mixpanel abaixo do botão: o status HTTP, o host para o qual fez o envio e o corpo da resposta.

Um teste aprovado não é uma prova. O endpoint /track do Mixpanel não verifica se o token é válido nem se o projeto está nessa residência, então um token incorreto ou a região errada ainda podem passar. Uma falha, por outro lado, é real: o Mixpanel rejeitou o evento, e a mensagem explica o motivo.

O que o Elido envia

Cada clique se torna um 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 é elido-link- seguido pelo ID do link, então é um valor por link, não por visitante.
• time é o horário do clique em segundos Unix.
• destination é a URL para a qual o visitante foi enviado.
• country é um código de país de duas letras e device, o tipo de dispositivo.
• ip é o endereço IP do visitante; o Mixpanel o usa para sua própria geolocalização.
• O evento de teste adiciona elido_test: true.

Cada clique registrado é encaminhado, inclusive os cliques que as análises do Elido classificam como tráfego suspeito ou de bots. Se o Mixpanel estiver inacessível, o Elido faz uma nova tentativa após um segundo e então descarta o evento; não há backlog nem replay. Para uma explicação campo a campo e ideias de relatórios, consulte Mixpanel link_click events.

Como o distinct_id funciona e quais são seus limites

Como distinct_id é definido por link, cada clique no mesmo link conta como o mesmo "usuário" no Mixpanel. Isso significa que:

• Uniques em link_click contam links, não pessoas. Use a contagem total de eventos.
• Os funis de link_click até seu evento de cadastro ou compra não vão se conectar, porque esses eventos pertencem a um distinct_id diferente.
• O limite de hot shard do Mixpanel se aplica por distinct_id, então um único link muito movimentado é o primeiro lugar em que isso causaria impacto.

Para acompanhar uma pessoa do clique até o cadastro hoje, coloque tags UTM na URL de destino e deixe o SDK do Mixpanel na sua landing page capturá-las; depois identifique o usuário ali, como você faria normalmente.

Solução de problemas

Test connection é aprovado, mas nada aparece no Mixpanel. Verifique primeiro o token: copie-o novamente em Settings → Project Settings → Access Keys. Depois confira Data residency em relação à configuração do projeto. Os dois erros passam no teste, como explicado acima.

Test connection falha. Leia o erro e o corpo da resposta abaixo do botão; eles vêm diretamente do Mixpanel. Corrija o token ou a residência, clique em Update key, salve e teste novamente.

Os eventos chegam ao projeto errado. Os tokens são por projeto. Se você tiver vários, certifique-se de ter copiado o token do projeto pretendido.

Os cliques reais não aparecem logo após a conexão. O encaminhamento pode levar cerca de 5 minutos para começar. Clique em um link curto depois disso e verifique a visualização Events.

Os usuários do Mixpanel não correspondem aos usuários identificados. Isso é esperado: o distinct_id do Elido é definido por link. Consulte a seção acima para ver a solução alternativa com UTM.