For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/guides/pixel-server-side-events.md.
  • Português
  • Por que alguns eventos chegam ao Meta mesmo com bloqueador de anúncios?

    Porque eles não saem do navegador do visitante. A Clickmax envia esses eventos dos próprios servidores para a Meta, pela API de Conversão — o visitante pode ter bloqueador de anúncios, ter recusado cookies ou fechado a aba antes do disparo, e a conversão chega igual.

    É por isso que o total de conversões da Meta pode ficar maior do que o de qualquer ferramenta que meça só pelo navegador. Não é contagem em dobro: é a parte que o navegador não conseguia reportar.

    Antes de começar

    • Vale para pixel da Meta. O Google Ads recebe eventos só pelo navegador.
    • O envio pelo servidor exige a opção Usar API de Conversão ligada e um Token de acesso válido no pixel.
    • Para a lista completa dos eventos e o nome de cada um na Meta, veja quais eventos a Clickmax envia para o meu pixel.

    Os dois caminhos de um evento

    CaminhoQuem enviaDepende do visitante
    NavegadorO código do pixel na páginaSim — bloqueador, recusa de cookies ou aba fechada impedem o envio
    API de ConversãoOs servidores da ClickmaxNão

    Quando o mesmo evento vai pelos dois caminhos, a Clickmax manda o mesmo identificador de evento nas duas pontas e a Meta conta uma conversão. Você não precisa desligar um dos canais.

    O que a API de Conversão consegue enviar que o navegador não

    Alguns fatos do seu negócio simplesmente não acontecem em uma página aberta — e antes eles nunca chegavam à Meta:

    EventoAcontece quandoPor que o navegador não daria conta
    PurchaseA compra é aprovada — só a primeira cobrança; renovação de assinatura não contaPix e boleto são confirmados horas depois, com o visitante longe do site
    StartTrialComeça um período de testeA confirmação vem do processamento do pagamento, não de um clique
    SubscribeA assinatura é ativadaA ativação também vem do processamento do pagamento
    LeadUma pessoa vira leadInclui lead que entrou por integração, sem passar por uma página sua
    ScheduleUm agendamento é confirmadoA confirmação pode vir de outro canal
    ContactO lead fala com o seu negócioConversa no WhatsApp, ligação atendida e e-mail aberto acontecem fora do site
    Purchase (ou o evento que você escolher)Uma oportunidade é ganha num pipeline vinculado ao pixelA venda é fechada pelo seu time, longe de qualquer página — veja mandar a venda fechada no pipeline
    O evento escolhido na etapaUm contato entra numa etapa do pipeline com evento de pixelA mudança de etapa acontece no CRM — veja mandar uma conversão quando um contato entra numa etapa

    PageView e ViewContent continuam saindo somente pelo navegador. São os eventos de maior volume e menor poder de identificação: enviá-los também pelo servidor gastaria a cota da sua conta de anúncio sem melhorar a atribuição.

    Renovação de assinatura não vira compra

    Quando uma assinatura é renovada, a cobrança do ciclo seguinte não é enviada como Purchase. Só a primeira cobrança conta como compra. A renovação não é efeito do anúncio — a pessoa já era cliente —, e contá-la todo mês faria a campanha aprender a buscar quem já comprou em vez de clientes novos.

    Onde a Meta entende que cada evento aconteceu

    Cada evento vai com a origem do fato, para a Meta tratar cada um do jeito certo:

    EventoA Meta recebe como
    Compra, teste, assinatura, lead de formulário, agendamento, clique em link de redirecionamento, webinárioEvento de site, com o endereço da página onde aconteceu
    Lead que entrou por link de captaçãoEvento de outra origem — o lead veio de um sistema seu, não de uma página da Clickmax
    Conversa iniciadaEvento de conversa; quando a pessoa chegou por um anúncio de clique para WhatsApp, evento de conversa daquele anúncio
    Ligação atendidaEvento de ligação
    Clique em link de e-mailEvento de e-mail
    Oportunidade ganha e etapa do pipelineEvento registrado pelo CRM, no formato que a Meta usa para estágios de lead

    O horário enviado é o do fato — a hora da compra, da captura, do clique —, não a hora em que o envio saiu. A Meta só aceita eventos dos últimos 7 dias; um envio que atrasou mais que isso não é feito e aparece como Não enviado no Histórico de envio do pixel, sem derrubar os outros eventos.

    Anúncio de clique para WhatsApp

    Quando o clique mais recente do contato num anúncio, nos últimos 7 dias, foi num anúncio de clique para WhatsApp, a conversa iniciada e os eventos do CRM dele (oportunidade ganha, etapa do pipeline) vão para a Meta como conversão daquele anúncio, e não como visita de página.

    Para isso o número de WhatsApp que recebeu a conversa precisa estar conectado à Clickmax com a conta do WhatsApp Business identificada. Na Meta, o conjunto de dados do pixel precisa estar ligado à mesma conta do WhatsApp Business no Gerenciador de Eventos — sem isso a Meta não consegue ligar a conversa ao anúncio. Quando falta a conta do WhatsApp Business, o evento vai como conversa comum.

    O que cada evento exige para chegar de fato

    Três condições, todas no pixel:

    • Estar ligado no pixel. Um pixel que você criou já nasce com todos os eventos ligados. Um pixel que veio da configuração antiga, feita por produto, mantém exatamente os eventos que já tinha — os novos ficam desligados até você ativá-los, para não mudar a base de otimização de uma campanha no ar.
    • Ter o Token de acesso. Sem Usar API de Conversão ligada e um token válido, o evento sai só pelo navegador. É o caso mais comum de "a Meta não recebeu minha venda no Pix".
    • Passar pelos filtros do próprio evento. Purchase respeita o Método de pagamento: se você desmarcou Pix, uma venda paga no Pix não gera evento em nenhum dos caminhos.

    Qualidade do dado nos dois caminhos

    O envio pelo servidor carrega os dados que a pessoa informou no checkout (e-mail, telefone, documento, endereço), o que ajuda a Meta a reconhecer quem converteu. O que faltar no checkout — como o clique no anúncio quando a pessoa paga o Pix depois de sair da página — é completado com o que o contato tem. Nos eventos que nascem fora do checkout — lead, agendamento, contato, oportunidade ganha — vai o que existir no contato: e-mail, telefone, cidade e estado do cadastro, o clique no anúncio da Meta mais recente em qualquer aparelho em que o contato foi reconhecido (inclusive de antes de ele se identificar, e o da própria visita em que ele preencheu o formulário) e o identificador do navegador que o pixel da Meta criou nas suas páginas. Quanto mais completo o contato, melhor a atribuição.

    O telefone vai com o código do país — um celular brasileiro cadastrado sem o 55 é completado. Cidade e estado vão no formato que a Meta compara ("Minas Gerais" vira MG). A Meta também recebe o mesmo identificador do contato em todos os eventos dele, do lead à compra, para ligar uns aos outros.

    Eventos do CRM (oportunidade ganha, etapa do pipeline), ligação e conversa não vão com o navegador nem o endereço de internet de uma visita antiga do contato: eles não aconteceram num navegador.

    Um evento enviado pelo servidor não aparece nas ferramentas que inspecionam a página, como o Meta Pixel Helper: ele não passou pelo navegador. Para conferir, use o Gerenciador de Eventos da Meta — o caminho está em como testar se o pixel está disparando.