# Habilitar Postbacks de Notificação de Eventos para Marcas

Postbacks de Notificação de Evento são notificações HTTP padrão que informam quando uma ação, clique ou outro evento ocorre. Os Postbacks de Evento podem ser configurados para enviar dados de eventos para seus sistemas internos de relatórios, fornecendo uma visão atualizada dos seus eventos.

#### Ver Postbacks de Notificação de Evento

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Perfil do usuário] → Configurações**.&#x20;
2. No *Técnico* seção à esquerda, selecione [Notificações de Evento](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?).

#### Ativar Postbacks de Evento

As instruções abaixo ajudarão você a configurar os cinco tipos a seguir de Postbacks de Evento:

* **Eventos do Ciclo de Vida da Ação** emitirá uma solicitação HTTP para um URL especificado (e quaisquer parâmetros incluídos) quando uma ação for rastreada, modificada ou revertida.
* **Eventos de Solicitação de Valor de Rastreamento** emitirá uma solicitação HTTP para um URL especificado (e quaisquer parâmetros incluídos) quando solicitações de rastreamento forem criadas.
* **Eventos de Limpeza de Ação** emitirá uma solicitação HTTP para um URL especificado (e quaisquer parâmetros incluídos) quando ações forem limpas.
* **Eventos de Consulta de Ação** emitirá uma solicitação HTTP para um URL especificado (e quaisquer parâmetros incluídos) quando consultas de ação forem criadas ou resolvidas.
* **Eventos de Conclusão de Trabalho** emitirá uma solicitação HTTP para um URL especificado (e quaisquer parâmetros adicionais) quando um trabalho for concluído para um [Exportação de Relatório](https://integrations.impact.com/impact-brand/reference/export-reports) ou [Clique em Exportar](https://integrations.impact.com/impact-brand/reference/retrieve-export-click).

1. A partir do [Notificações de Evento Postbacks](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?) tela, passe o cursor sobre o **título que você deseja ativar** e selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Editar]** no lado direito.
2. Adicione o **URL** que a impact.com deve usar para Postbacks de Evento, junto com quaisquer **parâmetros opcionais** no URL. Consulte a seção abaixo para uma lista completa desses parâmetros e um exemplo de URL (para o `GET` método).
3. Selecione o Método HTTP: `GET` é a opção recomendada, já que parâmetros opcionais podem ser passados diretamente no URL. Selecione `POST`se, em vez disso, seu sistema exigir que a impact.com envie os dados no corpo da requisição.
   * Se você usar o `POST` método, selecione o **Formato do Corpo** nos botões de opção.
4. Selecione **Salvar** para concluir o processo.

{% hint style="info" %}
**Observação**: A etapa 3 não se aplica a Eventos de Consulta de Ação — as strings de consulta são selecionadas usando caixas de seleção em vez disso.
{% endhint %}

{% hint style="info" %}
**Exemplo de Postback de Evento**: Este exemplo inclui os seguintes parâmetros:

* `{CampaignId}`
* `{MediaPartnerId}`
* `{ActionId}`
* `{Status}`
* `{LockingDate}`
* `{Payout}`
* `{Amount}`

```programlisting
[https://www.someadvertiser.com?myCampaignId=]{}{CAMPAIGNID}&theMpId={MEDIAPARTNERID}&theActionId={ACTIONID}&status={STATUS}&lockingDate={LOCKINGDATE}&mpPayout={PAYOUT}&saleAmt={AMOUNT}
```

Observe as propriedades definidas entre chaves. A solicitação real será para o URL (assumindo valores de parâmetro correspondentes):

```programlisting
https://www.myadvertiser.com?myCampaignId=1000&theMpId=900&theActionId=12323&status=PENDING&lockingDate=2015-01-01&mpPayout=50.00&saleAmt=100.00
```

{% endhint %}

<details>

<summary>Parâmetros opcionais para Postbacks de Evento</summary>

