Rastreamento server-side em Voluum, RedTrack e Keitaro
Um guia prático de HowTo para montar rastreamento server-side em Voluum, RedTrack e Keitaro com postbacks limpos, encaminhamento CAPI, deduplicação, verificações de QA e notas de compliance.
4,490+
Videos & Ads
+50-100
Fresh Daily
$29.90
Per Month
Full Access
7.4 TB database · 57+ niches · 12 min read
Rastreamento server-side: a resposta prática
O rastreamento server-side em Voluum, RedTrack e Keitaro significa que a rede de afiliados envia os dados de conversão para o seu tracker por meio de um postback server-to-server, e então o tracker pode encaminhar um evento limpo para as plataformas de anúncios via APIs de conversão. A expressão server side tracking voluum normalmente se refere exatamente a esse fluxo: capturar o clique, armazenar o click ID do tracker, receber o payout da rede, deduplicar a conversão e encaminhar apenas eventos válidos.
O trabalho não é fazer com que os números de todas as plataformas coincidam perfeitamente. O trabalho é criar um pipeline de eventos confiável em que cada sistema consiga explicar de onde veio um clique, uma conversão, um payout e um evento de API encaminhado. Este guia amplia o hub de rastreamento server-side para afiliados com verificações de configuração específicas de tracker para Voluum, RedTrack e Keitaro.
Etapa 1: mapear o pipeline de eventos antes de editar as configurações
Resultado: você saberá quais identificadores saem da plataforma de anúncios para o tracker, do tracker para a rede e do tracker de volta para as APIs da plataforma de anúncios.
A maioria das configurações quebradas falha porque a equipe começa dentro de um painel sem um mapa de campos. Um mapa de rastreamento deve mostrar a origem do clique, o identificador armazenado, a origem da conversão, o endpoint de destino e a chave de deduplicação. Mantenha isso em um documento compartilhado antes de qualquer comprador alterar URLs de campanha.
Definir os IDs necessários
No mínimo, preserve um identificador de clique da plataforma, um identificador de clique do tracker e um identificador de transação da rede. Para Meta, isso pode incluir fbclid ou metadados do evento. Para Google Ads, isso pode incluir gclid quando relevante. Para o tracker, o valor crítico é o click ID exclusivo passado para a URL da oferta como o subid da rede ou o token clickid.
O click ID do tracker é a ponte entre o clique de saída e o postback da rede. Se esse valor for removido por um redirecionamento, construtor de páginas, encurtador de links ou erro de macro na URL da oferta, o postback posterior não poderá ser atribuído com confiabilidade.
Padronizar nomes de eventos e regras de valor
Use um pequeno dicionário de eventos. Por exemplo, lead, trial_start, purchase e rebill devem ter um único significado documentado cada. Não permita que uma rede use sale para uma compra aprovada enquanto outra usa o mesmo rótulo para um lead pendente.
Mantenha a lógica de valor igualmente simples. Uma regra prática é encaminhar o payout real em tempo real para eventos aprovados e manter o lifetime value estimado no relatório, não dentro do mesmo fluxo de evento de otimização. Lógicas de valor misturadas podem treinar sistemas de lance com sinais instáveis.
Definir janelas de aceitação realistas
Um funil de afiliado de resposta direta costuma ver conversões no mesmo dia, mas faturamento atrasado, verificação por call center e janelas de reembolso podem estender os relatórios. Como estimativas operacionais, permita de 1 a 7 dias para muitos caminhos de clique até conversão e de 14 a 30 dias para funis de aprovação atrasada.
Para QA, defina faixas aceitáveis de discrepância antes do lançamento. Uma lacuna estimada de 5-15% entre as conversões do tracker e os eventos reportados pela plataforma pode ser normal dependendo da perda de consentimento, da correspondência via API, das janelas de atribuição e dos eventos rejeitados. Uma mudança súbita fora da faixa normal é mais útil do que uma única divergência diária.
Etapa 2: construir um contrato de postback confiável
Resultado: a rede pode enviar ao tracker apenas dados de conversão completos e deduplicados.
Uma URL de postback é o callback da rede para o tracker que registra o resultado comercial de um clique. O encaminhamento CAPI é o evento de API do tracker para a plataforma que ajuda os sistemas de anúncios a atribuir e otimizar com sinais server-side. Trate-os como etapas separadas do mesmo pipeline.
Campos obrigatórios do postback
Use chaves internas padronizadas mesmo quando cada rede tiver nomes de token diferentes:
| Campo | Finalidade | Regra de exemplo |
|---|---|---|
cid |
Click ID do tracker | Obrigatório para atribuição |
txid |
ID da transação da rede | Obrigatório para deduplicação |
payout |
Valor da receita ou comissão | Numérico, não negativo, a menos que a lógica de reembolso seja explícita |
currency |
Moeda do payout | Código no estilo ISO, como USD ou EUR |
status |
Estado da conversão | Pendente, aprovado, rejeitado, reembolsado |
event_time |
Carimbo de tempo da conversão | Armazenar em UTC na ingestão |
Rejeite ou isole callbacks incompletos. É melhor investigar um campo ausente do que poluir o tracker com eventos de receita anônimos.
Deduplicar e lidar com mudanças de status
O ID da transação deve ser a chave primária de deduplicação para vendas aprovadas. Se uma rede enviar um evento pendente e depois o atualizar para aprovado, atualize o estado existente da transação em vez de criar uma segunda conversão.
Como alerta prático, IDs de transação aprovados duplicados acima de uma estimativa de 1-2% normalmente indicam postbacks reenviados, erros de mapeamento de token ou um fluxo de atualização de aprovação sendo tratado como uma nova venda. Para reembolsos e chargebacks, documente se o evento reverte receita, altera o status ou cria um evento separado de ajuste.
Preservar o contexto de compliance
Mantenha detalhes de consentimento, jurisdição, origem, oferta e timestamp disponíveis para revisão de auditoria. O evento técnico não deve ficar separado da base de compliance para processá-lo e encaminhá-lo. Use a metodologia de rastreamento da Daily Intel Service como ponto de referência interno para manter evidências, premissas e notas de revisão em um só lugar.
Etapa 3: configurar o Voluum para postbacks S2S e encaminhamento CAPI
Resultado: o Voluum recebe conversões da rede, registra a receita com precisão e encaminha apenas os eventos mapeados para as plataformas de anúncios.
O Voluum costuma ser a escolha mais rápida quando as equipes querem um rastreamento gerenciado, templates de campanha padronizados e relatórios operacionais limpos. Sua força depende de um repasse disciplinado de tokens, e não apenas de ativar uma integração.
Capturar o click ID do Voluum
Comece pelo template da fonte de tráfego. Confirme que os parâmetros da plataforma de anúncios estão presentes na URL da campanha e que o Voluum gera seu próprio click ID antes de o visitante chegar à oferta.
Depois confirme que a URL da oferta passa esse click ID do Voluum para o campo subid aceito pela rede. Execute de 20 a 50 cliques de teste de baixo risco pelo mesmo caminho de redirecionamento usado em produção. Esse tamanho de amostra é uma estimativa operacional, mas normalmente é suficiente para revelar parâmetros removidos, macros malformadas ou regras de redirecionamento que se comportam de maneira diferente por dispositivo.
Ingerir corretamente os postbacks da rede
Configure o endpoint de postback da rede com os campos obrigatórios de click ID, transaction ID, payout, currency, status e timestamp. Mapeie de forma intencional os estados pending, approved, rejected e refunded.
Não conte eventos pending e approved como tendo o mesmo valor, a menos que o modelo de compra realmente pague por leads pendentes. Se a rede paga somente após aprovação, a receita deve aparecer apenas quando a transação for aprovada ou se tornar faturável de outra forma sob os termos da oferta.
Encaminhar eventos do Voluum para APIs da plataforma
Ao encaminhar para Meta Conversions API, Google enhanced conversions ou importações de conversões offline, TikTok Events API ou endpoints semelhantes, direcione cada resultado da rede para um único evento de destino. Uma compra paga não deve disparar automaticamente tanto Lead quanto Purchase, a menos que a estratégia da campanha precise explicitamente de ambos e a deduplicação esteja documentada.
Use campos de usuário com hash apenas onde houver base legal e qualidade de dados suficiente para tornar o matching útil. A documentação da plataforma muda com o tempo, então mantenha as notas de implementação vinculadas às páginas oficiais de ajuda do Meta Conversions API e aos fluxos de importação de conversões do Google Ads.
Etapa 4: configurar o RedTrack para encaminhamento gerenciado de eventos
Resultado: o RedTrack recebe postbacks validados da rede e envia sinais estáveis server-side para as plataformas de anúncios.
O RedTrack costuma ser escolhido por equipes que querem roteamento gerenciado para APIs de plataforma com menos trabalho de infraestrutura do que um tracker auto-hospedado. Ele pode ser uma ótima opção quando os compradores precisam de encaminhamento consistente de eventos entre várias redes e fontes de tráfego.
Começar pela integridade do postback
Gere a URL de postback do RedTrack esperada pela rede e confirme a compatibilidade de tokens antes de ativar o encaminhamento para a plataforma. O click ID prova qual clique rastreado converteu; o ID da transação prova se a conversão é nova ou uma atualização.
Use uma implementação gradual. Comece com uma oferta, uma fonte de tráfego e um limite diário baixo. Valide que o RedTrack recebe todos os campos, registra o status correto e mostra a receita na moeda esperada antes de adicionar mais campanhas.
Mapear o significado comercial, não os rótulos
Os rótulos da rede nem sempre são confiáveis. Um registration com payout zero pode ser um evento leve, enquanto um trial pago pode ser o evento que deve treinar a plataforma de anúncios.
Defina as regras de encaminhamento pelo significado comercial: lead qualificado, venda aprovada, início de assinatura, rebill, reembolso ou chargeback. Isso deixa os relatórios mais claros e evita que os nomes dos eventos se desviem conforme novas redes são adicionadas.
Monitorar a qualidade do encaminhamento
Nos primeiros dias de lançamento, verifique os logs do RedTrack de hora em hora ou pelo menos em intervalos diários fixos. Compare cliques da fonte com cliques do tracker, postbacks da rede aprovados com conversões do tracker e eventos encaminhados com eventos aceitos pela plataforma.
Se os deltas aumentarem, isole a camada: captura do clique, postback da rede, mapeamento de status, encaminhamento via API ou aceitação pela plataforma. Corrigir uma camada por vez é mais rápido do que alterar templates, macros e mapeamentos de API no mesmo ciclo.
Etapa 5: configurar o Keitaro quando você precisa de controle auto-hospedado
Resultado: o Keitaro recebe callbacks de conversão e roteia eventos limpos enquanto sua equipe controla hospedagem, logs e recuperação.
O Keitaro é atraente quando as equipes querem mais controle sobre roteamento, logs, integrações personalizadas e localização do servidor. A troca é a responsabilidade operacional. Um tracker auto-hospedado precisa de monitoramento, backups, controle de acesso e alguém responsável quando as filas falham.
Padronizar templates antes de escalar
Crie nomes canônicos de parâmetros para fonte, campanha, anúncio, click ID, payout, currency e transaction ID. Em ambientes auto-hospedados, a deriva de nomenclatura cresce rápido porque diferentes compradores podem criar fluxos de formas diferentes.
Um template de campanha padrão reduz erros de onboarding. Ele também torna a revisão de logs mais rápida quando uma rede pede prova do caminho do clique ou quando uma plataforma reporta eventos de API rejeitados.
Centralizar regras de postback
Normalize os campos antes de gravar conversões. Armazene timestamps em UTC na ingestão e converta fusos horários apenas nos relatórios. Use uma única regra central para deduplicação de transações e transições de status.
Evite deduplicação específica por campanha, a menos que uma rede tenha uma exceção documentada. Regras pontuais são difíceis de auditar e frequentemente se tornam a origem de discrepâncias de receita sem explicação meses depois.
Adicionar alertas operacionais
Para encaminhamento auto-hospedado, monitore falhas de API, acúmulo de filas, erros de servidor, pressão em disco e picos incomuns de tráfego. Como estimativa operacional, falhas sustentadas de encaminhamento acima de 2-3% por 30 minutos merecem investigação porque os sistemas de lance podem começar a otimizar com dados de conversão incompletos.
Teste também os procedimentos de restauração. Um backup que nunca foi restaurado é apenas uma suposição, não um plano de recuperação.
Etapa 6: escolher o tracker pela realidade operacional
Resultado: você escolhe com base no que sua equipe consegue configurar, depurar e manter sob gasto ao vivo.
| Critério | Voluum | RedTrack | Keitaro |
|---|---|---|---|
| Melhor uso | Rastreamento e relatórios gerenciados para afiliados | Encaminhamento gerenciado de eventos entre canais | Controle auto-hospedado e roteamento personalizado |
| Velocidade de configuração | Rápida para fluxos padrão | Rápida a moderada | Moderada, depende da habilidade do administrador |
| Carga de infraestrutura | Baixa | Baixa a moderada | Alta |
| Principal risco | Premissas ocultas dos templates | Mapeamento de eventos excessivamente complexo | DevOps e alertas fracos |
| Prioridade de depuração | Repasse de tokens e mapeamento de status | Aceitação de API e regras de eventos | Logs, filas, saúde do servidor e macros |
O tracker certo é aquele que sua equipe consegue depurar durante a escala. As listas de recursos importam menos do que saber exatamente onde olhar quando as conversões param, os payouts mudam ou uma API rejeita eventos.
Etapa 7: reconciliar semanalmente antes de escalar os orçamentos
Resultado: você confia nos números o bastante para aumentar o gasto sem adivinhar.
Estabeleça um ritmo fixo de reconciliação. Compare cliques da plataforma de anúncios, cliques do tracker, conversões aprovadas pela rede, conversões aprovadas no tracker, totais de receita, eventos encaminhados e eventos aceitos pela plataforma.
Checklist semanal de reconciliação
- Cliques de saída da fonte versus cliques registrados no tracker
- Conversões aprovadas pela rede versus conversões aprovadas no tracker
- Totais de payout da rede versus totais de receita do tracker
- Eventos encaminhados pelo tracker versus eventos aceitos pela plataforma
- Reembolsos, chargebacks e status rejeitados por oferta
- Configurações de fuso horário entre fonte, tracker, rede e exportações de relatórios
Documente a variação normal por fonte de tráfego e modelo de oferta. Sem uma linha de base, toda diferença parece urgente e as equipes perdem tempo correndo atrás do ruído normal de atribuição.
Validar o funil ao vivo, não apenas o tracker
Um tracker pode estar configurado corretamente enquanto a oferta já não converte. Verifique manualmente o anúncio, a lander, a página de pré-venda, o checkout ou formulário de lead, o caminho de upsell e o gatilho de postback durante as janelas de lançamento.
Use ferramentas de pesquisa pública com cuidado. A Meta Ad Library pode mostrar se anúncios semelhantes estão ativos, mas não prova lucratividade, status de parceria ou qualidade de payout. Combine a pesquisa de criativo com dados reais da rede e reconciliação do tracker.
Etapa 8: escalar apenas quando o tracking e a qualidade da oferta concordarem
Resultado: seus eventos CAPI representam resultados comerciais reais, e não apenas callbacks tecnicamente válidos.
O rastreamento server-side melhora a entrega de sinais, mas não transforma uma oferta fraca em uma escalável. Se a rede não estiver enviando eventos pagos válidos, Voluum, RedTrack e Keitaro não têm nada útil para encaminhar.
É aqui que a Daily Intel Service entra no fluxo: ela ajuda operadores a comparar funis ativos, caminhos criativos atuais e sinais vivos da oferta antes de gastarem tempo aperfeiçoando a atribuição para uma oportunidade já enfraquecida. Para equipes que já têm rastreamento implementado, a metodologia da Daily Intel Service explica como a evidência da oferta e a revisão do funil são mantidas separadas do hype.
Para qualidade de busca e disciplina editorial, alinhe os guias públicos de rastreamento com a orientação do Google sobre conteúdo útil, confiável e feito para pessoas. Para encaminhamento de eventos de anúncios, use a documentação oficial da plataforma como referência final de implementação, porque campos de API, parâmetros de consentimento e requisitos de matching podem mudar.
Erros comuns que quebram a atribuição S2S
- Passar o click ID da plataforma, mas não o click ID do tracker, para a URL da oferta
- Aceitar postbacks sem transaction ID
- Tratar eventos pending, approved, refunded e rejected como o mesmo resultado
- Enviar vários eventos da plataforma a partir de um único callback de payout sem regras de roteamento
- Alterar templates de URL durante a execução sem notas de versão
- Misturar LTV estimado e payout real em um único evento de otimização
- Ignorar logs de rejeição da API após ativar o encaminhamento CAPI
- Comparar relatórios com fusos horários ou janelas de atribuição diferentes
O rastreamento server-side estável geralmente é resultado de disciplina de processo: menos nomes de eventos, validação mais rígida de campos, regras de status mais claras e reconciliação feita antes do aumento de orçamento.
Perguntas frequentes
Q: O que é rastreamento server-side no Voluum para campanhas de afiliados?
A: Rastreamento server-side no Voluum é um fluxo em que a rede de afiliados envia um postback de conversão para o Voluum, e o Voluum registra, deduplica e pode encaminhar esse evento para plataformas de anúncios por meio de APIs server-side.
Q: Qual é a diferença entre uma URL de postback e o encaminhamento CAPI?
A: Uma URL de postback envia dados de conversão da rede de afiliados para o tracker, enquanto o encaminhamento CAPI envia eventos mapeados do tracker para a API de uma plataforma de anúncios.
Q: O RedTrack é melhor do que o Keitaro para CAPI?
A: O RedTrack costuma ser mais fácil para encaminhamento gerenciado de eventos, enquanto o Keitaro oferece mais controle auto-hospedado. A melhor escolha depende de sua equipe valorizar mais velocidade de configuração gerenciada ou controle de infraestrutura.
Q: Quais campos um postback de afiliado deve incluir?
A: Um postback de afiliado confiável deve incluir click ID do tracker, transaction ID, payout, currency, status da conversão e timestamp do evento, com regras de deduplicação e transição de status.
Q: Com que frequência devo reconciliar os dados de rastreamento server-side?
A: Reconcile semanalmente como linha de base e verifique de hora em hora ou diariamente durante novos lançamentos. Compare cliques da fonte, cliques do tracker, conversões da rede, receita do tracker, eventos encaminhados e eventos aceitos pela plataforma.
Q: Isto é aconselhamento jurídico, tributário ou financeiro?
A: Não. Este guia é educação de implementação e contexto de inteligência de mercado. Requisitos de privacidade, publicidade, impostos e contratos variam por jurisdição e devem ser revisados com profissionais qualificados.
Comments(0)
No comments yet. Members, start the conversation below.
Related reads
- DISfinance intelligence
Como Encontrar VSLs de SMMA em Escala Antes de Gastar
Um fluxo de trabalho prático no fundo do funil para encontrar VSLs de SMMA em escala verificando o ritmo real dos anúncios, a integridade do funil, o acesso ao carrinho, a economia e o risco de saturação antes de comprometer orçamento.
Read - DISfinance intelligence
Melhores programas de afiliados de corretoras de criptomoedas comparados por região
Uma análise prática de programas de afiliados de corretoras de criptomoedas por região, comparando Binance, Coinbase, Kraken, Bybit, KuCoin, PrimeXBT e Bitpanda em termos de adequação, risco e sinais de escala.
Read - DIStraffic source intelligence
O que é um funil de vendas e como construir um em 2026
Um guia em linguagem simples sobre funis de vendas: o que são, como funcionam as etapas, qual tipo de funil combina com seu tráfego e sua oferta e como lançar um teste mensurável de 30 dias.
Read