Confiabilidade

Como o UTMizey trata cada venda

Um painel de vendas só serve se o número dele for confiável. Esta página responde ao que dá errado no caminho entre a plataforma de vendas, o painel e a Meta — venda duplicada, evento fora de ordem, reembolso, venda sem clique, integração com erro — e diz o que o UTMizey faz em cada caso.

A mesma venda chegando duas vezes vira duas vendas?

Não. Cada pedido é identificado pelo número que a própria plataforma dá a ele, e o banco não aceita dois pedidos com o mesmo número na mesma plataforma e no mesmo painel. A segunda chegada atualiza o pedido que já existe — é por isso que a plataforma pode reenviar à vontade.

E se o webhook chegar atrasado ou fora de ordem?

Cada evento traz o instante em que a plataforma diz que ele aconteceu, e é esse instante que decide — não a hora em que chegou. Um "aprovado" atrasado que chega depois de um "reembolsado" não devolve a venda para paga: ele é registrado na tela de Eventos, marcado como ignorado, e o pedido continua reembolsado.

Reembolso e chargeback saem do faturamento?

Saem. O faturamento, o lucro e o ROAS contam só pedidos pagos. Quando chega o reembolso ou o chargeback, o pedido muda de estado e deixa de contar — e o painel mostra o valor reembolsado e o número de chargebacks à parte, para a queda não parecer sumiço.

A compra pode ser enviada em dobro para a Meta?

Não. O Purchase sai do servidor, uma vez por pedido, no momento em que o pagamento é confirmado — nunca do navegador no clique de comprar, que contaria venda que ainda pode ser recusada. Cada pedido tem um identificador de evento fixo, e o banco não aceita o mesmo identificador duas vezes para o mesmo pixel. O valor enviado é o que sobra para você, não o que o comprador pagou.

E a venda que chega sem o clique registrado?

A origem é procurada em três níveis, nesta ordem de confiança: o clique registrado pelo script na página, que traz campanha, conjunto, anúncio e os identificadores da Meta; os ids de campanha, conjunto e anúncio que o script empacota no campo livre do checkout — na Hotmart e na Cakto —, que chegam mesmo quando um bloqueador impediu o registro do clique; e as UTMs que a própria plataforma devolve. Sem nenhum dos três, a venda entra no faturamento marcada como sem origem, e a contagem dessas vendas fica à vista — ela não some do relatório.

Como sei se uma integração falhou?

Toda chamada de webhook e da API fica registrada na tela de Eventos do painel, com o resultado: entrou, foi ignorada (e por quê) ou deu erro. Uma chamada sem a assinatura certa da plataforma é recusada e não entra depois por insistência. Venda que a nossa leitura não conseguiu interpretar fica guardada com o conteúdo original por 90 dias e é reprocessada pelo mesmo caminho depois que a leitura é corrigida — ela não se perde por um erro nosso.

E um status de pagamento que vocês não conhecem?

Não entra por aproximação. Tratar uma recusa como aprovação inflaria o faturamento sem ninguém perceber, então um estado que a leitura não reconhece fica registrado em Eventos em vez de virar venda. Na API de envio de vendas ele volta como erro, para quem integrou corrigir na hora.

Venda de teste aparece no faturamento?

Não. Na API, a venda marcada com isTest é gravada, mas como teste. Os botões de teste de webhook da Hotmart, da Cakto e da Wiapy mandam uma venda de exemplo que é reconhecida e tratada do mesmo jeito. Venda de teste fica fora do Resumo, dos relatórios, da contagem do plano e do Purchase enviado à Meta.

O que acontece com as vendas que passam do limite do plano?

Nos planos pagos, ninguém é bloqueado: a venda entra normal e o excedente é cobrado na fatura do fim do ciclo, com aviso antes. No Gratuito não há cobrança: a venda que passa do limite fica guardada, e assinar libera o histórico inteiro de volta. Em nenhum dos dois casos uma venda é descartada.

Para conferir por conta própria

Tudo o que esta página descreve aparece na tela de Eventos do painel, chamada por chamada. Para quem integra pela API, o contrato completo — incluindo reenvio e códigos de erro — está em Envio de vendas. O passo a passo de cada plataforma está em plataformas compatíveis.