O rastreamento por postback permite que a HilltopAds envie notificações de eventos diretamente ao seu sistema de rastreamento. Assim, você pode associar impressões, cliques e conversões aos seus próprios registros e visualizar os valores dos ganhos quando essa opção estiver configurada.
O que é postback para publishers e como usá-lo na HilltopAds?
Um postback é uma solicitação de servidor para servidor que a HilltopAds envia ao seu endpoint de rastreamento sempre que ocorre um evento que atende aos critérios de notificação.
Dependendo da configuração, um postback pode informar sobre:
Uma impressão contabilizada de tráfego popunder ou um clique contabilizado em um anúncio de display.
Uma conversão.
O ganho gerado por um evento, se você incluir o placeholder correspondente.
Quando você recebe um postback de impressão ou clique, isso significa que o evento foi contabilizado. Os dados de ganhos mostram sua receita proveniente de impressões CPM ou conversões CPA.
Observação: Os postbacks não informam impressões perdidas ou filtradas. As notificações recebidas dependem dos eventos selecionados e do percentual de envio definido com seu gerente de conta.
Como configurar o rastreamento por postback
Seu gerente de conta da HilltopAds configurará a integração para você. Antes de começar, prepare seu endpoint de postback e decida quais eventos deseja rastrear.
1. Envie sua URL de postback ao gerente de conta
Compartilhe o endpoint em que seu sistema de rastreamento recebe as notificações de eventos. Por exemplo:
https://website.com/postback?click_uuid={externalid}&payout={payout}&uid=uidNeste exemplo:
click_uuidé o parâmetro que seu sistema de rastreamento usa para receber o identificador.{{clickId}}é substituído pelo identificador único transmitido pelo link de monetização da HilltopAds.{{payout}}é substituído pelo valor do ganho associado ao evento informado.uidé o ID da sua conta de publisher. Você pode encontrá-lo no painel.
Seu endpoint pode usar nomes de parâmetros diferentes. Envie ao gerente de conta a URL exata exigida pelo seu sistema de rastreamento para que ele possa verificar o mapeamento dos parâmetros.
Se o endpoint precisar de valores adicionais, como um ID de usuário, combine com seu gerente de conta como mapeá-los antes da configuração.
2. Escolha quais eventos deseja receber
A HilltopAds oferece as seguintes opções de notificação:
Impressões ou cliques
Um postback é enviado quando uma impressão de popunder ou um clique em um anúncio de display é contabilizado.
O postback confirma que o evento foi contabilizado.
Exemplo:
https://website.com/postback?click_uuid={{clickId}}Somente conversões
Um postback é enviado quando ocorre uma conversão. Essa opção é útil para publishers que trabalham com link direto.
Exemplo:
https://website.com/postback?click_uuid={{clickId}}Todos os eventos que geram ganhos
Os postbacks são enviados apenas para eventos que geram ganhos para você.
Por exemplo, se uma impressão em uma campanha CPA não gerar ganhos, ela não acionará um postback. Se uma conversão gerar ganhos posteriormente, você receberá um postback desse evento.
Exemplo:
https://website.com/postback?click_uuid={{clickId}}&payout={{payout}}Observação: Você pode usar o placeholder {{payout}} com qualquer opção de notificação. A opção “Todos os eventos que geram ganhos” envia notificações apenas para eventos que geram ganhos.
Todos os eventos
Os postbacks são enviados tanto para impressões ou cliques contabilizados quanto para conversões.
Se uma impressão ou um clique resultar posteriormente em uma conversão, você receberá dois postbacks com o mesmo clickId: um para a impressão ou o clique e outro para a conversão.
Exemplo:
https://website.com/postback?click_uuid={{clickId}}Verifique se seu sistema de rastreamento consegue processar mais de uma notificação para o mesmo identificador.
3. Defina o percentual de envio
Combine com seu gerente de conta qual percentual dos eventos que atendem aos critérios de notificação deve ser enviado ao seu endpoint.
O envio pode ser configurado para uma parcela dos eventos, como 10% ou 100%. O valor padrão geralmente é de 10% para manter a carga do sistema baixa.
A seleção dos eventos e o percentual de envio são configurações independentes. Escolher “Todos os eventos” não significa que você receberá 100% das notificações. Se a amostragem estiver ativada, seu sistema de rastreamento receberá apenas a proporção acordada.
Leve esse percentual em consideração ao comparar os registros de postback com suas estatísticas da HilltopAds.
4. Adicione parâmetros de rastreamento ao seu link de monetização
Após a configuração do postback, seu gerente de conta fornecerá um link de monetização da HilltopAds e explicará quais valores de rastreamento você deve usar.
https://dengd.com/bC3aV/0.Pf3hp/vpb/m_VLJiZtD/0/3/N/T/QvwrNmTMQ/5kLbTvcJ1WNYDFAx1/NdT-Mf?clickId=PARAM_NAME&sId=PARAM_NAME
Os parâmetros de rastreamento incluem:
clickId: Seu ID único de impressão ou clique, usado para associar as notificações de postback aos seus registros de rastreamento.sId: O ID da zona de anúncios.
Substitua os valores de exemplo ou os placeholders no link de monetização pelos valores corretos ou pelas macros dinâmicas do seu sistema, seguindo as instruções do gerente de conta.
Seu link de monetização e sua URL de postback têm funções diferentes:
O link de monetização envia tráfego para a HilltopAds.
A URL de postback recebe notificações de eventos da HilltopAds.
Use sempre o link de monetização fornecido pelo seu gerente de conta. Não use seu endpoint de postback como destino do tráfego.
5. Verifique a integração
Teste a configuração com seu gerente de conta antes de aplicá-la a todo o seu tráfego. Certifique-se de que:
Seu endpoint recebe as notificações dos eventos selecionados.
Os identificadores recebidos correspondem aos seus registros de rastreamento.
Os valores dos ganhos são recebidos quando essa opção está configurada.
Seu sistema de rastreamento consegue processar mais de uma notificação para o mesmo
clickIdao usar a opção “Todos os eventos”.O percentual de envio corresponde às configurações acordadas.
Se precisar de ajuda para configurar o postback da sua conta de publisher ou solucionar problemas, entre em contato com seu gerente de conta da HilltopAds.
