Para rastrear vendas da Kirvano, você precisa fazer três coisas. Primeiro, fazer as UTMs com o ID do anúncio chegarem ao link pay.kirvano.com, onde ficam gravadas na venda. Depois, configurar os pixels das redes de anúncio em cada produto. Por último, enviar as vendas por webhook a uma ferramenta que cruze origem, gasto e custos. Na Kirvano, esse último passo tem uma pegadinha: o webhook é por produto. Produto lançado depois da configuração não entra sozinho, e as vendas dele simplesmente não chegam.
Este guia cobre o que a Kirvano oferece para rastreamento, como montar o caminho da UTM até a venda, como conectar a Kirvano à Track Hunter e a rotina que evita o erro mais caro de quem vende vários produtos na plataforma.
O caminho de uma venda rastreada na Kirvano
Rastrear uma venda é conseguir responder, para cada pedido aprovado: qual anúncio trouxe essa pessoa, quanto esse anúncio custou e quanto sobrou depois de taxas e reembolsos. Na Kirvano, a informação percorre quatro trechos, e cada um tem um ponto de quebra:
| Trecho | O que precisa acontecer | Onde costuma quebrar |
|---|---|---|
| Anúncio → página de vendas | A URL do anúncio chega com UTMs preenchidas | Anúncio sem parâmetros de URL ou sem o ID do anúncio |
| Página de vendas → checkout | Os parâmetros passam para o link pay.kirvano.com | Botão "Comprar" com link fixo, sem repasse |
| Checkout → venda | A Kirvano grava as UTMs e o src no pedido | Parâmetro fora da lista aceita |
| Venda → análise | O pedido chega à ferramenta com a origem | Produto fora do webhook ou evento não marcado |
Os três primeiros trechos são os mesmos em qualquer checkout. O quarto é onde a Kirvano pede mais atenção.
UTMs na Kirvano: quais parâmetros e como passar
Segundo a central de ajuda da Kirvano, o link de checkout aceita utm_campaign, utm_content, utm_medium, utm_source, utm_term e src, um parâmetro genérico de origem parecido com o utm_source. A documentação de exemplos de requisições de webhook mostra esses mesmos campos (UTMs e src) dentro dos dados da venda.
Quando o anúncio leva direto ao checkout, basta os parâmetros estarem na URL. Quando há uma página de vendas no meio, alguém precisa repassá-los ao botão de compra. A Kirvano publica um script para colar na página, que percorre os links e acrescenta os parâmetros da URL atual.
No anúncio da Meta, use o padrão abaixo no campo Parâmetros de URL, no nível do anúncio:
utm_source=FB&utm_campaign={{campaign.name}}|{{campaign.id}}&utm_medium={{adset.name}}|{{adset.id}}&utm_content={{ad.name}}|{{ad.id}}&utm_term={{placement}}
O pedaço que importa é o utm_content, porque ele carimba o ID do anúncio na venda. Nome de anúncio muda e se repete, mas o ID não. Se quiser entender cada parâmetro e os equivalentes do Google e do TikTok, veja UTM: o que é e como usar.
Pixels na Kirvano: o que a documentação confirma
A página de pixels de conversão da Kirvano informa três coisas úteis:
- Redes suportadas: Google Ads, Facebook Ads, TikTok e Kwai.
- Configuração por produto: em Produtos, escolha o produto, abra Pixels e clique em Adicionar pixel.
- Campo de token: o cadastro tem um campo de código do token, fornecido pela rede de anúncio.
A central não lista quais eventos disparam em cada etapa nem se há opção de enviar compra no Pix gerado. Confira isso no Gerenciador de Eventos da Meta com uma compra de teste, em vez de supor.
O que vale para qualquer checkout vale aqui: o pixel serve para a Meta otimizar. Para você decidir verba, a fonte é a venda aprovada com UTM, cruzada com o gasto. As duas contas quase nunca batem, e isso é esperado. Os motivos estão em venda sem UTM.
Como conectar a Kirvano à Track Hunter
Na Track Hunter, a Kirvano é conectada por webhook. Vendas, reembolsos e chargebacks chegam em tempo real.
- Gere a URL na Track Hunter. Em Integrações › Checkouts, abra o card da Kirvano e clique em Criar URL de webhook. Copie o endereço gerado.
- Abra os webhooks da Kirvano. No painel da Kirvano, vá em Extensões › Webhooks e clique em Adicionar Integração. Algumas páginas da central de ajuda chamam esse caminho de Integrações › Webhooks.
- Cole a URL. No campo URL da integração, cole o endereço da Track Hunter. O campo Token é opcional: a Track Hunter valida pelo próprio endereço.
- Selecione todos os produtos. O webhook da Kirvano é por produto. Marque todos.
- Marque todos os eventos. Clique em Selecionar todos: compra aprovada, chargeback, reembolso, Pix, boleto, PicPay e carrinho abandonado. Sem reembolso e chargeback, o lucro aparece maior do que é.
- Crie e confira. Clique em Criar. O botão Testar integração envia um evento de amostra. A confirmação de verdade vem na primeira venda real, que aparece em segundos.
Dois avisos para guardar:
- Produto novo não entra sozinho. Sempre que criar um produto na Kirvano, volte ao webhook e adicione esse produto. Senão, as vendas dele não chegam.
- Desconectar abre um buraco. Segundo o painel da Track Hunter, as vendas do período desconectado não chegam sozinhas depois.
O custo de esquecer um produto no webhook
Exemplo hipotético. Um produtor vende o Curso A (R$ 97) na Kirvano há meses, com o webhook configurado. No dia 15, lança o Curso B (R$ 147) e sobe uma campanha só para ele, mas esquece de adicionar o produto ao webhook.
Para a taxa da Kirvano, o exemplo usa a tabela padrão publicada na central de ajuda quando este artigo foi escrito: 7,49% + R$ 2,00 por venda. Confira a tabela vigente na sua conta.
| Campanha do Curso B (15 dias) | O que o dashboard mostra | O que aconteceu de fato |
|---|---|---|
| Investimento | R$ 2.400,00 | R$ 2.400,00 |
| Imposto Meta (13,83%) | R$ 331,92 | R$ 331,92 |
| Vendas aprovadas | 0 | 38 (R$ 5.586,00) |
| Reembolsos | R$ 0 | 2 vendas (R$ 294,00) |
| Taxa Kirvano (7,49% + R$ 2) | R$ 0 | R$ 494,39 |
| Resultado | −R$ 2.731,92 | +R$ 2.065,69 |
A campanha dava lucro, mas a tela mostrava prejuízo. O gestor que olha o painel no dia 20 pausa a campanha, e ninguém percebe o erro até alguém comparar com o relatório de vendas da própria Kirvano.
A rotina que evita isso cabe em três linhas:
- Criou produto ou oferta nova? Adicione o produto ao webhook no mesmo dia.
- Subiu campanha para produto novo? Faça uma venda de teste (ou espere a primeira real) e confirme que ela apareceu.
- Uma vez por semana, compare o total de vendas aprovadas da Kirvano com o do dashboard. Diferença grande quase sempre é produto fora do webhook.
Order bump, upsell e assinatura na Kirvano
A Kirvano tem recursos de aumento de ticket que mudam a forma de ler os números:
- Order bump é configurado na oferta do produto principal, e só aceita produtos de oferta única (configurando order bump). Nos dados do webhook, cada item traz a marcação
is_order_bump. - Upsell de 1 clique funciona com uma estratégia criada em "Upsell, Downsell e mais" e um script colado na página de oferta, com os botões
kirvano-payment-triggerekirvano-refuse-trigger(como configurar upsell). - Assinaturas podem ser semanais, mensais, trimestrais, semestrais ou anuais. São pagas por cartão de crédito ou Pix e não podem ser oferecidas como order bump ou upsell (oferta por recorrência).
O efeito na atribuição: a pessoa que aceita o upsell geralmente chega à página de oferta sem UTM na URL, porque veio do checkout e não do anúncio. Se cada item fosse analisado isolado, o upsell viraria "venda sem origem", e o anúncio que trouxe o comprador pareceria pior do que é. Na Track Hunter, order bump e upsell herdam o anúncio e a campanha da compra principal. Assim, um curso de R$ 97 com upsell de R$ 197 conta como R$ 294 para o anúncio certo.
O que aparece na Track Hunter depois de conectar
- Dashboard com lucro real. Faturamento, reembolsos, chargebacks, e a taxa da Kirvano e as comissões de afiliado e coprodutor descontadas automaticamente pela integração. Não cadastre a taxa do checkout de novo em Taxas e Produtos, senão ela é descontada duas vezes.
- Pendentes fora do faturamento. Pix e boletos gerados e ainda não pagos ficam no bloco Vendas Pendentes, agrupados por CPF.
- Atribuição por anúncio. Com o
{{ad.id}}noutm_content, cada venda cai no anúncio, conjunto e campanha. A auditoria em Integrações › UTMs aponta os anúncios ativos sem o ID e oferece "Corrigir na Meta". - Purchase na API de Conversões da Meta. Com o Pixel da Track Hunter configurado e ligado ao seu pixel da Meta, cada venda aprovada é enviada como Purchase pelo servidor, com os dados do comprador em hash. Se você já envia compras da Kirvano para o mesmo pixel por outro caminho, revise a configuração para não contar a mesma venda duas vezes.
- Pixel da Track Hunter na página. O script reconhece os links da Kirvano pelo nome e decora o link do checkout com a sessão e as UTMs da visita, o que ajuda quando o botão de compra ficou com link fixo.
Todo plano começa com 30 dias grátis, sem cartão. O plano Free inclui 300 vendas aprovadas no total.
Perguntas Frequentes
Quais parâmetros de rastreamento a Kirvano aceita no checkout?
Segundo a central de ajuda da Kirvano, o link de checkout aceita utm_source, utm_medium, utm_campaign, utm_term, utm_content e src. Os parâmetros entram depois do endereço pay.kirvano.com/..., com ? no primeiro e & nos seguintes.
Por que as vendas de um produto da Kirvano não aparecem na Track Hunter?
A causa mais comum é o produto não estar selecionado no webhook. O webhook da Kirvano é por produto, e produto criado depois da configuração não entra sozinho. Edite a integração em Extensões › Webhooks, adicione o produto e confirme com a próxima venda.
Preciso preencher o campo Token no webhook da Kirvano?
Não. Para a Track Hunter, o campo Token é opcional, porque a validação é feita pelo próprio endereço gerado em Integrações › Checkouts.
Quais eventos devo marcar no webhook da Kirvano?
Todos. Clique em Selecionar todos: compra aprovada, chargeback, reembolso, Pix, boleto, PicPay e carrinho abandonado. Se marcar só a compra aprovada, reembolsos e chargebacks ficam de fora, e o lucro aparece maior do que é.
O botão Testar integração confirma que está tudo certo?
Ele confirma que a Kirvano consegue enviar um evento de amostra para a URL. A confirmação de verdade é a primeira venda real aparecer no dashboard, o que acontece em segundos.
Upsell da Kirvano sem UTM fica sem origem?
Não na Track Hunter. Order bump e upsell herdam o anúncio e a campanha da compra principal, então o valor extra conta para o anúncio que trouxe o comprador. Veja mais em order bump e upsell na atribuição.