Configurar Postbacks do Ciclo de Vida de Ação

Esta seção cobrirá a criação de postbacks para toda a sua conta de uma só vez. Parceiros que têm apenas um sistema que pode receber e processar esses postbacks ou que desejam notificações para todos os eventos não padrão devem configurar postbacks do ciclo de vida de ação em nível global.

1. Na barra de navegação superior, selecione [Perfil do usuário] → Configurações.

2. Em Técnico, selecione Notificações de evento.

3. Ao lado de Eventos do ciclo de vida da ação, selecione [Editar].

4. Insira a URL do seu servidor. Esta é a URL para a qual o impact.com enviará os postbacks.

5. Selecione seu método HTTP preferido.

   • Veja alguns dos parâmetros de corpo disponíveis.

   • Se você selecionar POST, você deverá então inserir o corpo da requisição e selecionar um Formato de Corpo. Abaixo está um exemplo de como você pode mapear cada ponto de dados para um formato JSON. As chaves em cada par chave-valor devem ser obtidas a partir da configuração do seu próprio sistema, e os valores serão o ponto de dados correspondente que o impact.com fornece e que devem ser inseridos entre colchetes { }.

     
   • Não vê um valor que precisa? Entre em contato com seu Gerente de Conta (ou contate o suporte).

6. Selecione Eventos do ciclo de vida da ação. Estas configurações são opcionais.

   • Insira um Cabeçalho HTTP. Se vários pares forem necessários, separe-os com ponto e vírgula.

   • Insira um Atraso Mínimo entre quando um evento não padrão acontece e quando o postback é gerado e enviado ao seu sistema.

   • Insira um limite de taxa para as Solicitações Máximas que o impact.com pode fazer ao seu sistema por segundo.

   • Insira o que você deseja que a Resposta de Sucesso seja para um postback.

   • Insira o que você deseja que a Resposta de Erro seja para um postback.

7. Selecione Salvar.

Agora que você configurou postbacks em nível global, seu sistema deve começar a receber postbacks sempre que ocorrerem eventos não padrão, independentemente da marca que executou as ações não padrão. Para saber como testar sua nova configuração de postback, veja a Teste um postback do ciclo de vida de ação seção abaixo.

Exemplo de valores dinâmicos

Se você configurou variáveis dinâmicas para seus links de rastreamento, pode configurar uma URL de Postback para seu próprio servidor para notificá-lo quando ações ocorrerem e recuperar o(s) valor(es) preenchido(s) dinamicamente associados à ação.

Este exemplo mostra como passar um SharedId valor (um valor que você deseja compartilhar com marcas) para um parâmetro em um postback (MyParam). Algumas marcas podem exigir que você configure isso.

Uma URL de postback ficaria algo como:

https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}

A URL de postback preencherá o MyParam parâmetro com o valor recuperado de SharedId.

Esta seção abordará a criação de postbacks para tipos de evento específicos que rastreiam quando você gera ações. Se quiser ser mais seletivo com os tipos de eventos para os quais recebe postbacks, você deve configurar postbacks do ciclo de vida de ação em nível de evento.

1. Na barra de navegação superior, selecione Descobrir → Minhas Marcas.

2. Selecione o cartão da marca que possui o postback que você deseja testar.

3. Abaixo do nome da marca, selecione [Mais] → Integração de Rastreamento.

4. Perto do canto superior direito da página, selecione Adicionar Postback.

5. Selecione o tipo de evento (anteriormente rastreador de ação) para o qual você deseja configurar postbacks do ciclo de vida de ação.

6. Insira a URL do seu servidor. Esta é a URL para a qual o impact.com enviará os postbacks.

7. Selecione seu método HTTP preferido.

   • Se você selecionar POST, você deverá então inserir o corpo da requisição e selecionar um Formato de Corpo. Abaixo está um exemplo de como você pode mapear cada ponto de dados para um formato JSON. As chaves em cada par chave-valor devem ser obtidas a partir da configuração do seu próprio sistema, e os valores serão o ponto de dados correspondente que o impact.com fornece e que devem ser inseridos entre chaves { }.

     
   • Veja alguns do impact.com parâmetros de corpo disponíveis.

   • Não vê um valor que precisa? Entre em contato com seu Gerente de Conta (ou contate o suporte).

8. Selecione Mostrar configurações avançadas. Estas configurações são opcionais.

   • Insira um Atraso Mínimo entre quando um evento não padrão acontece e quando o postback é gerado e enviado ao seu sistema.

   • Insira um limite de taxa para as Solicitações Máximas que o impact.com pode fazer ao seu sistema por segundo.

   • Insira o que você deseja que a Resposta de Sucesso seja para um postback.

   • Insira o que você deseja que a Resposta de Erro seja para um postback.

9. Selecione Salvar.

Agora que você configurou postbacks em nível de evento, seu sistema deve começar a receber postbacks para o tipo de evento que você selecionou em Etapa 5. Para saber como testar sua nova configuração de postback, veja a Teste um postback do ciclo de vida de ação seção abaixo.

Exemplo de valores dinâmicos

Se você configurou variáveis dinâmicas para seus links de rastreamento, pode configurar uma URL de Postback para seu próprio servidor para notificá-lo quando ações ocorrerem e recuperar o(s) valor(es) preenchido(s) dinamicamente associados à ação.

Este exemplo mostra como passar um SharedId valor (um valor que você deseja compartilhar com marcas) para um parâmetro em um postback (MyParam). Algumas marcas podem exigir que você configure isso.

Uma URL de postback ficaria algo como:

https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}

A URL de postback preencherá o MyParam parâmetro com o valor recuperado de SharedId.

Se você configurou um postback em nível de evento, então pode testá-lo dentro da 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ê deseja testar.

3. Abaixo do nome da marca, selecione Mais → Integração de Rastreamento.

4. A partir do Postback seção, selecione [Seta para baixo] Ações, então selecione Iniciar Teste.

5. Confirme se a URL do postback está correta, então selecione Iniciar teste.

Este teste não será realizado no aplicativo web do impact.com. Em vez disso, você realizará um teste de ponta a ponta que segue uma jornada típica do usuário. Certifique-se de notificar a marca parceira de que você realizará o teste.

1. Na barra de navegação superior, selecione Conteúdo → Recursos.

2. Selecione um anúncio.

3. Abaixo do nome do anúncio, selecione Obter Link de Rastreamento.

4. Selecione [Ativar] Parâmetros de Rastreamento.

5. Insira Sub IDs ou um Shared ID conforme exigido. Cada campo requer pelo menos uma entrada.

   • Pule esta etapa se você já tiver valores nesses campos.

6. Opcionalmente, selecione uma Propriedade no menu suspenso.

7. Selecione Salvar.

8. Selecione Copiar Link de Rastreamento.

9. Cole o link em uma janela de navegador nova.

10. Complete a ação.

11. Após cerca de 15 minutos, verifique seu sistema pelo postback gerado a partir desta ação de teste.

    • 15 minutos é geralmente quanto tempo o processamento de ação leva.

    • Você também poderá ver esta nova ação pendente na tela Ações Pendentes . Se você vir a ação na tela Ações Pendentes mas ainda não recebeu um postback, verifique novamente sua configuração de postback.

12. Peça à sua marca para reverter a ação.

13. Verifique seu sistema pelo postback gerado a partir dessa reversão.

    • Se você vir a ação revertida na tela Ações Revertidas , mas não recebeu um postback, verifique novamente sua configuração de postback.