Para rastrear vendas do Guru (Digital Manager Guru) no Meta Ads, no Google Ads e no TikTok Ads, você precisa de três coisas: UTMs com o ID do anúncio chegando ao link do Checkout Guru, que grava utm_source, utm_medium, utm_campaign, utm_content, utm_term, src e sck em cada venda; uma única forma de marcar eventos de conversão da Meta (pela API do Guru ou pelo navegador, nunca as duas); e o webhook de vendas do Guru, com todos os status marcados, ligado a uma ferramenta que junte cada venda ao gasto do anúncio e desconte taxa, reembolso e chargeback. O Guru entrega os dados. Transformar esses dados em lucro por anúncio é a parte que fica com você.
O Guru tem uma diferença importante em relação aos checkouts "tudo em um": ele funciona como uma camada de gestão sobre processadores de pagamento e sobre outras plataformas. Isso muda o jeito de rastrear, e é o que este guia cobre.
Por que rastrear vendas do Guru é diferente de outros checkouts
Em um checkout comum, a plataforma processa o pagamento, cobra uma taxa fixa e pronto. No Guru, três características mexem diretamente com a medição:
- O pagamento passa por um processador que você escolhe. O Guru fala em mais de 25 opções de processador na central do Checkout Guru. Cada processador tem a própria taxa, prazo e formas de pagamento. Duas vendas de R$ 297 podem deixar valores líquidos diferentes dependendo de por onde passaram.
- O Guru pode receber vendas de outras plataformas. Pela área de integrações, dá para ativar o recebimento de vendas feitas na Hotmart ou na Eduzz, e o Guru cria o registro da venda e do cliente (integração com a Hotmart, integração com a Eduzz). No webhook, isso aparece como o filtro por Marketplaces.
- Venda internacional depende do processador. Segundo o FAQ do Checkout Guru, a conversão de moeda pode ser só visual (o cliente vê o valor na moeda do país) ou uma cobrança real na moeda local, e isso depende do processador usado.
Traduzindo: no Guru, "quanto vendi" e "quanto sobrou" se afastam mais do que o normal, e a origem de uma venda pode ser o próprio Checkout Guru ou uma plataforma conectada a ele.
O que o Guru já oferece para rastreamento
Marcação de eventos de conversão (pixel)
O Checkout Guru dispara eventos para Facebook (Meta Ads), Google Ads, Google Tag Manager, LinkedIn e Propeller Ads. Segundo a página Ativar a marcação de eventos de conversão (pixel), na Meta os eventos seguem a jornada do checkout: adição ao carrinho quando o checkout abre, início da finalização quando os dados de contato são validados, adição de informação de pagamento no clique em pagar, compra no pagamento aprovado e início de período de avaliação em assinaturas.
Para a Meta existem duas modalidades:
- Via API, que o Guru recomenda: o servidor do Guru envia os eventos pela API de Conversões.
- Via navegador, no aparelho do comprador.
A própria documentação avisa para escolher apenas uma das duas, para evitar duplicidade.
Configuração em três níveis
A marcação pode ser feita em Configurações » Checkout (global), em Produtos » produto » Checkout (por produto) ou em Produtos » produto » Ofertas » oferta » Checkout (por oferta). O nível mais específico sobrescreve o mais geral. Isso é útil para mandar ofertas diferentes para pixels diferentes, e perigoso quando alguém esquece uma oferta antiga com um ID de pixel de outra conta.
Parâmetros de rastreamento
O Guru aceita no link do checkout os parâmetros utm_source, utm_medium, utm_campaign, utm_content, utm_term, src e sck. Segundo a página de parâmetros de rastreamento do checkout, eles voltam pelo webhook e pela API pública dentro do objeto source, com até 191 caracteres cada. Guarde esse limite: UTM com nome de campanha, nome de conjunto e nome de anúncio muito longos pode ser cortada.
Webhook de vendas
O Guru tem webhooks de vendas, assinaturas e e-tickets. A documentação de webhook informa que o envio é automático quando o evento ocorre, em POST com JSON, e faz um alerta que importa para quem mede: a mesma venda pode ser enviada várias vezes, mesmo sem mudança de status. Quem recebe precisa tratar isso para não contar a venda duas vezes.
Order bump e upsell
No Guru, order bump e upsell geram pedidos separados. O order bump é processado em sequência com os mesmos dados de pagamento; em boleto ou PIX, cada pedido recebe um código de pagamento diferente. O upsell com 1-clique cria um novo pedido e só funciona com cartão de crédito. Pedido separado costuma significar pedido sem UTM própria, e é aí que a atribuição se perde (mais sobre isso em order bump e upsell: como atribuir ao anúncio certo).
Configurando o Guru para saber qual anúncio vendeu
1. Padronize a UTM nos anúncios da Meta
No campo Parâmetros de URL de cada anúncio, use um padrão que leve o ID do anúncio. Este é o padrão que a Track Hunter recomenda:
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 essencial é o utm_content com {{ad.id}}: é ele que liga a venda ao anúncio. Se os nomes forem longos, encurte os nomes, não os IDs, por causa do limite de 191 caracteres do Guru. O passo a passo para Google e TikTok está no guia de UTM: o que é e como usar.
2. Faça a UTM chegar ao link do Checkout Guru
Se o anúncio leva a uma página de vendas e o botão aponta para um link fixo do checkout, os parâmetros ficam na página. Use o recurso do seu construtor de páginas, ou um script, para repassar os parâmetros da URL para o link de compra. Teste clicando no anúncio pela pré-visualização e conferindo se o checkout abre com os valores preenchidos.
3. Escolha uma só forma de marcar a compra na Meta
Decida entre API e navegador no Guru e deixe o outro campo vazio. Se você usa também outro script que envia Purchase para o mesmo pixel, revise para não mandar a mesma compra por dois caminhos.
4. Revise ofertas antigas
Como o nível de oferta sobrescreve o global, abra as ofertas que ainda recebem tráfego e confira se não há um pixel diferente configurado ali.
5. Separe vendas do Checkout Guru das vendas de marketplace
Se o Guru recebe vendas da Hotmart ou da Eduzz, decida por onde cada venda vai entrar na sua ferramenta de medição. Receber a mesma venda por dois caminhos (pela plataforma de origem e pelo Guru) é um jeito rápido de dobrar faturamento no relatório.
Exemplo: por que o faturamento do Guru engana
Exemplo hipotético, com números e taxas ilustrativos. Um produtor vende uma mentoria em assinatura de R$ 97/mês e um curso de R$ 297, com dois processadores configurados no Guru: um nacional para PIX, boleto e cartão, e um internacional, só cartão, para compradores de Portugal. No mês, investe R$ 12.000 em duas campanhas da Meta.
| Campanha A (Brasil) | Campanha B (Portugal) | |
|---|---|---|
| Investimento | R$ 7.000 | R$ 5.000 |
| Pedidos aprovados (com UTM da campanha) | 40 cursos + 25 assinaturas | 30 cursos |
| Faturamento bruto | R$ 14.305 | R$ 8.910 |
| Order bump de R$ 47 (pedidos separados) | 12 | 4 |
| Taxa do processador (hipotética) | 5% | 9% |
| Reembolsos (hipotético) | R$ 594 | R$ 1.485 |
| Resultado após anúncio, taxa e reembolso (sem os bumps) | ≈ R$ 5.996 | ≈ R$ 1.623 |
Pelo faturamento, a Campanha B parece render bem (R$ 8.910 com R$ 5.000). Pelo resultado, sobra pouco: a taxa do processador internacional é maior e o reembolso pesa. Repare também nos order bumps: se eles ficarem sem UTM, os R$ 564 da Campanha A e os R$ 188 da Campanha B aparecem como "venda sem origem", e as duas campanhas parecem piores do que são.
Nada disso aparece no Ads Manager, que vê só o evento de compra. E montar essa tabela à mão, processador por processador, dá muito trabalho.
Como conectar o Guru à Track Hunter
A Track Hunter recebe as vendas do Guru em tempo real por webhook. O caminho é este:
- Na Track Hunter, abra Integrações > Checkouts, escolha o card do Guru e clique em Criar URL de webhook. Copie a URL gerada.
- No painel do Guru, vá em Configurações > Webhooks > Vendas e crie um novo webhook.
- No campo URL, cole a URL da Track Hunter. Não use o
dashboard_id: o próprio endereço funciona como segredo. - Em Filtrar por, mantenha Todos. Se filtrar por Produtos ou Marketplaces sem incluir todos, as vendas de algum produto não chegam.
- Em Status, clique em Selecionar Todos (aprovada, aguardando pagamento, reembolsada e os demais). Sem o status de reembolso, o lucro aparece maior do que é.
- Clique em Enviar. O Guru dispara o webhook a cada atualização da venda, e a confirmação de verdade vem na primeira venda real, que aparece em segundos.
Dois cuidados. Se você também conecta diretamente à Track Hunter uma plataforma cujas vendas entram no Guru como marketplace, fale com o suporte antes, para definir por qual caminho essas vendas devem chegar. E, se um dia desconectar a integração, saiba que o painel avisa: vendas do período desconectado não chegam sozinhas depois.
O que você passa a ver
- Lucro real no dashboard. A taxa de checkout e as comissões de afiliado e coprodutor chegam automaticamente com a venda (não cadastre de novo em Taxas e Produtos, senão desconta duas vezes). Reembolso e chargeback saem do faturamento.
- Venda por anúncio. Com o padrão de UTM acima, a venda do Meta Ads é ligada ao anúncio pelo
utm_content. No Google Ads, outm_campaign={campaignid}do modelo de acompanhamento liga a venda à campanha, inclusive em Performance Max. No TikTok Ads, a UTM identifica a origem TikTok; a atribuição por anúncio ainda não está disponível. - Order bump e upsell herdando o anúncio. Os pedidos adicionais que o Guru cria em sequência herdam o anúncio e a campanha da compra principal, em vez de virarem venda sem origem.
- Purchase na API de Conversões da Meta. A venda aprovada é enviada à Meta pelo servidor, com e-mail, telefone e documento em hash. Se você usar isso, reavalie a marcação de compra do próprio Guru para a Meta, pelo mesmo motivo de sempre: uma compra, um envio. Mais contexto em API de Conversões do Facebook.
- PIX e boleto pendentes separados. Venda "aguardando pagamento" fica em Vendas Pendentes e não entra no faturamento até ser paga.
E o Pixel da Track Hunter?
O Pixel da Track Hunter decora links de checkout com a sessão e as UTMs. O Guru não está na lista de checkouts reconhecidos pelo nome, então não conte com isso por padrão: o script reconhece qualquer link que tenha "checkout" no endereço (no domínio ou no caminho). Se o seu link do Guru não tiver, a base continua sendo o padrão de UTM no anúncio repassado até o checkout, como no passo 2.
Erros comuns ao rastrear vendas do Guru
- Marcar a compra na Meta por API e por navegador ao mesmo tempo. O Guru avisa: escolha uma.
- Pixel diferente esquecido no nível da oferta. Sobrescreve o global sem ninguém perceber.
- Webhook filtrado por produto. Produto novo fica de fora e ninguém nota até o fechamento do mês.
- Status incompletos. Só "aprovada" marcado deixa reembolso e chargeback de fora.
- Contar a mesma venda duas vezes. Por reenvio do webhook ou por receber a venda de marketplace por dois caminhos.
- Comparar campanhas pelo bruto quando há processadores diferentes. A taxa muda o ranking. Veja qual anúncio gerou a venda para montar a comparação certa.
Perguntas Frequentes
O Guru tem API de Conversões da Meta?
Sim. Na marcação de eventos do Checkout Guru, a opção via API é a recomendada pelo próprio Guru e envia os eventos pelo servidor. A alternativa é a marcação pelo navegador. A documentação pede para usar só uma das duas, para não duplicar eventos.
Quais parâmetros de rastreamento o Checkout Guru aceita?
utm_source, utm_medium, utm_campaign, utm_content, utm_term, src e sck. Eles voltam no webhook e na API pública dentro do objeto source, com limite de 191 caracteres por campo.
Onde fica o webhook de vendas no Guru?
Em Configurações > Webhooks > Vendas. Para a Track Hunter, mantenha Filtrar por em Todos e selecione todos os status antes de clicar em Enviar.
O order bump do Guru é uma venda separada?
Sim. O Guru processa os pedidos do order bump em sequência, com os mesmos dados de pagamento; em PIX ou boleto, cada pedido tem o seu código. O upsell de 1-clique também cria um novo pedido, e só funciona no cartão. Na Track Hunter, esses pedidos herdam o anúncio da compra principal.
Vendas da Hotmart que entram no Guru aparecem duas vezes?
Podem aparecer, se você receber a mesma venda pela Hotmart e pelo Guru na mesma ferramenta. Defina um caminho só para cada venda. Na Track Hunter, fale com o suporte antes de conectar as duas pontas.
Consigo ver o lucro de vendas internacionais do Guru?
A venda chega com o valor que o Guru informa, e a cobrança real em moeda estrangeira depende do processador. Na Track Hunter, você escolhe a moeda de exibição do painel (BRL, USD ou EUR) e vê faturamento, taxas de checkout, reembolso e lucro no mesmo lugar. Confira nas primeiras vendas internacionais se os valores batem com o extrato do seu processador.