Integrações4 min de leitura

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

O aviso de venda da Wiapy traz as UTMs e os identificadores do Meta do comprador. O webhook com token, as UTMs no anúncio, o script que leva a origem ao checkout, e o que muda no orderbump e no carrinho abandonado.

Quem vende pela Wiapy 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 Wiapy facilita a parte mais difícil: o aviso de venda dela traz um bloco de rastreamento com as UTMs e os identificadores do Meta do comprador. O trabalho é garantir que esses dados existam na hora do checkout.

O que a Wiapy devolve em cada venda

  • As cinco UTMs que estavam no link do checkout.
  • 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.
  • O valor e a taxa da Wiapy. A comissão é o valor menos a taxa, e é dela que saem o faturamento líquido e o lucro.
O caminho de uma venda da Wiapy até o anúncio
  1. AnúncioUTMs no campo de parâmetros
  2. Página de vendaso script guarda a origem
  3. Checkout Wiapyo link sai com as UTMs
  4. Webhooka venda volta com o rastreamento

Passo 1: o webhook

No UTMizey, abra Integrações → Webhooks, escolha a Wiapy e clique em Gerar URL do webhook. Na Wiapy, cadastre um webhook com esse endereço.

A Wiapy pede um token para o webhook e o manda em cada chamada. Use um texto longo e aleatório, e cole o mesmo token no campo de segredo que o UTMizey mostra abaixo da URL. É o que garante que só a Wiapy consegue lançar vendas no seu painel.

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

O evento de teste da Wiapy fica de fora

O painel da Wiapy dispara uma venda de exemplo para testar o webhook. Ela não vem marcada como teste, mas o UTMizey a reconhece pelo checkout e pelo navegador de teste que ela traz: a chamada aparece em Eventos, e a venda fica fora do Resumo, dos relatórios, da contagem do plano e do Purchase enviado à Meta.

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 Wiapy 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 Wiapy não tem o que devolver.

Duas particularidades da Wiapy

  • Orderbump é item da mesma venda. Na Wiapy, o produto principal e o orderbump vêm num pedido só, e é assim que entram no UTMizey: uma venda, com os dois produtos e o valor somado. É o oposto da Cakto, que manda o orderbump como pedido separado.
  • Carrinho abandonado não vira venda. A Wiapy usa o mesmo webhook para avisar quem saiu do checkout sem pagar. Esse aviso fica registrado em Eventos, mas não entra como pedido — nem como pendente.

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 Wiapy 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.

Checkout em domínio próprio

O script reconhece o checkout pelo endereço da Wiapy. 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 Wiapy 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 traz a venda de volta com a origem.

Wiapy 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 Wiapy chega com o anúncio que a trouxe e o lucro já descontado da taxa. O plano gratuito cobre até 30 vendas aprovadas por mês.