# Habilitar envíos de notificaciones de eventos (postbacks) para marcas

Las notificaciones de postbacks de eventos son notificaciones HTTP estándar que le informan cuando ocurre una acción, clic u otro evento. Los postbacks de eventos se pueden configurar para enviar datos de eventos a sus sistemas internos de informes, proporcionando una vista actualizada de sus eventos.

#### Ver postbacks de notificación de eventos

1. En la barra de navegación superior, seleccione ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Perfil de usuario] → Configuración**.&#x20;
2. En el *Técnico* sección en la izquierda, seleccione [Notificaciones de eventos](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?).

#### Habilitar postbacks de eventos

Las instrucciones a continuación le ayudarán a configurar los cinco tipos siguientes de postbacks de eventos:

* **Eventos del ciclo de vida de la acción** emitirá una solicitud HTTP a una URL especificada (y a cualquier parámetro incluido) cuando se rastree, modifique o revierta una acción.
* **Eventos de solicitud de valor de seguimiento** emitirá una solicitud HTTP a una URL especificada (y a cualquier parámetro incluido) cuando se creen solicitudes de seguimiento.
* **Eventos de depuración de acciones** emitirá una solicitud HTTP a una URL especificada (y a cualquier parámetro incluido) cuando se limpien acciones.
* **Eventos de consulta de acciones** emitirá una solicitud HTTP a una URL especificada (y a cualquier parámetro incluido) cuando se creen o resuelvan consultas de acciones.
* **Eventos de finalización de trabajo** emitirá una solicitud HTTP a una URL especificada (y a cualquier parámetro adicional) cuando se haya completado un trabajo para un [Exportación de informe](https://integrations.impact.com/impact-brand/reference/export-reports) o [Exportación de clics](https://integrations.impact.com/impact-brand/reference/retrieve-export-click).

1. Desde el [Postbacks de notificación de eventos](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?) pantalla, pase el cursor sobre el **encabezado que desea habilitar** y seleccione ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Editar]** en el lado derecho.
2. Agregue el **URL** que impact.com debe usar para los postbacks de eventos, junto con cualquier **parámetros opcionales** en la URL. Consulte la sección a continuación para una lista completa de estos parámetros y un ejemplo de URL (para el `GET` método).
3. Seleccione el método HTTP: `GET` es la opción recomendada, ya que los parámetros opcionales se pueden pasar directamente en la URL. Seleccione `POST`si, en cambio, su sistema requiere que impact.com envíe los datos en el cuerpo de la solicitud.
   * Si usa el `POST` método, seleccione el **Formato del cuerpo** de los botones de opción.
4. Selecciona **Guardar** para completar el proceso.

{% hint style="info" %}
**Nota**: El paso 3 no se aplica a los eventos de consulta de acciones: las cadenas de consulta se seleccionan usando casillas de verificación en su lugar.
{% endhint %}

{% hint style="info" %}
**Ejemplo de postback de evento**: Este ejemplo incluye los siguientes 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 las propiedades definidas entre llaves. La solicitud real será para la URL (asumiendo valores de parámetros correspondientes):

