Visão Geral

A Events API enviará eventos de transações para você em tempo quase real. Assim que recebemos do anunciante um registro de conversão bem sucedida, passamos os dados no postback. O mesmo fluxo de trabalho se aplica aos cancelamentos. Quando um cliente devolve ou cancela uma compra, o anunciante nos enviará um registro desse cancelamento, que também disparamos no postback. O mesmo conjunto de dados é passado para cancelamentos, apenas com alguns valores alterados para indicar que o evento é um cancelamento.

Esses são os dados que você pode esperar que sejam modificados nos postbacks de cancelamento. Clique no sinal + para ver as mudanças, se houver:

AAAA-MM-DDTHH:mm:ss.SSS[+|-] Z

É altamente recomendável incluir pelo menos o parâmetro "Vendas" e/ou "Comissões" ao solicitar um postback personalizado. Sem o valor negativo das vendas ou comissões, é praticamente impossível distinguir os eventos de cancelamento de novos eventos de conversão.

Eventos de otimização de mídia e anunciantes de rastreamento em lote

Para os anunciantes que utilizam o rastreamento em lotes, pode ser esperada uma latência entre quando um registro de conversão atinge nosso sistema e quando o cliente realmente fez a compra. Isso é especialmente comum para os anunciantes de reservas e viagens, os varejistas que oferecem pedidos antecipados, assim como os anunciantes que só informam conversões quando uma compra é enviada.

Esses anunciantes empregam o "Media Optimization Pixel" (MOP, que captura a compra em tempo real como um evento preliminar) de modo a ter um registro inicial da conversão subsequente. Esses eventos do MOP serão indicados como "is_event=Y" no postback. Ou seja, trate todos os registros em Y como preliminares.

Quando a conversão for finalizada, o postback disparará novamente com "is_event=N". Se for uma devolução parcial, o valor da venda só refletirá o preço do item devolvido e não o valor total no ponto de venda. Todos os outros pontos de dados serão os mesmos, exceto "etransaction_id" e "process_date".

Observe que, para pixel de rastreamento em tempo real, os anunciantes com um evento Y serão acionados e seguidos quase imediatamente por um evento N correspondente. Queira tratar os acontecimentos N como concluídos.

Como no caso de cancelamentos, recomendamos incluir a sinalização "is_event" ao solicitar um postback personalizado. Excluir essa sinalização tornará praticamente impossível distinguir eventos preliminares de eventos finalizados.

Para obter mais informações sobre este tópico, consulte "Visão geral da Events API" e "Perguntas frequentes sobre a Events API".