| String de Consulta     | Descrição                                                                                            |
| ---------------------- | ---------------------------------------------------------------------------------------------------- |
| {CampaignId}           | ID da Campanha                                                                                       |
| {ActionTrackerId}      | ID do Tipo de Evento                                                                                 |
| {MediaPartnerId}       | ID do Parceiro                                                                                       |
| {CampaignName}         | Nome da Campanha                                                                                     |
| {ActionTrackerName}    | Nome do Tipo de Evento                                                                               |
| {MediaPartnerName}     | Nome do Parceiro                                                                                     |
| {ActionId}             | ID da Ação                                                                                           |
| {Status}               | Status da Ação                                                                                       |
| {StatusDetail}         | Mais detalhes sobre o status da ação, por exemplo o motivo de uma modificação da ação                |
| {AdId}                 | ID do Anúncio                                                                                        |
| {Payout}               | Pagamento da ação ao Parceiro, na moeda do Parceiro.                                                 |
| {DeltaPayout}          | A alteração do Valor do Pagamento                                                                    |
| {IntendedPayout}       | O Valor de Pagamento pretendido para uma ação acima do limite                                        |
| {Amount}               | Valor da ação, na moeda do anunciante. Aplicável apenas para ações de venda.                         |
| {DeltaAmount}          | Valor Corrigido em relação à ação anterior.                                                          |
| {IntendedAmount}       | O Valor de Venda pretendido para uma ação acima do limite                                            |
| {Currency}             | Moeda da ação                                                                                        |
| {OriginalCurrency}     | Moeda original (ou seja, do carrinho) da ação                                                        |
| {OriginalAmount}       | Valor original (ou seja, do carrinho) da ação                                                        |
| {EventDate}            | A data em que a conversão ocorreu                                                                    |
| {CreationDate}         | A data em que a ação foi criada no sistema                                                           |
| {LockingDate}          | Data, no fuso horário do anunciante, quando a ação será bloqueada.                                   |
| {ClearedDate}          | Data, no fuso horário do anunciante, quando a ação será liberada.                                    |
| {ReferringDomain}      | Domínio onde a referência ocorreu (se online)                                                        |
| {LandingPageUrl}       | URL da página de destino (se online)                                                                 |
| {RefCustomerArea}      | Área do cliente, derivada do endereço IP                                                             |
| {RefCustomerCity}      | Cidade do cliente, derivada do endereço IP                                                           |
| {RefCustomerRegion}    | Região do cliente, derivada do endereço IP                                                           |
| {RefCustomerCountry}   | Código do País do Cliente, derivado do endereço IP                                                   |
| {SharedId}             | Um valor que um Parceiro pode incluir na URL do clique que se torna disponível para seus anunciantes |
| {PromoCode}            | Código promocional                                                                                   |
| {CustomerStatus}       | Status do cliente                                                                                    |
| {Oid}                  | ID do Pedido                                                                                         |
| {Note}                 | Uma nota fornecida com a ação reportada                                                              |
| {CustomerPostCode}     | Código Postal do Cliente                                                                             |
| {CustomerCity}         | Cidade do cliente, fornecida com a ação reportada                                                    |
| {CustomerCountry}      | Código do País do Cliente, fornecido com a ação reportada                                            |
| {CustomerRegion}       | Região do cliente, fornecida com a ação reportada                                                    |
| {CustomerId}           | ID do Cliente                                                                                        |
| {CustomerEmail}        | Email do cliente hashado, fornecido com a ação reportada                                             |
| {IpAddress}            | Endereço IP do dispositivo                                                                           |
| {CallerId}             | Número de telefone do chamador                                                                       |
| {Text1-10}             | <p>Fornecido com a ação reportada</p><p>Por exemplo, {Text2}, {Text4}, {Text5}, {Text7}</p>          |
| {Date1-10}             | <p>Fornecido com a ação reportada</p><p>Por exemplo, {Date3}, {Date4}, {Date5}, {Date8}</p>          |
| {Money1}               | Fornecido com a ação reportada                                                                       |
| {Money2}               | Fornecido com a ação reportada                                                                       |
| {Money3}               | Fornecido com a ação reportada                                                                       |
| {Numeric1-10}          | <p>Fornecido com a ação reportada</p><p>Por exemplo, {Numeric1}, {Numeric4}, {Numeric6}</p>          |
| {appPackage}           | Pacote do aplicativo móvel                                                                           |
| {appName}              | Nome do aplicativo móvel                                                                             |
| {appVersion}           | Versão do aplicativo móvel                                                                           |
| {deviceOs}             | Sistema operacional do dispositivo                                                                   |
| {deviceOsVersion}      | Versão do sistema operacional do dispositivo                                                         |
| {deviceManuf}          | Fabricante do dispositivo                                                                            |
| {deviceModel}          | Modelo do dispositivo                                                                                |
| {macAddress}           | Endereço MAC em maiúsculas                                                                           |
| {macAddressLower}      | Endereço MAC em minúsculas                                                                           |
| {macAddressAlpha}      | Endereço MAC sem dois-pontos                                                                         |
| {macAddressAlphaLower} | Endereço MAC sem dois-pontos em minúsculas                                                           |
| {macAddressSha1}       | Endereço MAC com hash SHA1                                                                           |
| {macAddressSha1Lower}  | Endereço MAC em minúsculas com hash SHA1                                                             |
| {macAddressMd5}        | Endereço MAC com hash MD5                                                                            |
| {macAddressMd5Lower}   | Endereço MAC em minúsculas com hash MD5                                                              |
| {iosIfa}               | Identificador de publicidade iOS                                                                     |
| {iosIfaSha1}           | Identificador de publicidade iOS com hash SHA1                                                       |
| {iosIfaMd5}            | Identificador de publicidade iOS com hash MD5                                                        |
| {iosIfaNoHyphens}      | Identificador de publicidade iOS sem hífens                                                          |
| {iosAdTracking}        | Configuração de Rastreamento de Anúncios iOS                                                         |
| {androidId}            | ID do Android                                                                                        |
| {androidIdSha1}        | ID do Android com hash SHA1                                                                          |
| {androidIdMd5}         | ID do Android com hash MD5                                                                           |
| {odin1}                | Hash SHA-1 do endereço MAC do adaptador Wi‑Fi do telefone                                            |
| {openUdid}             | OpenUDID do dispositivo                                                                              |
| {deviceId}             | ID do dispositivo                                                                                    |
| {deviceIp}             | IP do dispositivo                                                                                    |

