Rastreamento de conversões

O Elido registra duas coisas de um link curto: o clique e a conversão (um pedido pago que veio depois). O rastreamento de conversões conecta as duas, para você ver quais links geram receita e não apenas tráfego.

O que conta como conversão

Uma conversão é um pedido pago recebido de uma conta conectada do Stripe ou do Shopify. O Elido armazena a plataforma, a receita, a moeda, o e-mail do cliente e o link ao qual foi atribuída. Reembolsos informados pelo provedor revertem a conversão.

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

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

Configurar as conversões

1. Adicione os signing secrets dos webhooks do Stripe e/ou do Shopify ao workspace (Settings → Integrations, ou PUT /v1/workspaces/{id}/pixels). Webhooks sem um secret configurado são rejeitados.
2. No Stripe, adicione um endpoint de webhook https://api.elido.app/v1/workspaces/{id}/conversions/stripe para checkout.session.completed e payment_intent.succeeded. No Shopify, adicione um webhook orders/paid em https://api.elido.app/v1/workspaces/{id}/conversions/shopify.
3. Marque a venda com o link: passe elido_link_id nos metadados da Checkout Session do Stripe, ou como atributo de nota do pedido elido_link_id no Shopify. Pedidos sem ele são registrados, mas não atribuídos a um link.

Exemplos completos de requisições estão no guia para desenvolvedores: Conversion tracking.

Atribuição

A atribuição é por link: a conversão é creditada ao link cujo ID você passou e à campanha desse link. Hoje não há janela de atribuição nem associação baseada em cookies. Entregas duplicadas de webhooks são deduplicadas.

Lendo o dashboard de conversões

Analytics → Conversions divide as conversões por:

• Platform: stripe ou shopify.
• Top links: quais links curtos geraram mais conversões.
• Top campaigns: quais campanhas converteram melhor.
• Daily revenue: um gráfico de barras com a receita atribuída ao longo do tempo.

Solução de problemas

As conversões não aparecem. Verifique se o signing secret está salvo (a falta dele retorna 401), se o cabeçalho da assinatura está chegando ao Elido e se os eventos de webhook listados acima estão habilitados.

Uma conversão não tem link. O checkout não levou elido_link_id. Adicione-o aos metadados do Stripe ou aos atributos de nota do Shopify.

A receita não bate com o meu processador de pagamentos. O Elido registra o valor informado pelo webhook; os reembolsos são aplicados quando o provedor envia o evento de reembolso.