Rastreamento de link no Mixpanel: cliques em link curto como eventos

O rastreamento de link no Mixpanel pelo Elido é do lado do servidor e unidirecional: toda vez que alguém clica em um dos seus links curtos, o Elido posta um evento link_click para o endpoint de rastreamento do Mixpanel com o token do seu projeto. O evento carrega o slug do link, o ID do link, o país e dispositivo do visitante, o destino para onde ele foi enviado, e um timestamp. Nada roda no navegador do visitante, então bloqueadores de anúncio e banners de consentimento não interferem.

A pegadinha é identidade. Cada evento é chaveado ao link, não à pessoa, o que significa que você pode contar e segmentar cliques no Mixpanel o dia todo, mas não consegue seguir quem clicou até dentro do seu produto a partir só desse evento. Vou mostrar para que serve, como configurar, como conferir na visão de Events, e os lugares onde eu recorreria a outra coisa.

Se você ainda está decidindo o que marcar antes de qualquer coisa disso, o guia principal sobre rastrear UTMs de ponta a ponta é o melhor ponto de partida. O Mixpanel só vê o que o link carrega.

O que o Elido envia ao Mixpanel em cada clique

Um clique, um evento. O encaminhador monta um lote de um único evento e faz um POST para /track no host de ingestão correspondente à configuração de Data residency da integração (api.mixpanel.com para US, api-eu.mixpanel.com para EU, api-in.mixpanel.com para India), autenticado pelo token dentro das properties, que é como a API de ingestão do Mixpanel espera que eventos server-side cheguem.

Aqui está o payload completo, reduzido apenas no valor do token:

[
  {
    "event": "link_click",
    "properties": {
      "token": "<your project token>",
      "distinct_id": "elido-link-4711",
      "workspace_id": 12,
      "link_id": 4711,
      "slug": "spring-26",
      "country": "DE",
      "device": "mobile",
      "destination": "https://shop.example/spring?utm_source=newsletter",
      "time": 1790000000,
      "ip": "203.0.113.24"
    }
  }
]

Isso é tudo. Lista curta, e de propósito.

Dois detalhes que vale saber. O destination é o resolvido, então se um smart link manda iPhones para a App Store e todo mundo mais para o seu site, você vai ver as duas URLs. E as tags de UTM viajam só dentro dessa string de destino; não existem propriedades separadas utm_source ou utm_campaign, então se você quiser elas como colunas vai precisar de uma propriedade derivada no Mixpanel. É a única configuração que eu faria logo no primeiro dia.

Bots óbvios, os crawlers que se anunciam no próprio user agent, são filtrados no redirecionamento e nunca chegam ao Mixpanel.

Configurando a integração com o Mixpanel

A configuração inteira tem dois campos. Para enviar eventos de clique para o Mixpanel você precisa de um projeto Mixpanel e do project token dele, que fica em Project Settings no Mixpanel; o token é uma chave de escrita feita para ser embutida, então colá-la em um fornecedor é normal. Não cole o API secret, que é uma string diferente e não é o que o encaminhador usa.

1. No seu workspace do Elido, abra Integrações e escolha o card do Mixpanel.
2. Clique em Connect Mixpanel, cole o token em Project Token, e escolha Data residency: US (padrão), EU ou India, correspondendo ao valor de Data Residency nas configurações do seu projeto Mixpanel. Salve. O Elido criptografa o token em repouso e nunca o mostra de volta por completo.
3. Espere alguns minutos. As configurações de integração do workspace ficam em cache brevemente do lado do encaminhamento, então os primeiros cliques depois de salvar podem ainda não ser enviados.
4. Clique em um dos seus próprios links a partir de um celular.

Não há um interruptor por link. Uma vez conectado, todo clique no workspace é encaminhado, o que serve para uma equipe que vive no Mixpanel e não serve para um workspace que hospeda links curtos de vinte clientes não relacionados. Se esse é o seu caso, divida os clientes em workspaces separados primeiro.

Conferindo a visão de Events antes de confiar em qualquer coisa

O que o Mixpanel costumava chamar de Live View agora é a visão de Events, embaixo de Data na navegação à esquerda, e o guia de depuração do Mixpanel a recomenda como a primeira parada exatamente para esse trabalho. Abra-a, filtre por link_click, depois toque no seu link curto a partir de um celular que não esteja no Wi-Fi do escritório.

Você deve ver o evento em segundos. Expanda-o e confira três coisas: slug corresponde ao link que você tocou, country é onde o celular realmente está, e a cidade e região do próprio Mixpanel estão preenchidas a partir do ip. Se a cidade mostrar um data center, seu teste passou por uma VPN.

