Integrações5 min de leitura

Hotmart e Meta Ads: o guia completo para saber qual anúncio vendeu

A Hotmart não devolve as UTMs no aviso de venda, e é por isso que a configuração dela é diferente de todas as outras. O webhook com o Hottok, o código de anúncio com o xcod, o script que escreve o sck e como conferir cada peça.

Painel com gráficos de desempenho de campanha numa tela de computador
Foto de Luke Chesser no Unsplash.

Quem vende na Hotmart e anuncia no Meta costuma ter os dois números na mão e nenhuma ligação entre eles. A Hotmart diz quantas vendas entraram; o Gerenciador diz quanto cada anúncio gastou. A pergunta que decide onde colocar o próximo real — qual anúncio trouxe qual venda? — fica sem resposta, ou com a resposta que o Gerenciador estima.

Este texto mostra como ligar as duas pontas, peça por peça, e o detalhe da Hotmart que faz a configuração dela ser diferente da de qualquer outra plataforma.

O que a Hotmart tem de diferente

A maior parte das plataformas de venda lê as UTMs do link do checkout e devolve essas UTMs junto com a venda. A Hotmart não: o aviso de venda dela não traz as UTMs. O que ele traz é um campo livre, o sck (no código de anúncio ele aparece também como xcod). Tudo o que você escrever ali na hora do clique volta intacto quando a venda é aprovada.

É esse campo que carrega a origem da venda até o fim. Se ele não for preenchido, a venda chega sem campanha, sem conjunto e sem anúncio, por mais que as UTMs estivessem certinhas no link.

O caminho de uma venda da Hotmart até o anúncio
  1. AnúncioUTMs + xcod no campo de parâmetros
  2. Página de vendaso script registra o clique
  3. Checkout Hotmartrecebe o sck no link
  4. Webhooka venda volta com o sck

As três peças que precisam estar ligadas

  • O webhook — é por ele que a Hotmart avisa cada venda, reembolso e chargeback.
  • O código de UTMs no anúncio — o texto que vai no campo Parâmetros de URL, na versão da Hotmart, com o xcod.
  • O script na página de vendas — que registra o clique e escreve a origem no sck do link do checkout.

Faltando qualquer uma, o painel ainda mostra as vendas, mas sem saber de onde vieram. A ordem abaixo é a que dá para testar cada peça antes de passar para a próxima.

Passo 1: o webhook

No UTMizey, abra Integrações → Webhooks, escolha a Hotmart e clique em Gerar URL do webhook. Sai um endereço exclusivo da sua conta.

Na Hotmart, vá em Ferramentas → Webhook e cadastre esse endereço. Marque os eventos de compra aprovada, recusada, reembolso e chargeback, mais os de Pix e boleto gerados — sem esses dois, a venda pendente não aparece, e você perde de vista o Pix que foi gerado e não foi pago.

Na mesma tela da Hotmart fica o Hottok, o código que prova que a chamada veio dela. Copie e cole no campo de segredo que o UTMizey mostra logo abaixo da URL. Sem ele, quem descobrisse o endereço poderia inserir venda falsa no seu painel.

O botão “Enviar teste” não suja o faturamento

A Hotmart tem um botão que dispara uma venda de exemplo. Use à vontade para conferir que o webhook chegou: o UTMizey reconhece essa amostra, registra o evento e deixa a venda de teste fora do Resumo, dos relatórios, da contagem do plano e do Purchase enviado à Meta.

Passo 2: o código de UTMs no anúncio

Em Integrações → UTMs, clique em Copiar código no cartão do Facebook e escolha Hotmart. O código da Hotmart é o comum — as cinco UTMs com as macros do Meta — mais um pedaço com o xcod, que repete a origem dentro do campo livre.

Esse texto vai no campo Parâmetros de URL de cada anúncio, no Gerenciador. Por que usar id além do nome, onde fica o campo e como conferir se as macros foram trocadas está explicado no artigo sobre parâmetros de URL no Meta Ads.

Não use o código de outra plataforma

O código genérico, sem o xcod, funciona em quase toda plataforma — menos na Hotmart. Com ele, as UTMs chegam na página e param ali: a Hotmart não as devolve, e a venda entra sem anúncio.

Passo 3: o script na página de vendas

Ainda em Integrações → UTMs, clique em Baixar script e escolha Hotmart. O script vem com o id do seu painel preenchido e com o atributo data-utmizey-hotmart, que é o que manda ele escrever a origem no sck e no xcod do link do checkout. Cole no <head> da página de vendas.

O script não sobrescreve um sck que já esteja no link. Em link de afiliado esse campo carrega a comissão de alguém, e mexer nele seria tirar a venda de quem a fez.

Como conferir que está tudo certo

  • O webhook: depois do botão de teste da Hotmart, a chamada aparece na tela de Eventos do UTMizey.
  • O anúncio: abra a publicação do anúncio, toque no botão e veja a barra de endereço. As UTMs e o xcod precisam estar lá, com valores no lugar das chaves.
  • O checkout: na página de vendas aberta pelo anúncio, passe o mouse no botão de compra (ou toque e segure, no celular). O link do checkout precisa terminar com um sck=.
  • A venda: o teste final é uma compra real, de valor baixo, a partir do anúncio. Ela precisa aparecer no painel com campanha, conjunto e anúncio preenchidos.

Venda internacional

Na Hotmart, quem compra de fora paga na moeda dele, e o produtor recebe em real. São dois valores em duas moedas no mesmo pedido. O UTMizey guarda os dois e usa a comissão na moeda em que você recebe para o faturamento líquido e o lucro — o valor pago em peso ou em dólar não entra como se fosse real.

Em uma frase

Na Hotmart, a venda só volta com a origem se a origem foi escrita no sck na ida: por isso o código do anúncio e o script da página têm versão própria para ela, e o webhook com o Hottok fecha o caminho.

Hotmart ligada em poucos minutos

No UTMizey, o webhook, o código de UTMs e o script já saem prontos para a Hotmart — é escolher a plataforma e copiar. A venda chega com o anúncio que a trouxe, o lucro sai da comissão que a Hotmart informa e, com o pixel configurado, o Purchase vai para a Meta pelo servidor, com os dados do comprador. O plano gratuito cobre até 30 vendas aprovadas por mês.