```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 opcionales para postbacks de eventos</summary>

| Cadena de consulta     | Descripción                                                                                           |
| ---------------------- | ----------------------------------------------------------------------------------------------------- |
| {CampaignId}           | ID de campaña                                                                                         |
| {ActionTrackerId}      | ID del tipo de evento                                                                                 |
| {MediaPartnerId}       | ID del socio                                                                                          |
| {CampaignName}         | Nombre de la campaña                                                                                  |
| {ActionTrackerName}    | Nombre del tipo de evento                                                                             |
| {MediaPartnerName}     | Nombre del Socio                                                                                      |
| {ActionId}             | ID de la acción                                                                                       |
| {Status}               | Estado de la acción                                                                                   |
| {StatusDetail}         | Más detalles sobre el estado de la acción, por ejemplo la razón de una modificación de la acción      |
| {AdId}                 | ID del anuncio                                                                                        |
| {Payout}               | Pago de la acción al Partner, en la moneda del Partner.                                               |
| {DeltaPayout}          | El cambio del monto del pago                                                                          |
| {IntendedPayout}       | El monto de pago previsto para una acción por encima del límite                                       |
| {Amount}               | Monto de la acción, en la moneda del anunciante. Solo aplicable para acciones de venta.               |
| {DeltaAmount}          | Monto corregido de la acción previa.                                                                  |
| {IntendedAmount}       | El monto de venta previsto para una acción por encima del límite                                      |
| {Currency}             | Moneda de la acción                                                                                   |
| {OriginalCurrency}     | Moneda original (es decir, del carrito) de la acción                                                  |
| {OriginalAmount}       | Monto original (es decir, del carrito) de la acción                                                   |
| {EventDate}            | La fecha en la que se realizó la conversión                                                           |
| {CreationDate}         | La fecha en que la acción se crea en el sistema                                                       |
| {LockingDate}          | Fecha, en la zona horaria del anunciante, cuando la acción será bloqueada.                            |
| {ClearedDate}          | Fecha, en la zona horaria del anunciante, cuando la acción será limpiada.                             |
| {ReferringDomain}      | Dominio donde tuvo lugar la referencia (si es en línea)                                               |
| {LandingPageUrl}       | URL de la página de destino (si es en línea)                                                          |
| {RefCustomerArea}      | Área del cliente, derivada de la dirección IP                                                         |
| {RefCustomerCity}      | Ciudad del cliente, derivada de la dirección IP                                                       |
| {RefCustomerRegion}    | Región del cliente, derivada de la dirección IP                                                       |
| {RefCustomerCountry}   | Código de país del cliente, derivado de la dirección IP                                               |
| {SharedId}             | Un valor que un Partner puede incluir en la URL de clic que se vuelve disponible para sus anunciantes |
| {PromoCode}            | Código promocional                                                                                    |
| {CustomerStatus}       | Estado del cliente                                                                                    |
| {Oid}                  | Id de pedido                                                                                          |
| {Note}                 | Una nota proporcionada con la acción reportada                                                        |
| {CustomerPostCode}     | Código postal del cliente                                                                             |
| {CustomerCity}         | Ciudad del cliente, proporcionada con la acción reportada                                             |
| {CustomerCountry}      | Código de país del cliente, proporcionado con la acción reportada                                     |
| {CustomerRegion}       | Región del cliente, proporcionada con la acción reportada                                             |
| {CustomerId}           | ID del cliente                                                                                        |
| {CustomerEmail}        | Correo electrónico del cliente encriptado (hashed), proporcionado con la acción reportada             |
| {IpAddress}            | Dirección IP del dispositivo                                                                          |
| {CallerId}             | Número de teléfono del llamante                                                                       |
| {Text1-10}             | <p>Proporcionado con la acción reportada</p><p>Por ejemplo, {Text2}, {Text4}, {Text5}, {Text7}</p>    |
| {Date1-10}             | <p>Proporcionado con la acción reportada</p><p>Por ejemplo, {Date3}, {Date4}, {Date5}, {Date8}</p>    |
| {Money1}               | Proporcionado con la acción reportada                                                                 |
| {Money2}               | Proporcionado con la acción reportada                                                                 |
| {Money3}               | Proporcionado con la acción reportada                                                                 |
| {Numeric1-10}          | <p>Proporcionado con la acción reportada</p><p>Por ejemplo, {Numeric1}, {Numeric4}, {Numeric6}</p>    |
| {appPackage}           | Paquete de la aplicación móvil                                                                        |
| {appName}              | Nombre de la aplicación móvil                                                                         |
| {appVersion}           | Versión de la aplicación móvil                                                                        |
| {deviceOs}             | Sistema operativo del dispositivo                                                                     |
| {deviceOsVersion}      | Versión del sistema operativo del dispositivo                                                         |
| {deviceManuf}          | Fabricante del dispositivo                                                                            |
| {deviceModel}          | Modelo del dispositivo                                                                                |
| {macAddress}           | Dirección MAC en mayúsculas                                                                           |
| {macAddressLower}      | Dirección MAC en minúsculas                                                                           |
| {macAddressAlpha}      | Dirección MAC sin dos puntos                                                                          |
| {macAddressAlphaLower} | Dirección MAC sin dos puntos en minúsculas                                                            |
| {macAddressSha1}       | Dirección MAC hashada usando SHA1                                                                     |
| {macAddressSha1Lower}  | Dirección MAC en minúsculas y hashada usando SHA1                                                     |
| {macAddressMd5}        | Dirección MAC hashada usando MD5                                                                      |
| {macAddressMd5Lower}   | Dirección MAC en minúsculas y hashada usando MD5                                                      |
| {iosIfa}               | Identificador publicitario de iOS                                                                     |
| {iosIfaSha1}           | Identificador publicitario de iOS hashado usando SHA1                                                 |
| {iosIfaMd5}            | Identificador publicitario de iOS hashado usando MD5                                                  |
| {iosIfaNoHyphens}      | Identificador publicitario de iOS sin guiones                                                         |
| {iosAdTracking}        | Configuración de seguimiento publicitario de iOS                                                      |
| {androidId}            | ID de Android                                                                                         |
| {androidIdSha1}        | ID de Android hashado usando SHA1                                                                     |
| {androidIdMd5}         | ID de Android hashado usando MD5                                                                      |
| {odin1}                | Hash SHA-1 de la dirección MAC del adaptador wifi de un teléfono                                      |
| {openUdid}             | OpenUDID del dispositivo                                                                              |
| {deviceId}             | ID del dispositivo                                                                                    |
| {deviceIp}             | IP del dispositivo                                                                                    |

</details>

<details>

<summary>Parámetros a nivel de artículo</summary>

Si recopila datos a nivel de artículo para acciones, también puede incluir estos datos en sus notificaciones de eventos del ciclo de vida de la acción.

"join" es una función que toma de 3 a 5 argumentos:

* **Argumento 1:** La colección.
* **Argumento 2:** Un símbolo para vincular a cada valor en la colección.
* **Argumento 3:** La expresión a calcular para cada miembro de la colección.
* **Argumento 4:** El separador opcional entre cada expresión (por defecto es coma).
* **Argumento 5:** un prefijo opcional, que estará presente solo si hay datos en la colección.

Ejemplos suponiendo 3 artículos con SKUs GH23, UT66 y RW87 respectivamente.

"items" es una colección de datos de artículos. Cada artículo tiene "cat", "sku", "qty", "amt", "rbt", "name"...

| Expresión                                              | 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>
