Software / 7 min de leitura

Rastreamento S2S por postback: checklist de integração

Preserve IDs de atribuição, trate duplicidades e mudanças de status e comprove a entrega com um teste repetível.

Preserve a identidade do clique à conversão

Um postback servidor a servidor informa uma conversão de um backend a outro. Ele ainda precisa de um vínculo de atribuição. Capture o ID de clique ou transação da plataforma no ponto de entrada combinado e guarde-o com o lead ou pedido antes de redirecionamentos, callbacks ou atualizações no CRM. O postback não recria um identificador perdido pelo seu sistema.

Mapeie ID de clique, seu ID da conversão comercial, oferta, evento, status, valor, moeda e horário do evento. Separe comissão de valor do pedido. Everflow documenta IDs de transação criados no clique; Affise diferencia clickid e action_id. Use os parâmetros e regras de codificação reais de cada destinatário, sem presumir um esquema universal.

Defina eventos, mudanças de status e duplicidades

Combine o significado de envio, aprovação, rejeição, retenção e pagamento nesta integração. Os status da plataforma não correspondem automaticamente às etapas do CRM. Defina quais transições criam ou atualizam a conversão ou mudam o valor remunerável. Documente aprovações tardias, estornos e mensagens fora de ordem; um lead recebido não é necessariamente aprovado ou remunerável.

Defina um identificador estável para o evento comercial e as regras de deduplicação do destinatário. Reenviar o mesmo evento não deve gerar outra comissão; uma compra repetida legítima precisa ser distinguível. Teste esses casos. Não trate uma atualização de status como nova venda nem descarte uma rejeição posterior porque o ID de conversão já existe.

Torne a entrega observável e recuperável

Use endpoints HTTPS autenticados e mantenha segredos fora de URLs públicas e logs rotineiros. Confirme timeout, resposta de sucesso e comportamento de novas tentativas com cada remetente e destinatário. No seu próprio processo de envio, persista o evento, limite tentativas com intervalos crescentes para falhas transitórias e destaque tentativas esgotadas para conciliação. Corrija erros permanentes de validação antes de reenviar.

Logs mínimos úteis incluem horários UTC de recebimento e evento, IDs de correlação e conversão, oferta, evento, status, valor e moeda, número da tentativa, resposta HTTP e resultado da validação. Oculte credenciais e dados pessoais desnecessários. Sucesso HTTP sozinho não comprova atribuição: examine a conversão registrada e seu status no relatório de destino.

Teste a jornada completa e concilie

Teste um caminho válido de clique a lead e aprovação, IDs ausentes ou malformados, entrega duplicada, reversão de status, oferta ou evento errados, conversão atrasada e falha temporária do endpoint. Compare um evento comercial esperado com um resultado registrado e o valor correto. Concilie fonte, rastreador e CRM pela mesma coorte e fuso antes de ampliar os gastos.

A documentação de Affise e Everflow sustenta os exemplos de plataforma. Sales Machine é uma ficha relacionada de CRM de leads com demonstração privada; o comportamento de sua integração em produção não foi verificado neste guia. Peça uma demonstração de armazenamento de IDs, mapeamento de status, tentativas e exportações usando este checklist antes de considerar o fluxo confirmado.

Fontes

Everflow — Understanding Tracking With Server To Server Postbacks (checked 17 November 2026) ↗Everflow — Conversions Error Code Reference Guide (checked 17 November 2026) ↗Everflow — Managing Postbacks As A Partner (checked 17 November 2026) ↗Affise — Server postbacks in statistics (checked 17 November 2026) ↗Affise — Conversion statuses (checked 17 November 2026) ↗Affise — Affiliate postback sending logic (checked 17 November 2026) ↗

Produtos relacionados

Sales Machine↗Affise↗Everflow↗