Destinos de conversão (CAPI): devolver a venda para a plataforma
O que é um destino, como ele é disparado, o mapa de eventos, o estado pausado/ativo, o botão testar, a auditoria de envios e as garantias — o envio nunca bloqueia o postback.
O postback traz a venda para dentro do Affilitrack. O destino de conversão leva essa venda de volta para a plataforma de anúncios, pelo servidor, para que o algoritmo dela otimize por conversão real. É o que faz uma campanha escalar: sem isso, a Meta e o Google só sabem dos cliques.
Menu Integrações CAPI (Destinos de conversão).
Plataformas disponíveis
| Destino | O que envia | Chave de correspondência |
|---|---|---|
| Meta — Conversions API | Evento (Lead, Purchase, Schedule…) com valor, moeda, event_id, IP e user agent do clique, e fbc montado a partir do fbclid. | fbclid do clique |
| Google Ads — conversões offline | Upload de conversão com gclid (ou gbraid/wbraid), ação de conversão, valor, moeda e data/hora. | gclid do clique |
Criar um destino
+ Novo destino › escolha a Plataforma e dê um Nome. O destino nasce pausado. Na tela seguinte (editar) você preenche as credenciais e o mapa de eventos, e só então ativa.
A lista mostra Destino, Conta, Eventos, Status, Último envio e as ações testar, ativar/pausar, editar, excluir. Enquanto faltar credencial, a linha avisa o que falta (falta pixel_id, access_token).
As credenciais de cada plataforma estão em Meta Conversions API e Google Ads off-line.
Mapa de eventos
À esquerda, o evento como chega no postback (agendamento, lead, venda); à direita, o nome que a plataforma espera: na Meta, o evento padrão (Schedule, Lead, Purchase); no Google, o resource name completo da ação de conversão (customers/1234567890/conversionActions/987654321).
Tipos sem linha no mapa não são enviados para aquele destino. Isso é útil: você pode mandar só venda para o Google e lead + venda para a Meta.
Se o tipo tem papel definido em Tipos de conversão, o papel é a sugestão natural para o lado direito na Meta.
Quando o envio acontece
Sempre que um postback resulta em created para um tipo mapeado, e o destino está ativo. O envio é assíncrono: sai em segundo plano logo após a gravação da conversão e nunca bloqueia nem falha o postback. Se a Meta ou o Google estiverem fora do ar, a conversão continua gravada no Affilitrack; o envio falha e aparece em Envios recentes.
duplicate não gera envio — nem quando muda o status. Estornos não são enviados (as plataformas não têm evento de estorno via API para esse fim).
A guarda de plataforma
O fbc da Meta só é montado se o ref_id do clique tem a forma de um fbclid; o gclid do Google só é usado se tem a forma de um gclid. Um clique do Google não vira fbc, e vice-versa. Quando isso acontece, o evento é enviado mesmo assim (com IP e user agent como sinais), o identificador é omitido, e o motivo fica na coluna Observação. Veja Guarda de plataforma.
Testar
O botão testar dispara um evento de teste para o destino usando um click_id real e mostra a resposta da plataforma na hora. Na Meta, preencha o código de teste (test event code) no destino para que o evento apareça na aba de eventos de teste do Gerenciador de Eventos sem contar como conversão. Pela API: POST /api/destinos/{id}/testar com click_id, tipo_evento, valor e test_event_code.
Auditoria: Envios recentes
Abaixo da lista, Envios recentes registra cada tentativa com destino, evento, resultado (ok/falha), a resposta da plataforma e a Observação. Filtros todos / só ok / só falha. Pela API: GET /api/envio-logs com destino_id, ok e limit.
Falhas típicas e o que significam:
| Resposta | Causa |
|---|---|
401/190 (Meta) | Access token inválido ou expirado. |
400 com event_name | Nome do evento no mapa não é um evento padrão da Meta. |
PERMISSION_DENIED (Google) | Developer token não aprovado, ou a conta não tem acesso à ação de conversão. |
INVALID_ARGUMENT com conversion_action | Resource name errado no mapa. |
| Observação: ref_id do clique não é fbclid | Click Ref ID da fonte com a macro errada. |
Um destino por conta
Crie um destino por pixel (Meta) ou por conta de anúncios (Google). Workspaces diferentes têm destinos diferentes. Um workspace pode ter vários destinos ativos — cada conversão é enviada a todos os que mapeiam o tipo dela.