> 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
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 específicos de evento. Selecione 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 um estorno. Observe que os postbacks de nível do evento não serão acionados para eventos não padrão do ciclo de vida da açã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 só vez. Parceiros que têm apenas um sistema capaz de receber e consumir 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 quanto aos tipos de evento para os quais receberá postbacks, consulte 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. Insira a URL do seu servidor. Esta é a URL para a qual o impact.com enviará os postbacks.
5. Selecione o método HTTP de sua preferência.
* Veja alguns dos [parâmetros de corpo disponíveis](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 vir da configuração do seu próprio sistema, e os valores serão o ponto de dados correspondente escolhido, fornecido pelo impact.com, e devem ser inseridos entre colchetes `{ }`.
* Não vê o valor de que precisa? Entre em contato com o 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 o impact.com pode fazer ao seu sistema por segundo.
* Insira o que você quer que a **Resposta de sucesso** de um postback seja.
* Insira o que você quer que a **Resposta de erro** de 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 esteja realizando 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, pode configurar uma URL de postback para o seu próprio servidor para notificá-lo quando ações ocorrerem e recuperar o(s) valor(es) preenchido(s) dinamicamente associado(s) à ação.
Este exemplo mostra como passar um valor de `SharedId` (um valor que você quer 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 assim:
`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`
A URL de postback preencherá o `MyParam` parâmetro 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 específicos de evento que monitoram quando você gera ações. Se você quiser ser mais seletivo com os tipos de evento 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 (antigo *rastreador de ação*) para o qual você deseja configurar postbacks do ciclo de vida da ação.
6. Insira a URL do seu servidor. Esta é a URL para a qual o 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 vir da configuração do seu próprio sistema, e os valores serão o ponto de dados correspondente escolhido, fornecido pelo impact.com, e devem ser inseridos entre colchetes { }.
* Veja alguns dos [parâmetros de corpo disponíveis](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 o 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 o impact.com pode fazer ao seu sistema por segundo.
* Insira o que você quer que a **Resposta de sucesso** de um postback seja.
* Insira o que você quer que a **Resposta de erro** de um 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, pode configurar uma URL de postback para o seu próprio servidor para notificá-lo quando ações ocorrerem e recuperar o(s) valor(es) preenchido(s) dinamicamente associado(s) à ação.
Este exemplo mostra como passar um valor de `SharedId` (um valor que você quer 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 assim:
`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`
A URL de postback preencherá o `MyParam` parâmetro 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 no impact.com (disponível apenas para postbacks de nível do evento) ou realizar uma conversão.
Se um postback falhar quando o impact.com enviar para a URL de destino, o impact.com tentará a entrega novamente automaticamente. O impact.com tenta reenviar um postback com falha até 15 vezes no total. O impact.com ignora as 3 primeiras tentativas para respostas HTTP de `400` até `500`. Para ver o cronograma completo de tentativas e 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 no impact.com
Se você configurou um postback de nível do evento, então pode testá-lo na sua conta do 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. Na seção *Postback* , 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 do impact.com. Em vez disso, você fará um teste 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. Insira **Sub IDs** ou um **Shared ID** 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. Após cerca de 15 minutos, verifique seu sistema para o postback que foi gerado a partir desta ação de teste.
* 15 minutos costuma ser o tempo de processamento da ação.
* 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 tiver recebido um postback, verifique novamente a configuração do seu postback.
12. Peça à sua marca para reverter a ação.
13. Verifique em 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 a 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 diferenciam maiúsculas de minúsculas | As variáveis dinâmicas diferenciam maiúsculas de minúsculas e devem ser exatas, ou seja, `{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 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 mais sobre o 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 os estiver recebendo, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml). O 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 ajudá-lo a depurar a 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.