Destinos, regras e entregas de conversões

Depois que uma fonte recebe um evento, as regras decidem quando enviar e para qual destino. Esta página cobre destinos, regras, modos de envio, deduplicação e como saber se cada conversão chegou.

Fontes, destinos e regras são configurados no painel, em Conversões. As rotas de gestão exigem a sessão de uma pessoa do projeto com permissão de gerenciar conversões (leitura e teste exigem permissão de leitura). Elas não aceitam chave de API e não são públicas. O que é público para integração é a recepção por webhook.

O que você precisa

Uma fonte já criada.
A credencial da plataforma de destino.
Permissão de gerenciar conversões no projeto.

Cadastrar um destino

Em Conversões, aba Destinos, clique em Novo destino e escolha a plataforma.

Plataforma	Campo de identificação	Credencial
Meta, API de Conversões	ID do pixel (conjunto de dados), só números	Token de acesso da API de Conversões
Google Analytics 4, Measurement Protocol	ID de medição, começa com `G-`	Segredo da API (`api_secret`)
TikTok, Events API	Código do pixel	Token de acesso da Events API

A credencial é guardada cifrada e não aparece de novo. Deixe o campo em branco para manter a atual numa edição.

Modo teste e modo real

Todo destino nasce em Modo teste: os eventos chegam à plataforma marcados como teste e não contam nos relatórios dela.

Meta e TikTok exigem o Código de teste do Gerenciador de Eventos. Sem ele, em modo teste, a plataforma não recebe nada.
O Google Analytics 4 ignora o código de teste e usa o endpoint de depuração.

Mude para Modo real só depois de conferir as entregas.

O envio real tem um freio global

Mesmo com o destino em modo real, o envio às plataformas só acontece quando o envio real está ativo no ambiente. Enquanto não estiver, as conversões ficam apenas gravadas: o painel mostra Modo de registro e as entregas aparecem como Gravada. Quando o envio real está ativo, o painel mostra Envio real ativo.

Criar uma regra

Em Regras, clique em Nova regra.

Campo	O que faz
Nome da regra	Nome fácil de reconhecer.
Quando disparar	A fonte e o acontecimento. Para webhook, `webhook:<nome-do-evento>`. Para lojas, `pedido.pago`, `negocio.ganho` ou `negocio.qualificado`.
Condições	Até 20, todas precisam valer (E). Operadores: `=`, `!=`, `>`, `>=`, `<`, `<=`, `contem`, `existe`, `em`. O campo é um caminho no evento, por exemplo `pedido.itens.0.sku` ou `dados.canal`.
Para onde enviar	De 1 a 10 destinos. Para cada um, o nome do evento na plataforma (Meta: `Purchase`, `Lead`; GA4: `purchase`, `generate_lead`; TikTok: `CompletePayment`, `SubmitForm`), de onde sai o valor e a moeda.
Janela de deduplicação	De 1 hora a 30 dias. Padrão de 7 dias.
Política de consentimento	`agregado` (padrão) ou `exigir`.
Base legal padrão	Opcional. Veja abaixo.

A regra nasce desligada. Use o botão de teste para ver o que ela enviaria a partir de um envelope de exemplo. O teste não grava nem envia nada. Ligue a regra quando o resultado estiver certo.

Consentimento e base legal

Dados da pessoa (e-mail, telefone, nome, CEP) só viajam para a plataforma com base legal. A decisão segue estas regras:

consentimento.marketing = false no evento sempre vence e descarta o dado da pessoa.
Se o evento traz consentimento.base_legal ou consentimento.marketing, vale o que ele traz.
Se não traz (caso comum de lojas), vale a Base legal padrão da regra: consentimento_coletado_pelo_anunciante, execucao_de_contrato ou legitimo_interesse. Vazio significa não enviar dado da pessoa sem consentimento.
execucao_de_contrato só libera o envio em plataformas que aceitam a base de contrato, como o GA4.

A base usada fica registrada na entrega, para auditoria.

Deduplicação

Há duas camadas:

Na recepção: a mesma combinação de fonte, evento e id_externo é aceita uma vez.
No envio: cada regra tem a sua janela de deduplicação por evento e destino. Uma segunda tentativa dentro da janela aparece como Descartada, com o motivo “Já foi enviada antes (mesmo pedido e evento)”.

Saber se chegou: a aba Entregas

Cada envio planejado gera uma entrega. Filtre por situação, regra e destino.

Situação	Significa
Enviada	Saiu para a plataforma e ela aceitou.
Gravada	Modo de registro: ficou só gravada, nada saiu. O detalhe mostra a requisição que seria feita.
Na fila	Aguardando envio ou 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.

Motivos de descarte mostrados no detalhe: já enviada antes; passou do prazo que a plataforma aceita para eventos atrasados; destino apagado ou desligado; valor ou moeda ilegíveis; várias tentativas em 24 horas sem sucesso; a plataforma recusou o evento (credencial ou dados); marketing recusado; falta de base legal.

Para uma entrega que Falhou, use Reenviar: ela volta para a fila, desde que ainda esteja dentro da janela da plataforma. Depois atualize a lista.

O detalhe da entrega mostra o evento enviado, o resumo da resposta da plataforma, as tentativas e o último erro. Para conferir do lado da plataforma, use o Gerenciador de Eventos da Meta ou do TikTok com o código de teste, e o relatório de depuração do GA4.

Problemas comuns

Sintoma	O que verificar
Tudo aparece como Gravada	O envio real não está ativo no ambiente. O painel mostra o modo.
Meta ou TikTok não mostram o evento de teste	Falta o código de teste no destino em modo teste.
Falhou com recusa da plataforma	Token ou `api_secret` inválido ou sem permissão; ID do pixel ou de medição errado.
Evento sem dados da pessoa na plataforma	Falta base legal na regra ou no evento, ou marketing recusado.
Descartada por prazo	O evento é mais antigo do que a plataforma aceita.
Não consigo apagar uma fonte ou um destino	Uma regra ainda os usa. Mude ou apague a regra primeiro.