> 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/sobre-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 de 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 de evento não dispararão 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 só vez. Parceiros que têm apenas um sistema que pode 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="success" %} **Observação:** Se você quiser ser mais seletivo em relação 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 de evento*. {% endhint %} 1. Na barra de navegação superior, selecione ![](https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FhyR4iWDS0fO9ZcKFGf82%2FUser%20profile.svg?alt=media\&token=281d8f1b-b9c5-4208-a0a2-a078f54e0eb6) **\[Perfil do usuário] → Configurações**. 2. Em *Técnico*, selecione [**Notificações de evento**](https://app.impact.com/secure/mediapartner/accountSettings/view-edit-pingback-settings-flow.ihtml). 3. Ao lado de *Eventos do ciclo de vida da ação*, selecione ![](https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FZMLVDhHLGefqRDHaIWTm%2FEdit.svg?alt=media\&token=1f1168ae-5bd3-456c-a366-904d0ecf00cb) **\[Editar]**. 4. Insira a URL do seu servidor. Esta é a URL para a qual a impact.com enviará os postbacks. 5. Selecione seu método HTTP preferido. * 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 querer 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 de sua escolha fornecido pela impact.com e devem ser inseridos entre chaves { }. `{ }`.
* 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. * Insira um **Cabeçalho HTTP**. Se forem necessários vários pares, separe-os com um ponto e vírgula. * Insira um **Atraso mínimo** entre o momento em que 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 a 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 estiver executando as ações não padrão. Para saber como testar sua nova configuração de postback, consulte a *Testar um postback do ciclo de vida da 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 o 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 `SharedId` valor (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 ficaria mais ou menos 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 de evento Esta seção abordará a criação de postbacks para tipos de evento específicos que rastreiam 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 de evento. {% hint style="success" %} **Observação:** Se você configurar postbacks do 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 →** [**Marcas**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml). 2. Selecione o cartão da marca proprietária do postback que você deseja testar. 3. Abaixo do nome da marca, selecione ![](https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[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ções*) 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 a impact.com enviará os postbacks. 7. Selecione seu método HTTP preferido. * 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 querer 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 de sua escolha fornecido pela impact.com e devem ser inseridos entre chaves { }.
* 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ê 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. * Insira um **Atraso mínimo** entre o momento em que 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 a 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 de 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, consulte a *Testar um postback do ciclo de vida da 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 o 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 `SharedId` valor (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 ficaria mais ou menos 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 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 publicar na sua URL de destino, a impact.com tentará reenviar automaticamente. A impact.com tentará reenviar um postback com falha até 15 vezes no total. A impact.com ignora as 3 primeiras tentativas de reenvio para respostas HTTP de `400` até `500`. Para 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/sobre-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 impact.com. 1. Na barra de navegação superior, selecione **Descobrir →** [**Marcas**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml). 2. Selecione o cartão da marca proprietária do postback que você deseja testar. 3. Abaixo do nome da marca, selecione ![](https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **Mais** → **Integração de rastreamento**. 4. Da *Postback* seção, selecione ![](https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-df93ac0f80fc5cece7983980a5ce3fbcf19aabce%2F3ef9d737089bc07dbb7e4fd41a97edfbaec261e4f55ab3a1666f3daf957f69c3.svg?alt=media) **\[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 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 **Gerenciar →** [**Criativos da marca**](https://app.impact.com/secure/mediapartner/ads/searchAdsDirectoryMP.ihtml#adType=all). 2. Selecione um anúncio. 3. Abaixo do nome do anúncio, selecione **Obter link de rastreamento**. 4. Selecione ![](https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FEv341AdIiPndQSb7uGMI%2FToggle%20on.svg?alt=media\&token=4ae8972d-c510-4ee2-adc5-e7170981650b) **\[Ativar]** **Parâmetros de rastreamento**. 5. Insira **Sub IDs** ou um **ID compartilhado** 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. Após cerca de 15 minutos, verifique no seu sistema o postback que foi gerado por esta ação de teste. * 15 minutos é geralmente o tempo que o processamento da ação leva. * Você também poderá ver essa nova ação pendente na [Ações pendentes](https://app.impact.com/secure/mediapartner/actionworkflows/mp-pending-actions-flow.ihtml) tela. Se você vir a ação na *Ações pendentes* tela, 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 [Ações revertidas](https://app.impact.com/secure/mediapartner/MP_Performance_Report/action-workflows/mp-reversed-actions-flow.ihtml) tela, mas ainda não tiver recebido um postback, verifique novamente a configuração do seu postback.
### Solucionar erros Use a tabela de referência abaixo para identificar e resolver problemas comuns encontrados ao configurar seus postbacks do ciclo de vida da ação.
ErroDescrição
Parâmetro obrigatório ausenteSeu 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 fixo.
Variáveis sensíveis a maiúsculas e minúsculasAs 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 respeitam a sensibilidade correta a maiúsculas e minúsculas.
Acesso negadoA maioria dos servidores de postback tem um token ou valor de segurança que precisa ser passado junto com as variáveis dinâmicas. Trabalhe com a equipe técnica do seu site (ou consulte a documentação do seu provedor de 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 na configuração do seu postback, mas ainda não os estiver recebendo, [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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.impact.com/partner/pt-br/sobre-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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.