Integrações5 min de leitura

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

A Zuptos devolve as UTMs, o fbc e o fbp em cada venda, e o valor líquido já sem a taxa e o coprodutor. O webhook com o token em x-zuptos-token, as UTMs no anúncio, o script na página e o que vira venda — order bump, renovação e oferta gratuita.

Notebook sobre uma mesa de vidro mostrando um painel de análise com gráficos
Foto de Carlos Muza no Unsplash.

Quem vende pela Zuptos e anuncia no Meta tem a venda de um lado e o gasto do outro. Para saber qual anúncio trouxe qual venda — e, a partir daí, qual escalar e qual desligar —, os dois precisam estar na mesma linha. Este texto mostra como chegar lá.

A Zuptos é das plataformas que mais ajudam nisso: o aviso de venda dela traz um bloco de rastreamento com as UTMs e os identificadores do Meta do comprador, e um bloco fiscal com o valor que de fato fica com você. O trabalho é garantir que a origem exista na hora do checkout.

O que a Zuptos devolve em cada venda

  • As cinco UTMs que estavam no link do checkout, no bloco tracking.
  • O fbc e o fbp, que a Meta usa para reconhecer quem clicou no anúncio — e que fazem a compra enviada pelo servidor casar com a pessoa certa. Junto vem o IP de quem pagou.
  • O total, a taxa e o líquido, no bloco fiscal. O líquido já sai sem a taxa da Zuptos e sem a parte do coprodutor, e é dele que o UTMizey calcula o faturamento líquido e o lucro.
O caminho de uma venda da Zuptos até o anúncio
  1. AnúncioUTMs no campo de parâmetros
  2. Página de vendaso script guarda a origem
  3. Checkout Zuptoso link sai com as UTMs
  4. Webhooka venda volta com o rastreamento

Passo 1: o webhook

No UTMizey, abra Integrações → Webhooks, escolha a Zuptos e clique em Gerar URL do webhook. Na Zuptos, crie uma conexão de webhook com esse endereço.

A conexão da Zuptos tem um campo de Token, e ela deixa você escolher o nome do cabeçalho em que ele viaja. Use o nome x-zuptos-token, um valor longo e aleatório, e cole o mesmo valor no campo de segredo que o UTMizey mostra abaixo da URL. É o que garante que só a Zuptos consegue lançar vendas no seu painel.

Confira o nome do cabeçalho antes da primeira venda

Com outro nome, o token não chega onde o UTMizey procura, e toda venda é recusada como chamada sem prova de origem. A Zuptos desiste de reenviar depois da quinta tentativa — então uma venda recusada hoje não volta sozinha amanhã. Uma compra de valor baixo logo depois de ligar tira a dúvida.

Marque os avisos de Pix gerado, Pix, cartão e boleto aprovados, cartão recusado, reembolso, chargeback e renovação de assinatura. O Pix gerado entra como pendente e vira aprovado quando é pago — sem ele, você não vê quantos pararam no pagamento.

Passo 2: as UTMs no anúncio

Em Integrações → UTMs, clique em Copiar código no cartão do Facebook e escolha Outra. É o código padrão, com as cinco UTMs e as macros do Meta, e vai no campo Parâmetros de URL de cada anúncio. O passo a passo, com o jeito de conferir antes de gastar, está no artigo sobre parâmetros de URL no Meta Ads.

Passo 3: o script na página de vendas

Em Integrações → UTMs, clique em Baixar script, escolha Outra e cole o código no <head> da página de vendas.

O script registra cada clique de anúncio e reescreve os links que levam ao checkout da Zuptos para que saiam com as UTMs da visita — inclusive os botões que montam o link só na hora do clique. Sem isso, o visitante chega no checkout por um link fixo, sem origem, e a Zuptos não tem o que devolver.

O que vira venda, e como

  • Order bump é item da mesma venda. Na Zuptos, o produto principal e os bumps vêm num pedido só, cada um com o seu preço, e é assim que entram no UTMizey: uma venda, com os produtos e o valor somado. É como na Wiapy, e o oposto da Cakto, que manda o bump como pedido separado.
  • Cada renovação é uma venda nova. A cobrança mensal de uma assinatura chega com identificador próprio e entra como venda aprovada daquele dia — a receita recorrente aparece no mês em que foi paga.
  • Oferta gratuita entra como aprovada, com valor zero. Conta como venda no funil, com o meio de pagamento marcado como gratuito, e não mexe no faturamento.
  • Checkout iniciado e boleto gerado não viram pedido. A Zuptos manda esses dois avisos sem número de venda, e o UTMizey só cria pedido quando existe venda. O boleto aparece quando é pago.
  • A venda de exemplo fica de fora. O exemplo da documentação da Zuptos usa e-mail e IP reservados para teste. Uma chamada assim aparece em Eventos, mas a venda fica fora do Resumo, dos relatórios e do Purchase enviado à Meta.

Como conferir que está tudo certo

  • O anúncio: abra a publicação, toque no botão e veja a barra de endereço. As UTMs precisam estar lá, com valores no lugar das chaves.
  • O checkout: na página aberta pelo anúncio, passe o mouse no botão de compra (ou toque e segure, no celular). O link da Zuptos precisa conter utm_campaign=.
  • A venda: uma compra real de valor baixo, a partir do anúncio, precisa aparecer com campanha, conjunto e anúncio preenchidos. Se ela não aparecer, a tela Eventos mostra se a chamada chegou e por que foi recusada.

Checkout em domínio próprio

O script reconhece o checkout pelo nome da Zuptos no endereço. Se o seu checkout roda num domínio seu, acrescente o atributo data-utmizey-checkout no script, com esse domínio — senão o link sai sem as UTMs.

Em uma frase

A Zuptos devolve as UTMs e os identificadores do Meta que encontrar no checkout: o código no anúncio e o script na página garantem que eles estejam lá, e o webhook com o token em x-zuptos-token traz a venda de volta com a origem e o valor líquido.

Zuptos ligada em poucos minutos

No UTMizey, o webhook, o código de UTMs e o script saem prontos — é escolher a plataforma e copiar. A venda da Zuptos chega com o anúncio que a trouxe e o lucro já descontado da taxa e do coprodutor. O plano gratuito cobre até 30 vendas aprovadas por mês.