O que é a integração do código JavaScript Postback?
O código JavaScript Postback é um pequeno script executado no navegador, inserido em uma página web ou landing page. Seu objetivo é disparar eventos específicos e enviar dados de rastreamento para uma rede de anúncios, um tracker ou uma plataforma de analytics. Ele permite rastrear ações e comportamentos dos usuários, além de coletar dados baseados no navegador.
Esse tipo de rastreamento client-side é um dos métodos de integração mais antigos e simples, amplamente utilizado em plataformas de publicidade digital – desde Google Ads e Meta até redes de afiliados e plataformas AdTech como a HilltopAds.
Como funciona?
O rastreamento via JavaScript Postback funciona executando um pequeno script no navegador do usuário, que envia informações para uma plataforma de publicidade ou analytics. Veja o processo dividido em etapas simples:
Um snippet JavaScript é adicionado a uma página web
Normalmente no final da tag<body>.Quando o usuário carrega a página, o navegador executa o script.
O pixel extrai as informações necessárias, como parâmetros de query (por exemplo, clickId), cookies, user agent, endereço IP ou referenciador.
O script monta uma URL de requisição que inclui os parâmetros de evento relevantes.
O navegador envia a requisição para o servidor da plataforma de anúncios.
A rede de anúncios registra o evento e o atribui ao clique ou sessão corretos.
Exemplo: código JavaScript Postback da HilltopAds
Este snippet envia um evento de conversão utilizando o clickId passado na URL:
<script>
const urlParams = new URLSearchParams(window.location.search),
clickId = urlParams.get('clickId');
const postbackUrl = "https://trackhta.com/close/?token="
+ clickId + "&price=price¤cy=currency&label=label&advertiserId=";
console.log(postbackUrl);
fetch(postbackUrl)
.then(function(response) {
console.log('Postback successful:', response);
})
.catch(function(error) {
console.error('Error during postback:', error);
});
</script>
Esse snippet geralmente é colocado em uma página de agradecimento ou confirmação de conversão (por exemplo, “Obrigado pelo seu pedido!”), garantindo que o evento seja disparado apenas após a ação ser concluída.
Limitações do código JavaScript Postback (Muito importante!)
Embora seja prático, o rastreamento via JS pixel apresenta algumas limitações que devem ser consideradas:
Limitação | Por que isso importa |
Pode ser bloqueado por ad blockers | Até 30–40% dos usuários impedem o disparo de pixels |
Afetado por regras de privacidade dos navegadores (ITP) | Safari e iOS limitam agressivamente cookies e rastreamento client-side |
Depende da execução do JavaScript | Erros de script, conexões lentas ou recursos bloqueados quebram o rastreamento |
Menos preciso que S2S | Não há garantia de disparo em todos os cenários |
O usuário pode fechar a página muito rápido | Se a página não carregar completamente, o pixel não será disparado |
Por causa dessas questões de confiabilidade, anunciantes que atuam em verticais que exigem alta precisão (iGaming, finanças, apostas, cripto) geralmente preferem a integração de postback S2S como método principal, utilizando pixels JavaScript apenas como backup ou para rastreamento de eventos adicionais.
Onde inserir o código?
O método de instalação mais comum e recomendado é colocar o script em uma página de confirmação de conversão.
Adicione o snippet na parte inferior da página, antes das tags de fechamento:
</body>
</html>
Conclusão
O JavaScript Postback é uma forma simples, rápida e amplamente compatível de registrar conversões. No entanto, recomendamos fortemente considerar o uso de uma plataforma de rastreamento dedicada sempre que possível. Um tracker garante atribuição confiável, protege contra perda de dados e oferece recursos avançados de análise e otimização que scripts client-side, por si só, não conseguem fornecer. Confira nossos guias de postback para encontrar a melhor opção!