> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/partner/pt-br/o-que-voce-gostaria-de-aprender/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md).
# Configurar 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.
{% 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 de evento não acionam eventos de ciclo de vida da ação não padrão.
{% endhint %}
#### 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.
{% hint style="info" %}
**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*.
{% endhint %}
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 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**, 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](https://app.impact.com/support/portal.ihtml)).
6. 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.
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 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.
{% hint style="info" %}
**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.
{% endhint %}
1. Na barra de navegação superior, selecione **Descobrir → Minhas marcas**.
2. Selecione o cartão da marca que é dona do postback que você quer testar.
3. Abaixo do nome da marca, selecione  **\[Mais]** → **Integração de rastreamento**.
4. No canto superior direito da página, selecione **Adicionar postback**.
5. Selecione o tipo de evento (antes *rastreador de ações*) para o qual você deseja configurar postbacks de ciclo de vida da ação.
6. Insira 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**, 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](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
* Não vê o 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.
* 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.
9. 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](/partner/pt-br/o-que-voce-gostaria-de-aprender/platform-features/action-management/event-notifications-and-postbacks/test-and-troubleshoot-a-postback-url.md).
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.
1. Na barra de navegação superior, selecione **Descobrir → Minhas marcas**.
2. Selecione o cartão da marca que é dona do postback que você quer testar.
3. Abaixo do nome da marca, selecione  **Mais** → **Integração de rastreamento**.
4. Do *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 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.
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. 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.
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 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](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 tiver recebido um postback, verifique novamente a configuração do seu postback.
12. Peça à sua marca para reverter 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 tiver recebido um postback, verifique novamente a configuração do seu postback.
Solucionar erros
| Erro | Descrição |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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. |
{% hint style="success" icon="circle-info" %}
**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](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 %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.impact.com/partner/pt-br/o-que-voce-gostaria-de-aprender/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.