# Configurar Postbacks do Ciclo de Vida da Ação
Existem dois tipos principais de postbacks do ciclo de vida da ação. **Nível global** cria postbacks para toda a sua conta e **nível do evento** cria postbacks para tipos de evento específicos. Selecione a opção que melhor atende às suas necessidades para saber mais sobre o processo de configuração.
{% hint style="warning" %}
**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 do evento não serão disparados para eventos de ciclo de vida da ação não padrão.
{% endhint %}
#### Configurar um postback do ciclo de vida da ação
Configurar um postback do 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 têm apenas um sistema capaz de 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 da ação de nível global.
{% hint style="info" %}
**Observação:** Se você quiser ser mais seletivo em relação aos tipos de eventos para os quais receberá postbacks, veja a seção abaixo para configurar *postbacks do ciclo de vida da ação de nível do evento*.
{% endhint %}
1. Na barra de navegação superior, selecione  **\[Perfil do usuário] → Configurações**.
2. Em *Técnico*, selecione **Notificações de eventos**.
3. Ao lado de *Eventos do ciclo de vida da ação*, selecione  **\[Editar]**.
4. Digite a URL do seu servidor. Esta é a URL para a qual a impact.com enviará os postbacks.
5. Selecione o método HTTP de sua preferência.
* Veja alguns dos [parâmetros de corpo disponíveis da impact.com](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
* Se você selecionar **POST**, então você deverá 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ê um valor de que precisa? Entre em contato com seu Gerente de Conta (ou [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml)).
6. Selecione **Eventos do ciclo de vida da ação**. Essas configurações são opcionais.
* Digite um **Cabeçalho HTTP**. Se forem necessários vários pares, separe-os com ponto e vírgula.
* Digite um **Atraso mínimo** entre o momento em que um evento não padrão acontece e o momento em que o postback é gerado e enviado ao seu sistema.
* Digite um limite de taxa para o **Máximo de solicitações** que a impact.com pode fazer ao seu sistema por segundo.
* Digite o que você quer que a **Resposta de sucesso** ao postback seja.
* Digite o que você quer que a **Resposta de erro** ao postback seja.
7. 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 esteja executando as ações não padrão. Para saber como testar sua nova configuração de postback, veja a seção *Testar um postback do ciclo de vida da ação* abaixo.
**Exemplo de valores dinâmicos**
Se você configurou variáveis dinâmicas para seus links de rastreamento, você pode configurar uma URL de postback para seu próprio servidor para notificá-lo quando as ações ocorrerem e recuperar o(s) valor(es) preenchido(s) dinamicamente associado(s) à ação.
Este exemplo mostra como passar um valor `SharedId` (um valor que você deseja compartilhar com as marcas) para um parâmetro em um postback (`MyParam`). 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 parâmetro `MyParam` com o valor recuperado de `SharedId`.
Configurar postbacks do ciclo de vida da ação de nível do evento
Esta seção abordará a criação de postbacks para tipos de evento específicos que acompanham quando você gera ações. Se você quiser ser mais seletivo quanto aos tipos de eventos para os quais recebe postbacks, deve configurar postbacks do ciclo de vida da ação de nível do evento.
{% hint style="info" %}
**Observação:** Se você configurar postbacks do ciclo de vida da ação de nível global, não será necessário configurar os de nível do evento.
{% endhint %}
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 (antigamente *rastreador de ações*) para o qual você deseja configurar postbacks do ciclo de vida da ação.
6. Digite a URL do seu servidor. Esta é a URL para a qual a impact.com enviará os postbacks.
7. Selecione o método HTTP de sua preferência.
* Se você selecionar **POST**, então você deverá 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](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
* Não vê um valor de que precisa? Entre em contato com seu Gerente de Conta (ou [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml)).
8. Selecione **Mostrar configurações avançadas**. Essas configurações são opcionais.
* Digite um **Atraso mínimo** entre o momento em que um evento não padrão acontece e o momento em que o postback é gerado e enviado ao seu sistema.
* Digite um limite de taxa para o **Máximo de solicitações** que a impact.com pode fazer ao seu sistema por segundo.
* Digite o que você quer que a **Resposta de sucesso** ao postback seja.
* Digite o que você quer que a **Resposta de erro** ao postback seja.
9. Selecione **Salvar**.
Agora que você configurou postbacks de nível do evento, seu sistema deve começar a receber postbacks para o tipo de evento que você selecionou na *Etapa 5*. Para saber como testar sua nova configuração de postback, veja a seção *Testar um postback do ciclo de vida da ação* abaixo.
**Exemplo de valores dinâmicos**
Se você configurou variáveis dinâmicas para seus links de rastreamento, você pode configurar uma URL de postback para seu próprio servidor para notificá-lo quando as ações ocorrerem e recuperar o(s) valor(es) preenchido(s) dinamicamente associado(s) à ação.
Este exemplo mostra como passar um valor `SharedId` (um valor que você deseja compartilhar com as marcas) para um parâmetro em um postback (`MyParam`). 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 parâmetro `MyParam` com o valor recuperado de `SharedId`.
#### Testar um postback do ciclo de vida da ação
Depois de configurar um postback do ciclo de vida da ação, independentemente do nível ao qual ele se aplica, você deve testá-lo. Você pode executar um postback de teste na impact.com (disponível apenas para postbacks de nível do evento) ou realizar uma conversão.
Se um postback falhar quando a impact.com enviar para a URL de destino, a impact.com tentará a entrega novamente automaticamente. A impact.com tenta novamente um postback com falha até 15 vezes no total. A impact.com ignora as primeiras 3 novas tentativas para respostas HTTP de `400` até `500`. Para ver o cronograma completo de novas tentativas e detalhes de solução de problemas, consulte [Testar e solucionar problemas de uma URL de postback](https://app.gitbook.com/s/b2rE79d9UhOKZQLgzSqx/what-would-you-like-to-learn-about/platform-features/action-management/event-notifications-and-postbacks/test-and-troubleshoot-a-postback-url).
Executar um postback de teste na impact.com
Se você configurou um postback de nível do evento, então poderá testá-lo na sua conta da 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. Em *Postback* seção, selecione  **\[Seta para baixo] Ações**, depois selecione **Iniciar teste**.
5. 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 app 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 informar à marca parceira que você realizará o teste.
1. Na barra de navegação superior, selecione **Conteúdo → Ativos**.
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. Digite **Sub IDs** ou um **Shared ID** conforme necessário. Cada campo requer pelo menos uma entrada.
* Ignore esta etapa se você já tiver valores nesses campos.
6. Opcionalmente, selecione uma **Propriedade** na lista suspensa.
7. Selecione **Salvar**.
8. Selecione **Copiar link de rastreamento**.
9. **Cole** o link em uma nova janela do navegador.
10. Conclua a ação.
11. Depois de cerca de 15 minutos, verifique no seu sistema o postback gerado a partir desta ação de teste.
* Normalmente, o processamento da ação leva cerca de 15 minutos.
* Você também poderá ver essa nova ação pendente na tela de [Ações pendentes](https://app.impact.com/secure/mediapartner/actionworkflows/mp-pending-actions-flow.ihtml) . Se você vir a ação na tela de *Ações pendentes* mas ainda não recebeu um postback, verifique novamente a configuração do seu postback.
12. Peça à sua marca que reverta a ação.
13. 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](https://app.impact.com/secure/mediapartner/MP_Performance_Report/action-workflows/mp-reversed-actions-flow.ihtml) , mas ainda não recebeu um postback, verifique novamente a configuração do seu postback.
Solucionar erros
| Erro | Descrição |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Parâmetro obrigatório ausente | Seu servidor provavelmente está esperando 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 que diferenciam maiúsculas de minúsculas | As variáveis dinâmicas diferenciam maiúsculas de minúsculas e devem estar exatas, o que significa que `{SubId1}` não é o mesmo que `{subid1}`. Verifique novamente se suas variáveis refletem a distinção correta entre maiúsculas e minúsculas. |
| Acesso negado | A maioria dos servidores de postback possui um token ou valor de segurança que deve ser passado 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. |
{% hint style="success" icon="circle-info" %}
**Observação:** Se você não conseguir encontrar nenhum problema com a configuração do seu postback, mas ainda assim não estiver recebendo-os, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml). 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.
{% endhint %}
