# Configurar Postbacks do Ciclo de Vida da Ação

Existem dois tipos principais de postbacks do ciclo de vida de 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 o que melhor atende às suas necessidades para saber mais sobre o processo de configuração.

{% hint style="warning" %}
**Aviso:** Para postbacks em 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 postbacks em nível de evento não dispararão eventos não padrão do ciclo de vida de ação.
{% endhint %}

#### Configurar um postback do ciclo de vida de ação

<details>

<summary>Configurar um postback do ciclo de vida de ação em nível global</summary>

Esta seção cobrirá 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 processar esses postbacks ou que desejam notificações para todos os eventos não padrão devem configurar postbacks do ciclo de vida de ação em nível global.

{% hint style="info" %}
**Observação:** Se você quiser ser mais seletivo quanto aos tipos de eventos para os quais receberá postbacks, veja a seção abaixo para configurar *postbacks do ciclo de vida de ação em 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%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Perfil do usuário] → Configurações**. &#x20;
2. Em *Técnico*, selecione **Notificações de evento**.
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%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Editar]**.
4. Insira a URL do seu servidor. Esta é a URL para a qual o 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ê deverá então inserir o corpo da requisição e selecionar um **Formato de 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 a partir da configuração do seu próprio sistema, e os valores serão o ponto de dados correspondente que o impact.com fornece e que devem ser inseridos entre colchetes `{ }`.

     <div data-with-frame="true"><figure><img src="https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-16c42a102e36c3c3d44b22c66b31b8cf4643aae1%2F6c821ff8c8e1cfaea1b1d7c908754dd4db816de21d5db59b4ddbd07bf14b1bb4.jpg?alt=media" alt=""><figcaption></figcaption></figure></div>
   * Não vê um valor que precisa? Entre em contato com seu Gerente de Conta (ou [contate o suporte](https://app.impact.com/support/portal.ihtml)).
6. Selecione **Eventos do ciclo de vida da ação**. Estas configurações são opcionais.
   * Insira um **Cabeçalho HTTP**. Se vários pares forem necessários, 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 as **Solicitações Máximas** que o impact.com pode fazer ao seu sistema por segundo.
   * Insira o que você deseja que a **Resposta de Sucesso** seja para um postback.
   * Insira o que você deseja que a **Resposta de Erro** seja para um postback.
7. Selecione **Salvar**.

Agora que você configurou postbacks em nível global, seu sistema deve começar a receber postbacks sempre que ocorrerem eventos não padrão, independentemente da marca que executou as ações não padrão. Para saber como testar sua nova configuração de postback, veja a *Teste um postback do ciclo de vida de 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 seu próprio servidor para notificá-lo quando ações ocorrerem e recuperar o(s) valor(es) preenchido(s) dinamicamente associados à ação.

Este exemplo mostra como passar um `SharedId` valor (um valor que você deseja compartilhar com marcas) para um parâmetro em um postback (`MyParam`). Algumas marcas podem exigir que você configure isso.

<div data-with-frame="true"><figure><img src="https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-b7c6cf339a60877d5823e6b9a080e8e153aa6386%2F8ec14f7b9f75bc6065c6310d30d43ae0f8256c7e075757d03ce64a5fe16476ae.png?alt=media" alt=""><figcaption></figcaption></figure></div>

Uma URL de postback ficaria algo como:

`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`

A URL de postback preencherá o `MyParam` parâmetro com o valor recuperado de `SharedId`.

</details>

<details>

<summary>Configurar postbacks do ciclo de vida de ação em nível de evento</summary>

Esta seção abordará a criação de postbacks para tipos de evento específicos que rastreiam quando você gera ações. Se quiser ser mais seletivo com os tipos de eventos para os quais recebe postbacks, você deve configurar postbacks do ciclo de vida de ação em nível de evento.

{% hint style="info" %}
**Observação:** Se você configurou postbacks do ciclo de vida de ação em 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 possui o 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ção*) para o qual você deseja configurar postbacks do ciclo de vida de ação.
6. Insira a URL do seu servidor. Esta é a URL para a qual o impact.com enviará os postbacks.
7. Selecione seu método HTTP preferido.
   * Se você selecionar **POST**, você deverá então inserir o corpo da requisição e selecionar um **Formato de 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 a partir da configuração do seu próprio sistema, e os valores serão o ponto de dados correspondente que o impact.com fornece e que devem ser inseridos entre chaves { }.

     <div data-with-frame="true"><figure><img src="https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-9cec675aa05964dd4b9db329acc2cae7a9d85de8%2Fd34ce186243db11585c9d497d92cc26b633031bbab0d67ae06fc109dae4ceb0d.jpg?alt=media" alt=""><figcaption></figcaption></figure></div>
   * Veja alguns do impact.com [parâmetros de corpo disponíveis](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * Não vê um valor que precisa? Entre em contato com seu Gerente de Conta (ou [contate o suporte](https://app.impact.com/support/portal.ihtml)).
8. Selecione **Mostrar configurações avançadas**. Estas 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 as **Solicitações Máximas** que o impact.com pode fazer ao seu sistema por segundo.
   * Insira o que você deseja que a **Resposta de Sucesso** seja para um postback.
   * Insira o que você deseja que a **Resposta de Erro** seja para um postback.
9. Selecione **Salvar**.

Agora que você configurou postbacks em nível de evento, seu sistema deve começar a receber postbacks para o tipo de evento que você selecionou em *Etapa 5*. Para saber como testar sua nova configuração de postback, veja a *Teste um postback do ciclo de vida de 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 seu próprio servidor para notificá-lo quando ações ocorrerem e recuperar o(s) valor(es) preenchido(s) dinamicamente associados à ação.

Este exemplo mostra como passar um `SharedId` valor (um valor que você deseja compartilhar com marcas) para um parâmetro em um postback (`MyParam`). Algumas marcas podem exigir que você configure isso.

<div data-with-frame="true"><figure><img src="https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-b7c6cf339a60877d5823e6b9a080e8e153aa6386%2F8ec14f7b9f75bc6065c6310d30d43ae0f8256c7e075757d03ce64a5fe16476ae.png?alt=media" alt=""><figcaption></figcaption></figure></div>

Uma URL de postback ficaria algo como:

`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`

A URL de postback preencherá o `MyParam` parâmetro com o valor recuperado de `SharedId`.

</details>

#### Teste um postback do ciclo de vida de ação

Depois de configurar um postback do ciclo de vida de ação, independentemente do nível ao qual se aplica, você deve testá-lo. Você pode executar um postback de teste no impact.com (disponível apenas para postbacks em nível de evento) ou realizar uma conversão.

<details>

<summary>Executar um postback de teste no impact.com</summary>

Se você configurou um postback em nível de evento, então pode testá-lo dentro da sua conta 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 ![](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. A partir do *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**, então selecione **Iniciar Teste**.
5. Confirme se a URL do postback está correta, então selecione **Iniciar teste**.

</details>

<details>

<summary>Criar uma conversão de teste</summary>

Este teste não será realizado no aplicativo web do impact.com. Em vez disso, você realizará 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 → Recursos**.
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%2Fgit-blob-d0b6669ae76a7bef06a8d6940d7ad5c16bb8d018%2F7cb018d4face8d7cceb880eb5086c812e764fbcfe6f2a0377f88bc7576973070.svg?alt=media) **\[Ativar]** **Parâmetros de Rastreamento**.
5. Insira **Sub IDs** ou um **Shared ID** conforme exigido. Cada campo requer pelo menos uma entrada.
   * Pule esta etapa se você já tiver valores nesses campos.
6. Opcionalmente, selecione uma **Propriedade** no menu suspenso.
7. Selecione **Salvar**.
8. Selecione **Copiar Link de Rastreamento**.
9. **Cole** o link em uma janela de navegador nova.
10. Complete a ação.
11. Após cerca de 15 minutos, verifique seu sistema pelo postback gerado a partir desta ação de teste.
    * 15 minutos é geralmente quanto tempo o processamento de ação leva.
    * Você também poderá ver esta nova ação pendente na tela [Ações Pendentes](https://app.impact.com/secure/mediapartner/actionworkflows/mp-pending-actions-flow.ihtml) . Se você vir a ação na tela *Ações Pendentes* mas ainda não recebeu um postback, verifique novamente sua configuração de postback.
12. Peça à sua marca para reverter a ação.
13. Verifique seu sistema pelo postback gerado a partir dessa reversão.
    * Se você vir a ação revertida na tela [Ações Revertidas](https://app.impact.com/secure/mediapartner/MP_Performance_Report/action-workflows/mp-reversed-actions-flow.ihtml) , mas não recebeu um postback, verifique novamente sua configuração de postback.

</details>

<details>

<summary>Solucionar erros</summary>

| 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 com diferença entre maiúsculas e minúsculas | Variáveis dinâmicas diferenciam maiúsculas de minúsculas e devem ser exatas, ou seja, `{SubId1}` não é o mesmo que `{subid1}`. Verifique se suas variáveis refletem a sensibilidade correta a maiúsculas e minúsculas.                                                                                                   |
| Acesso negado                                         | A maioria dos servidores de Postback possui um token ou valor de segurança que deve ser enviado juntamente 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 sobre o token ou valor de segurança necessário para acessar o servidor. |

</details>

{% hint style="info" %}
**Observação:** Se você não conseguir encontrar nenhum problema em sua configuração de postback, mas ainda assim não os estiver recebendo, [contate 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 deles, bem como o corpo de cada postback. Essas informações podem ajudá-lo a depurar sua configuração com sucesso
{% endhint %}
