Conversões personalizadas

Objetivo: enviar às plataformas de anúncio e de medição a conversão certa, na hora certa. Por exemplo, avisar uma compra só quando a loja confirmar o pagamento.

A tela Conversões tem cinco seções: Visão geral, Fontes, Destinos, Regras e Entregas. Uma conversão nasce da combinação de três peças:

Fonte: de onde vem o aviso de que algo aconteceu.
Destino: a plataforma que recebe o aviso.
Regra: quando enviar.

O que você precisa

Acesso ao projeto e permissão para gerenciar conversões.
Para o destino Meta: o ID do pixel e um token de acesso da API de Conversões.
Para o destino Google Analytics 4: o ID de medição (começa com G-) e o segredo da API.
Para o destino TikTok: o código do pixel e um token de acesso da Events API.

Modo de registro

Por padrão, o envio fica em modo de registro: nada é enviado às plataformas até a configuração do servidor liberar o envio real. As entregas ficam gravadas na tela para você conferir o que seria enviado. A Visão geral mostra em qual modo você está: “Modo de registro”, “Envio real ativo” ou “Modo de registro até prova em contrário”, quando ainda não há entregas nos últimos 7 dias.

Passo 1: criar uma fonte

Abra Conversões e clique em Fontes.
Clique em Nova fonte.
Em Nome da fonte, dê um nome fácil de reconhecer.
Em Como o aviso chega, escolha uma das opções:
- Eventos da loja: os pedidos e negócios que a owiew já recebe. Não precisa de segredo. Se aparecer “Os eventos da loja ainda não estão ligados”, clique em Ativar eventos da loja.
- Webhook assinado (recomendado): o seu sistema assina cada envio com um segredo.
- Webhook com segredo no endereço, em opções avançadas: só para sistemas que não sabem assinar. O segredo pode ficar gravado no registro de erros do servidor de entrada, e quem enxergar esse registro consegue enviar avisos falsos.
Clique em Criar fonte.

Para webhooks, a tela mostra o Endereço de recepção e o Segredo uma única vez. Copie os dois antes de clicar em Já guardei, fechar. Depois não dá para ver de novo, só criar outra fonte.

No sistema que avisa, envie o corpo do pedido em JSON e, no cabeçalho indicado na tela, a assinatura HMAC-SHA256 do corpo feita com o segredo.

Exigir carimbo de data e hora

Em cada fonte assinada você pode ligar Exigir carimbo de data e hora (recomendado). Nesse modo o sistema emissor manda também o cabeçalho X-Owiew-Timestamp com os segundos Unix do envio. A assinatura passa a ser o HMAC-SHA256 de “carimbo.corpo” (o carimbo, um ponto e o corpo exato), e o carimbo precisa estar a até 5 minutos do relógio da owiew. Assim, um envio capturado por alguém não pode ser repetido depois.

Avise antes quem cuida do sistema que envia. Se ele ainda não manda o cabeçalho, todas as entregas da fonte passam a ser recusadas assim que você confirmar.

Passo 2: cadastrar um destino

Abra Destinos e clique em Novo destino.
Em Plataforma, escolha Meta, API de Conversões, Google Analytics 4, Measurement Protocol ou TikTok, Events API.
Dê um Nome do destino.
Preencha o identificador da plataforma: ID do pixel (conjunto de dados), ID de medição ou Código do pixel.
Cole a credencial: token de acesso ou Segredo da API (api_secret). Ela é guardada cifrada e nunca aparece de novo. Para trocar, cole a nova.
Escolha o Modo:
- Modo teste: os eventos chegam marcados como teste e não contam nos relatórios da plataforma. Meta e TikTok exigem o Código de teste copiado do Gerenciador de Eventos. Sem ele, o modo teste não envia nada.
- Modo real: os eventos contam de verdade. Só saem quando o envio real estiver liberado na configuração do servidor.
Mantenha Destino ativo marcado e clique em Salvar destino.

Passo 3: montar a regra

Abra Regras e clique em Nova regra. Se faltar fonte ou destino, a tela leva você a criá-los.
Dê um Nome da regra.
Em Quando disparar, escolha a Fonte e o Acontecimento: pedido pago, pedido criado, pedido cancelado, pedido reembolsado, negócio qualificado (lead), negócio ganho ou negócio perdido. Para webhooks próprios, informe o Nome do evento do webhook, com letras minúsculas, números, ponto, traço e dois-pontos.
Em Condições, se quiser, restrinja quando a regra vale. Todas precisam valer ao mesmo tempo. Sem condições, todo acontecimento dispara a regra. Dá para comparar o valor do pedido, a moeda, o SKU, a origem e a campanha da UTM, os identificadores de clique (fbclid, gclid, ttclid) e o consentimento.
Em Para onde enviar, escolha de 1 a 10 destinos. Para cada um, informe o Nome do evento na plataforma (por exemplo Purchase e Lead na Meta, purchase e generate_lead no GA4, CompletePayment e SubmitForm no TikTok), o Valor da conversão e a Moeda.
Em Consentimento da pessoa, decida o que fazer quando o evento não traz base legal para enviar dados pessoais: Não enviar dados da pessoa (envia só o evento) ou Descartar o evento.
Em Evitar repetição por, escolha o prazo. O padrão é 7 dias: o mesmo pedido avisado de novo dentro dele não vira outra conversão.
Clique em Salvar regra.

A regra nasce desligada. Antes de ligar, use Testar a regra: cole ou edite um evento de exemplo em JSON e veja o que a regra enviaria. Nada é enviado nem gravado no teste. Dados da pessoa entram só como código protegido (SHA-256), nunca como e-mail ou telefone em claro. Quando estiver certa, marque Regra ativa.

Acompanhar as entregas

Na seção Entregas, cada aviso aparece com o resultado:

Situação	O que significa
Enviada	Saiu para a plataforma e ela aceitou.
Gravada	Modo de registro: ficou só gravada, nada saiu.
Na fila	Aguardando o envio ou uma nova tentativa.
Falhou	Não foi possível enviar. Fica na fila de falhas até alguém reenviar.
Descartada	Não foi enviada de propósito.

Uma entrega descartada traz o motivo: já foi enviada antes (mesmo pedido e evento), passou do prazo que a plataforma aceita para eventos atrasados, o destino foi apagado ou estava desligado, o valor ou a moeda não puderam ser lidos, a pessoa recusou marketing, ou o evento não trouxe base legal.

Filtre por situação, regra e destino. Abra Ver detalhe para ver o evento enviado, o número de tentativas, o último erro e o resumo da resposta da plataforma. Para uma entrega que falhou, clique em Reenviar. Ela volta para a fila, e só vale dentro do prazo que a plataforma aceita eventos atrasados.

Resultado esperado

Ao ativar a regra, cada acontecimento que atende às condições gera uma entrega por destino, visível em Entregas.

Se algo der errado

Nada é enviado. Sem regra, nada é enviado. Confira se a regra, a fonte e o destino estão ativos e se o painel não está em modo de registro.
Todas as entregas da fonte são recusadas. Provavelmente o carimbo de data e hora foi exigido e o emissor ainda não o manda, ou o relógio dele está fora da janela de 5 minutos.
A plataforma recusou o evento. A credencial ou os dados estão errados. Veja o último erro no detalhe da entrega e troque a credencial no destino.
Não consigo apagar uma fonte ou um destino. Ainda há regras usando o item. Mude ou apague as regras primeiro.
Muitas tentativas seguidas. Espere um instante e tente de novo.