</details>

<details>

<summary>Parâmetros por item</summary>

Se você coletar dados por item para ações, também pode incluir esses dados nas suas notificações de Evento do Ciclo de Vida da Ação.

"join" é uma função que recebe de 3 a 5 argumentos:

* **Argumento 1:** A coleção.
* **Argumento 2:** Um símbolo para vincular a cada valor na coleção.
* **Argumento 3:** A expressão a ser calculada para cada membro da coleção.
* **Argumento 4:** O separador opcional entre cada expressão (o padrão é vírgula).
* **Argumento 5:** um prefixo opcional, que estará presente somente se houver dados na coleção.

Exemplos assumindo 3 itens com SKUs GH23, UT66 e RW87 respectivamente.

"items" é uma coleção de dados do item. Cada item tem "cat", "sku", "qty", "amt", "rbt", "name"...

| Expressão                                              | Resultado                                                  |
| ------------------------------------------------------ | ---------------------------------------------------------- |
| {join(items, i, "sku{i}={i.sku}", "&", "?")}           | ?sku1=GH23\&sku2=UT66\&sku3=RW87                           |
| {join(items, i, "cat{i}={i.cat}", "&", "?")}           | ?cat1=Watches\&cat2=Shoes\&cat3=Hats                       |
| {join(items, i, "qty{i}={i.qty}", "&", "?")}           | ?qty1=3\&qty2=4\&qty3=11                                   |
| {join(items, i, "amt{i}={i.amt}", "&", "?")}           | ?amt1=2.92\&amt2=99.32\&amt3=4.99                          |
| {join(items, i, "cartamt{i}={i.cartamt}", "&", "?")}   | ?cartamt1=50.01\&cartamt2=23.89\&cartamt3=34.00            |
| {join(items, i, "rbt{i}={i.rbt}", "&", "?")}           | ?rbt1=1.00\&rbt2=5.00\&rbt3=1.50                           |
| {join(items, i, "name{i}={i.name}", "&", "?")}         | ?name1=1.00\&name2=5.00\&name3=1.50                        |
| {join(items, i, "promo{i}={i.promo}", "&", "?")}       | ?promo1=HAPPY\&promo2=H10DAY\&promo3=NOW30                 |
| {join(items, i, "price{i}={i.price}", "&", "?")}       | ?price1=1.70\&price2=2.00\&price3=0.00                     |
| {join(items, i, "brand{i}={i.brand}", "&", "?")}       | ?brand1=lulu\&brand2=NB\&brand3=impact                     |
| {join(items, i, "discount{i}={i.disc}", "&", "?")}     | ?discount1=2.00\&discount2=0.50\&discount3=10.00           |
| {join(items, i, "itemlist{i}={i.itemlist}", "&", "?")} | ?itemlist1=accessories\&itemlist2=apparel\&itemlist3=games |

</details>
