Acompanhamento de conversões

O Elido acompanha duas coisas de um link curto: o clique (quando alguém segue o link) e a conversão (quando essa mesma pessoa realiza uma ação valiosa no seu site posteriormente). O acompanhamento de conversões conecta os dois, para que você possa ver não apenas quais links geram tráfego, mas quais geram resultados.

O que conta como uma conversão#

Uma conversão é qualquer evento que você definir — uma compra, um cadastro, o envio de um formulário, o início de um período de teste. O Elido não impõe uma definição específica. Você envia um evento de conversão quando a ação acontece; nós a atribuímos ao clique que trouxe o usuário.

O painel de conversões em Analytics → Conversions mostra:

• Total de conversões e receita total atribuída.
• Conversões detalhadas por link, campanha, dia e plataforma.
• Uma tabela de eventos de conversão individuais recentes com o e-mail do cliente e a receita.

Configurar um evento de conversão#

Opção 1: chamada de API via servidor#

O método mais confiável. Quando um usuário conclui uma ação no seu backend, envie um POST para o endpoint de conversões:

curl -X POST https://api.elido.app/v1/conversions \
  -H "Authorization: Bearer $ELIDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": 42,
    "platform": "stripe",
    "customer_email": "[email protected]",
    "revenue_cents": 4900,
    "currency": "EUR",
    "converted_at": "2026-05-12T14:30:00Z"
  }'

Inclua customer_email ou click_id para atribuição. Se você passar um click_id (retornado nos cabeçalhos de resposta de redirecionamento como X-Elido-Click-ID), a atribuição é exata. Se você passar apenas o customer_email, nós o associaremos ao último clique desse endereço dentro da janela de atribuição.

Opção 2: pixel no lado do cliente#

Adicione o pixel do Elido à sua página de confirmação (confirmação de pedido, sucesso no cadastro, etc.):

<script>
  window.elidoConvert = window.elidoConvert || function(opts) {
    fetch('https://api.elido.app/v1/conversions/pixel', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        workspace_id: opts.workspaceId,
        platform: opts.platform || 'web',
        revenue_cents: opts.revenueCents || 0,
        currency: opts.currency || 'EUR',
      }),
      credentials: 'include',
    });
  };
</script>

Em seguida, chame-o na página de confirmação:

<script>
  elidoConvert({
    workspaceId: 42,
    platform: 'web',
    revenueCents: 4900,
    currency: 'EUR',
  });
</script>

O pixel usa um cookie do navegador definido durante o redirecionamento para identificar o clique que precedeu a conversão. Isso funciona para jornadas no mesmo navegador e no mesmo dispositivo. Para atribuição entre dispositivos ou navegadores diferentes, o método click_id via servidor é mais confiável.

Janelas de atribuição#

Por padrão, uma conversão é atribuída ao clique mais recente do mesmo usuário dentro de uma janela de 30 dias. Se o mesmo usuário clicou em vários links nesse período, a conversão é atribuída ao último clique (atribuição de último toque).

A janela é configurável por espaço de trabalho em Settings → Attribution. As opções disponíveis incluem 1 dia, 7 dias, 30 dias e 90 dias.

Leitura do painel de conversões#

Analytics → Conversions detalha as conversões por:

• Plataforma — o campo platform que você passa na chamada da API (stripe, shopify, web ou qualquer rótulo que você escolher).
• Principais links — quais links curtos geraram mais conversões.
• Principais campanhas — quais campanhas converteram melhor.
• Receita diária — um gráfico de barras da receita atribuída ao longo do tempo.

A receita é mostrada como a soma dos valores revenue_cents que você enviou. Se você não acompanha a receita (por exemplo, para geração de leads), pode deixar revenue_cents em 0 e usar apenas a contagem de conversões.

Resolução de problemas#

As conversões não estão aparecendo. Verifique a resposta da API para sua chamada POST /v1/conversions — o endpoint retorna o ID da conversão em caso de sucesso e uma mensagem de erro detalhada em caso de falha. Problemas comuns: ID do espaço de trabalho ausente, código de moeda inválido (deve ser ISO 4217, por exemplo, EUR e não €), ou uma chave de API sem a permissão conversions:write.

A atribuição não está correspondendo aos cliques esperados. Se você estiver usando o pixel (baseado em cookies), verifique se o navegador do usuário não está bloqueando cookies de terceiros. O ITP do Safari e alguns bloqueadores de anúncios limparão o cookie antes que a página de conversão seja disparada. Use o método click_id via servidor para uma atribuição confiável.

Os números de receita não correspondem ao meu processador de pagamentos. Os números no Elido são exatamente o que você nos envia — não extraímos valores do Stripe ou de qualquer outro processador diretamente. Se houver uma discrepância, compare os valores de revenue_cents nas suas chamadas de API de conversão com seus registros de pagamento.

Uma conversão está aparecendo no link errado. A atribuição usa o último toque por padrão. Se um usuário clicou em vários links antes de converter, ela vai para o clique mais recente. Se o último clique foi de uma campanha diferente, esse é o comportamento esperado. Ajuste a janela de atribuição ou mude para a atribuição de primeiro toque nas configurações se o último toque não atender às suas necessidades de relatório.