FAQ sobre notificações de eventos do ciclo de vida da ação

Se você quiser receber notificações em tempo real sempre que as ações que você conduzirem forem relatadas, modificadas ou revertidas, você pode configurar Notificações de eventos do ciclo de vida da ação para receber essas notificações.

O que é uma notificação de evento?

Notificações de evento podem atualizar um sistema de terceiros em tempo real por meio de chamadas HTTP ao servidor. Se você tiver uma notificação de evento configurada e ocorrer um evento de gatilho (como sua marca parceira modificar uma ação que você conduziu), a impact.com enviará um postback para a URL fornecida com uma notificação.

Observação: As notificações de evento, os postbacks e os webhooks são todos termos diferentes para o mesmo processo na plataforma. Por uma questão de consistência, o restante deste artigo usará o termo "postback."

Como funcionam os postbacks do ciclo de vida da ação?

Os postbacks do ciclo de vida da ação funcionam atualizando você sempre que um evento "não padrão" acontece no ciclo de vida da ação. Eventos não padrão são eventos que não têm datas estabelecidas ou períodos de tempo em seu contrato. Por exemplo, o data de bloqueio é um evento padrão, ou previsível, pois o período de bloqueio da ação está descrito em seu contrato. Uma ação sendo modificada, no entanto, é um evento não padrão, pois não existe intervalo de tempo nem datas definidas em seu contrato, tornando-o não padrão (ou imprevisível).

Aqui estão alguns exemplos de eventos não padrão do ciclo de vida da ação. Estes vão criar um postback.

• Uma ação que você conduziu é rastreada ou relatada à impact.com.
• Uma ação que você conduziu é modificada pela sua marca parceira.
• Uma ação que você conduziu é revertida pela sua marca parceira.

Aqui estão alguns exemplos de eventos padrão do ciclo de vida. Estes não vão criar um postback.

• Uma ação que você conduziu é bloqueada (ou seja, não pode mais ser modificada ou revertida).
• Uma ação que você conduziu recebe pagamento em sua conta.

Aviso: Para postbacks em nível global, você deve receber um postback sempre que ocorrer um evento "não padrão", como uma modificação ou uma reversão. Observe que postbacks em nível de evento não dispararão eventos não padrão do ciclo de vida da ação.

Por que eu não usaria simplesmente a API da impact.com?

Embora nossa API seja perfeitamente adequada para fornecer a você as mesmas informações, há algumas diferenças de características e restrições entre nossa API e nosso sistema de postbacks que provavelmente fariam dos postbacks uma solução mais preferível para você. Entre elas estão as seguintes:

• Os postbacks acontecem em tempo real. Os postbacks são gerados pela impact.com e recebidos por você em até 15 minutos após a ocorrência de um evento não padrão.
• Os postbacks têm acesso a mais dados de conversão. Mesmo que você não veja o ponto de dados de que precisa em nossa interface (ou em nossa folha de referência para desenvolvedores) ao configurar seus postbacks, provavelmente temos o ponto de dados disponível se você entrar em contato com seu Gerente de Conta de Publisher (ou entre em contato com o suporte).
• Os postbacks não têm limites de taxa. Quando você usa a API da impact.com, está sujeito a limites de taxa impostos ao sistema. Especificamente, ao usar a API da impact.com, você fica limitado a 1000 solicitações de API para a maioria dos endpoints, enquanto os postbacks não têm esse limite.
• Para acessar nosso Portal de Integrações.

Os postbacks são confiáveis?

Sim. A impact.com usa postbacks em algumas de nossas próprias soluções de rastreamento. Você não precisa atender a nenhum critério especial para usar postbacks e também não enfrenta nenhum limite de taxa.

Se um postback falhar quando a impact.com enviar para sua URL de destino, a impact.com tentará a entrega novamente automaticamente. Isso ajuda a lidar com problemas temporários de rede ou curtos períodos de indisponibilidade do servidor. A impact.com tenta novamente um postback com falha até 15 vezes no total.

A impact.com não tenta novamente um postback se a URL de destino estiver malformada ou inválida. A impact.com também não tenta novamente URLs ou hosts não resolvidos. Uma falha de pesquisa de DNS é um exemplo.

A impact.com ignora as 3 primeiras tentativas de novos envios para respostas HTTP de 400 a 500.

Quando realizamos manutenção em nosso sistema de postbacks, você será notificado e os postbacks serão pausados. No entanto, assim que concluirmos a manutenção, começaremos imediatamente a colocar seu sistema em dia.

No entanto, se você notar um atraso no recebimento de postbacks, como uma ação ter sido modificada e você ainda não tiver recebido um postback mais de uma hora após a modificação ter ocorrido, entre em contato com o suporte.

Quais medidas de segurança a impact.com usa para postbacks?

Ao usar postbacks, você definirá o destino para o qual deseja que as chamadas sejam enviadas. Por isso, como a impact.com armazena os dados em nosso back-end e como a impact.com realiza uma chamada de servidor para servidor quando enviamos os dados, não há como interceptar os dados enquanto eles estão em trânsito.

Se desejar, podemos criar um cabeçalho personalizado que transmita outro conjunto de credenciais para incluir nas chamadas de postback que a impact.com envia para você. Você não pode criar esse cabeçalho no app web, então entre em contato com seu Gerente de Conta de Publisher (ou entre em contato com o suporte) para nos informar que você quer que esse cabeçalho seja criado.

Como configuro os postbacks do ciclo de vida da ação?

Para mais instruções sobre como configurar e testar postbacks do ciclo de vida da ação em nível global e em nível de evento, consulte o artigo Configurar postbacks do ciclo de vida da ação.

Como visualizo meu histórico de postbacks?

Se você configurar um postback em nível de evento, poderá ver o histórico dele em sua conta impact.com.

1. Na barra de navegação superior, selecione Descobrir → Minhas Marcas.
2. Selecione o cartão da marca que possui o postback que você quer visualizar.
3. Abaixo do nome da marca, selecione [Mais] → Integração de Rastreamento.
4. Na seção Postback selecione [Seta para baixo] Ações, depois selecione Histórico.