O botão Test connection no painel de integração envia um link_click marcado como elido_test: true e mostra a resposta do Mixpanel embaixo do botão. Útil, mas não é prova: o endpoint de rastreamento do Mixpanel aceita qualquer token e nunca verifica a residência, então um resultado verde com o token errado ou a região errada ainda significa que nada chega ao seu projeto. O evento que você vê chegar de um clique real é a única prova que eu aceitaria.

Por que distinct_id é por link, e o que isso quebra

Aqui está o limite de identidade, dito claramente. distinct_id é elido-link- mais o ID do link, então todo clique em spring-26 pertence a um "usuário" sintético do Mixpanel.

Totais funcionam. Detalhamentos por slug, país, dispositivo e destino funcionam, e tendências ao longo do tempo também. Três coisas quebram:

• Uniques em link_click contam links, não pessoas. Uma campanha com 40.000 cliques em dois links mostra dois usuários únicos.
• Funis que começam em link_click e terminam no seu evento de cadastro não vão se conectar, porque o cadastro pertence a um distinct_id diferente.

Existe uma terceira coisa que a maioria das equipes nunca encontra. O Mixpanel aplica limites de hot shard de 200 mil eventos por distinct_id por dia, e além disso os eventos são renomeados para $hotshard_events. Um único link que viraliza de verdade pode cruzar essa linha, e como o ID é por link, é exatamente esse link que é atingido.

Por que não um ID por visitante? Porque o redirecionamento não sabe quem é o visitante, e eu prefiro que ele não defina um cookie em um domínio que o visitante nunca escolheu visitar. Uma troca honesta.

Costurando cliques em link curto a usuários da forma que funciona

O padrão que funciona usa as duas metades para aquilo que cada uma faz bem. Deixe o evento server-side do Elido te dar a contagem completa de clique, incluindo cliques de pessoas que saem antes de sua página carregar. Deixe o SDK do Mixpanel na sua landing page cuidar da identidade.

Coloque tags de UTM na URL de destino. A biblioteca JavaScript do Mixpanel rastreia parâmetros de UTM por padrão e registra valores de primeiro toque no perfil, então quando esse visitante depois se cadastra e você chama identify, a campanha gruda em uma pessoa real. O clique no link curto e a visualização da landing page então compartilham um valor de campanha, não um ID de usuário, e você os junta por utm_campaign em um relatório. É uma junção em nível de campanha, mais grossa do que uma em nível de usuário, e eu acho que é o nível certo para esse dado de qualquer forma.

Quer os totais de clique e as sessões de landing page lado a lado? Espere que eles discordem; cliques em link curto versus sessões do GA4 explica por que a mesma lacuna aparece em qualquer ferramenta de analytics, Mixpanel incluído.

Se essa é a configuração que estava faltando, conecte um workspace e envie sua próxima campanha por links com marca própria.

Onde isso fica aquém hoje

Três lacunas, classificadas por quão provável é que te mordam.

O IP do visitante viaja em todo evento. Com residência na UE, ele vai para o host de ingestão da UE; no padrão dos EUA, vai para um endpoint nos EUA, e o guia de residência de dados na UE cobre como pesar isso. Para o lado do Mixpanel especificamente, incluindo como verificar a residência do seu projeto, consulte Residência de dados da UE no Mixpanel.

A entrega é best effort. Um POST que falha recebe uma nova tentativa depois de um segundo, e então é descartado, e os eventos não carregam $insert_id, então uma nova tentativa depois de um sucesso lento pode contar em dobro.

Não há referrer nem navegador no evento, e cliques que o redirecionamento sinaliza como suspeitos ainda são encaminhados. Confira o painel de analytics de clique quando precisar disso.

Conversões não fazem parte disso. Rastreie receita onde o seu ID de usuário vive.

Relacionados no blog

• Rastreie UTMs de ponta a ponta - a convenção de marcação da qual o padrão de costura depende.
• Cliques em link curto vs sessões do GA4 - por que contagens de clique e sessões de analytics nunca batem.
• Rastreamento server-side do GA4 via redirecionamentos - a mesma ideia server-side, apontada para o Google.
• Atribuição de cliques de e-mail para Mailchimp, Brevo e Klaviyo - encaminhando cliques para o lado de e-mail da stack.
• Mixpanel vs GA4 para analytics de link - qual ferramenta deveria guardar seus dados de clique, para começar.
• Residência de dados da UE no Mixpanel - os hosts de ingestão da UE e da Índia e o custo de uma incompatibilidade.