Configure postbacks do ciclo de vida da ação
Há dois tipos principais de postbacks de ciclo de vida da ação. Nível global cria postbacks para toda a sua conta e nível de evento cria postbacks para tipos específicos de evento. Selecione a opção que melhor atende às suas necessidades para saber mais sobre o processo de configuração.
Aviso: Para postbacks de 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 os postbacks de nível de evento não acionam eventos de ciclo de vida da ação não padrão.
Configurar um postback de ciclo de vida da ação
Configurar um postback de ciclo de vida da ação de nível global
Esta seção abordará a criação de postbacks para toda a sua conta de uma vez. Parceiros que tenham apenas um sistema que possa receber e consumir esses postbacks ou que queiram notificações para todos os eventos não padrão devem configurar postbacks de ciclo de vida da ação de nível global.
Observação: Se você quiser ser mais seletivo em relação aos tipos de evento para os quais receberá postbacks, veja a seção abaixo para configurar postbacks de ciclo de vida da ação de nível de evento.
Na barra de navegação superior, selecione
[Perfil do usuário] → Configurações.Em Técnico, selecione Notificações de evento.
Ao lado de Eventos do ciclo de vida da ação, selecione
[Editar].Insira a URL do seu servidor. Esta é a URL para a qual a impact.com enviará os postbacks.
Selecione o método HTTP de sua preferência.
Veja alguns dos parâmetros de corpo disponíveis da impact.com.
Se você selecionar POST, você então inserirá o corpo da solicitação e selecionará um Formato do 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 da configuração do seu próprio sistema, e os valores serão o ponto de dados correspondente escolhido por você que a impact.com fornece e devem ser inseridos entre colchetes
{ }.
Não vê o valor de que precisa? Entre em contato com seu Gerente de Conta (ou entre em contato com o suporte).
Selecione Eventos do ciclo de vida da ação). Essas configurações são opcionais.
Insira um Cabeçalho HTTP. Se forem necessários vários pares, 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 o Máximo de solicitações que a impact.com pode fazer ao seu sistema por segundo.
Insira o que você quer que a Resposta de sucesso a um postback seja.
Insira o que você quer que a Resposta de erro a um postback seja.
Selecione Salvar.
Agora que você configurou postbacks de nível global, seu sistema deve começar a receber postbacks sempre que eventos não padrão acontecerem, independentemente da marca que estiver executando as ações não padrão. Para saber como testar sua nova configuração de postback, veja o Testar um postback de ciclo de vida da açã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 as ações ocorrerem e recuperar os valores preenchidos dinamicamente associados à ação.
Este exemplo mostra como passar um SharedId valor (um valor que você deseja compartilhar com as marcas) para um parâmetro em um postback (MeuParam). Algumas marcas podem exigir que você configure isso.
Uma URL de postback seria algo como:
https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}
A URL de postback preencherá o MeuParam parâmetro com o valor recuperado de SharedId.
Configurar postbacks de ciclo de vida da ação de nível de evento
Esta seção abordará a criação de postbacks para tipos específicos de evento que rastreiam quando você gera ações. Se você quiser ser mais seletivo com os tipos de evento para os quais recebe postbacks, você deve configurar postbacks de ciclo de vida da ação de nível de evento.
Observação: Se você configurar postbacks de ciclo de vida da ação de nível global, não precisa configurar os de nível de evento.
Na barra de navegação superior, selecione Descobrir → Minhas marcas.
Selecione o cartão da marca que é dona do postback que você quer testar.
Abaixo do nome da marca, selecione
[Mais] → Integração de rastreamento.No canto superior direito da página, selecione Adicionar postback.
Selecione o tipo de evento (antes rastreador de ações) para o qual você deseja configurar postbacks de ciclo de vida da ação.
Insira a URL do seu servidor. Esta é a URL para a qual a impact.com enviará os postbacks.
Selecione o método HTTP de sua preferência.
Se você selecionar POST, você então inserirá o corpo da solicitação e selecionará um Formato do 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 da configuração do seu próprio sistema, e os valores serão o ponto de dados correspondente escolhido por você que a impact.com fornece e devem ser inseridos entre colchetes { }.
Veja alguns dos parâmetros de corpo disponíveis da impact.com.
Não vê o valor de que precisa? Entre em contato com seu Gerente de Conta (ou entre em contato com o suporte).
Selecione Mostrar configurações avançadas). Essas 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 o Máximo de solicitações que a impact.com pode fazer ao seu sistema por segundo.
Insira o que você quer que a Resposta de sucesso a um postback seja.
Insira o que você quer que a Resposta de erro a um postback seja.
Selecione Salvar.
Agora que você configurou postbacks de nível de evento, seu sistema deve começar a receber postbacks para o tipo de evento selecionado em Etapa 5. Para saber como testar sua nova configuração de postback, veja o Testar um postback de ciclo de vida da açã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 as ações ocorrerem e recuperar os valores preenchidos dinamicamente associados à ação.
Este exemplo mostra como passar um SharedId valor (um valor que você deseja compartilhar com as marcas) para um parâmetro em um postback (MeuParam). Algumas marcas podem exigir que você configure isso.
Uma URL de postback seria algo como:
https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}
A URL de postback preencherá o MeuParam parâmetro com o valor recuperado de SharedId.
Testar um postback de ciclo de vida da ação
Depois de configurar um postback de ciclo de vida da ação, independentemente do nível ao qual ele se aplique, você deve testá-lo. Você pode executar um postback de teste na impact.com (disponível apenas para postbacks de nível de evento) ou realizar uma conversão.
Se um postback falhar quando a impact.com enviar para a URL de destino, a impact.com tentará novamente automaticamente. A impact.com tenta reenviar um postback com falha até 15 vezes no total. A impact.com ignora as primeiras 3 tentativas de nova entrega para respostas HTTP de 400 para 500. Para ver a programação completa de tentativas e os detalhes de solução de problemas, consulte Testar e solucionar problemas de uma URL de postback.
Executar um postback de teste na impact.com
Se você configurou um postback de nível de evento, então pode testá-lo na sua conta da impact.com.
Na barra de navegação superior, selecione Descobrir → Minhas marcas.
Selecione o cartão da marca que é dona do postback que você quer testar.
Abaixo do nome da marca, selecione
Mais → Integração de rastreamento.Do Postback seção, selecione
[Seta para baixo] Ações, depois selecione Iniciar teste.Confirme se a URL do postback está correta e, em seguida, selecione Iniciar teste.
Criar uma conversão de teste
Este teste não será realizado no aplicativo web da impact.com. Em vez disso, você fará 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.
Na barra de navegação superior, selecione Conteúdo → Ativos.
Selecione um anúncio.
Abaixo do nome do anúncio, selecione Obter link de rastreamento.
Selecione
[Ativar] Parâmetros de rastreamento.Enter Sub IDs ou um ID compartilhado conforme necessário. Cada campo requer pelo menos uma entrada.
Pule esta etapa se você já tiver valores nesses campos.
Opcionalmente, selecione uma Propriedade na lista suspensa.
Selecione Salvar.
Selecione Copiar link de rastreamento.
Cole o link em uma nova janela do navegador.
Conclua a ação.
Depois de cerca de 15 minutos, verifique no seu sistema o postback que foi gerado a partir desta ação de teste.
15 minutos é, normalmente, o tempo que o processamento da ação leva.
Você também poderá ver esta nova ação pendente na tela de Ações pendentes Se você vir a ação na tela de Ações pendentes mas ainda não tiver recebido um postback, verifique novamente a configuração do seu postback.
Peça à sua marca para reverter a ação.
Verifique no seu sistema o postback que foi gerado a partir dessa reversão.
Se você vir a ação revertida na tela de Ações revertidas , mas ainda não tiver recebido um postback, verifique novamente a configuração do seu postback.
Solucionar erros
Parâmetro obrigatório ausente
Seu servidor provavelmente espera um valor em vez de uma variável. Modifique sua URL de postback para passar um valor de teste (por exemplo, "12345678" em vez de {SubId1}) e veja se ele aceita o valor codificado.
Variáveis sensíveis a maiúsculas e minúsculas
As variáveis dinâmicas diferenciam maiúsculas de minúsculas e devem ser exatas, o que significa que {SubId1} não é o mesmo que {subid1}. Verifique novamente se suas variáveis refletem a sensibilidade correta a maiúsculas e minúsculas.
Acesso negado
A maioria dos servidores de postback tem um token ou valor de segurança que deve ser enviado junto com as variáveis dinâmicas. Trabalhe com a equipe técnica do seu site (ou consulte a documentação do provedor do seu site) para saber qual token ou valor de segurança é necessário para acessar o servidor.
Observação: Se você não encontrar nenhum problema com a configuração do seu postback, mas ainda assim não estiver recebendo-os, entre em contato com o suporte. a impact.com pode verificar se os postbacks estão sendo gerados, qual é o código de resposta de cada um e o corpo de cada postback. Essas informações podem ajudar você a depurar sua configuração.
Atualizado
Isto foi útil?