> 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/brand/es/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md). # Habilita las devoluciones de notificación de eventos para las marcas Las notificaciones de eventos mediante postback (webhooks) notifican a tus sistemas internos en tiempo real cuando ocurren eventos específicos. Aunque los datos enviados varían según el evento, el proceso de configuración es el mismo para todos. {% stepper %} {% step %} ## Accede a los postbacks de notificación de eventos 1. En la barra de navegación superior, selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil de usuario] → Configuración**. 2. Debajo de la *Técnico* sección, seleccione [**Notificaciones de eventos**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?). {% endstep %} {% step %} ## Completa los campos de configuración global 1. Pasa el cursor sobre el evento para el que quieres configurar un postback de notificación y selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **\[Editar]**. 2. Usa la tabla de abajo para configurar los ajustes de entrega:
CampoDescripción
URLEl endpoint de tu servidor que recibirá los datos.
Método HTTP

GET: Los datos se agregan a la URL como cadenas de consulta.

POST: Los datos se envían en el cuerpo de la solicitud, que incluye varios parámetros opcionales que puedes configurar.

Consulta Eventos de notificación y cargas útiles para obtener más información sobre cada evento y el contenido de la carga útil.

Encabezado HTTP(Opcional) Agrega encabezados personalizados para autenticación (p. ej., Authorization: Bearer token).
Retraso mínimoEstablece Retraso mínimo en segundos para proteger tu servidor de picos de tráfico.
Solicitudes máximasEstablece Solicitudes máximas por segundo para proteger tu servidor de picos de tráfico.
Respuesta exitosaLa cadena de texto específica o el código de estado HTTP que devuelve tu servidor cuando un postback se procesa correctamente.
Respuesta de errorLa cadena de texto o el código de estado que indica un fallo (p. ej., ERROR o 500).
{% endstep %} {% endstepper %} ## Eventos de notificación y cargas útiles Cada notificación de evento envía un conjunto único de puntos de datos configurables (p. ej., `{ActionId}`). Consulta los eventos a continuación para aprender qué puntos de datos puedes extraer de las cargas útiles.
Eventos del ciclo de vida de la acción Los eventos del ciclo de vida de la acción emitirán una solicitud HTTP a una URL especificada (y cualquier parámetro incluido) cuando una acción es rastreada, modificada o revertida. ```json // Un ejemplo de POST en formato JSON { "CampaignId": 9876, // ID del programa "ActionTrackerId": 12345, // ID del tipo de evento "MediaPartnerId": 555, // ID del socio "CampaignName": "Spring Global Promotion", // Nombre del programa "ActionTrackerName": "Standard Sale Tracker", // Nombre del tipo de evento "MediaPartnerName": "Top Tier Affiliates", // Nombre del socio "ActionId": "ACT-778899", // ID de la acción "Status": "MODIFIED", // Estado de la acción "StatusDetail": "Item return - payout adjusted", // Más detalles sobre el estado de la acción "AdId": 44332, // ID del anuncio "Payout": 10.50, // Pago de la acción al socio, en la moneda del socio "DeltaPayout": -5.00, // Monto de pago corregido de la acción anterior "IntendedPayout": 15.50, // Monto de pago previsto para una acción fuera de límite "Amount": 100.00, // Monto de la acción, en la moneda de la cuenta "DeltaAmount": -50.00, // Monto corregido de la acción anterior "IntendedAmount": 150.00, // Monto de venta previsto para una acción fuera de límite "Currency": "USD", // Moneda de la acción "OriginalCurrency": "USD", // Moneda original (es decir, del carrito) para la acción "OriginalAmount": 100.00, // Monto original (es decir, del carrito) para la acción // Colección "items": datos de los elementos individuales de esta acción "items": [{join(items, i, "\{\"sku\":\"{i.sku}\", \"item_price\":{i.amt}, \"category\":\"{i.cat}\", \"quantity\":{i.qty}, \"cartamt\":{i.cartamt}, \"rbt\":\"{i.rbt}\", \"name\":\"{i.name}\"\}")}], "EventDate": "2026-04-08T09:00:00Z", // Fecha de conversión "CreationDate": "2026-04-08T09:05:00Z", // Fecha creada en el sistema "LockingDate": "2026-05-08T00:00:00Z", // Fecha en que la acción se bloqueará "ClearedDate": "2026-05-15T00:00:00Z", // Fecha programada para liquidarse "ReferringDomain": "blog.partner.com", // Dominio de referencia "LandingPageUrl": "https://brand.com/sale", // URL de la página de destino "RefCustomerArea": "California", // Área del cliente (derivada de la IP) "RefCustomerCity": "San Francisco", // Ciudad del cliente (derivada de la IP) "RefCustomerRegion": "CA", // Región del cliente (derivada de la IP) "RefCustomerCountry": "US", // Código de país del cliente (derivada de la IP) "RefClickId": "CLK9988776655", // Identificador único de clic "SharedId": "social_post_01", // ID compartido del socio "PromoCode": "SAVE20", // Código promocional general "CustomerStatus": "EXISTING", // Estado del cliente "Oid": "ORD-554433", // ID del pedido "Note": "Partial return processed", // Nota proporcionada con la acción "CustomerPostCode": "94105", // Código postal del cliente "CustomerCity": "San Francisco", // Ciudad del cliente "CustomerCountry": "US", // Código de país del cliente "CustomerRegion": "CA", // Región del cliente "CustomerId": "CUST-12345", // ID del cliente "CustomerEmail": "a665a45920422f9d417...", // Correo electrónico del cliente con hash "IpAddress": "192.168.1.1", // Dirección IP "CallerId": null, // Número de teléfono de la persona que llama // Campos suplementarios personalizados "Text1": "Custom Val 1", // Texto 1 "Date1": "2026-04-08", // Fecha 1 "Money1": 10.00, // Dinero 1 "Numeric1": 1, // Numérico 1 // Metadatos del dispositivo y la aplicación "appPackage": "com.brand.app", // Paquete de la aplicación móvil "appName": "BrandStore", // Nombre de la aplicación móvil "appVersion": "4.2.1", // Versión de la aplicación móvil "deviceOs": "iOS", // Sistema operativo del dispositivo "deviceOsVersion": "17.4", // Versión del sistema operativo del dispositivo "deviceManuf": "Apple", // Fabricante del dispositivo "deviceModel": "iPhone 15", // Modelo del dispositivo "macAddress": "00:1B:44:11:3A:B7", // Dirección MAC (mayúsculas) "macAddressLower": "00:1b:44:11:3a:b7", // Dirección MAC (minúsculas) "macAddressAlpha": "001B44113AB7", // Dirección MAC (sin dos puntos) "macAddressSha1": "47a32...", // MAC SHA1 "iosIfa": "EA7583CD-A667-48BC-B806-42ECB2B48606", // ID de publicidad de iOS "iosAdTracking": "1", // Configuración de seguimiento de anuncios de iOS "androidId": null, // ID de Android "deviceId": "D-556677", // ID del dispositivo "deviceIp": "192.168.1.1" // IP del dispositivo } ```
Eventos de consulta de acción Los eventos de consulta de acción emitirán una solicitud HTTP a una URL especificada (y cualquier parámetro incluido) cuando se creen o resuelvan consultas de acción. ```json // Un ejemplo de POST en formato JSON { "Id": 554433, // Identificador único de la consulta de acción en el sistema "MediaPartnerId": 555, // ID del socio "MediaPartnerName": "Top Tier Affiliates", // Nombre del socio "CampaignId": 9876, // ID del programa "CampaignName": "Spring Global Promotion", // Nombre del programa "OrderId": "ORD-12345", // ID del pedido de la acción informada "TransactionDate": "2026-04-01T14:30:00Z", // Fecha de la transacción del evento que activó la consulta de acción "TransactionAmount": 250.00, // Monto de la transacción del evento que activó la consulta de acción "InquiryType": "MISSING_ACTION", // Tipo de consulta de acción "ExpectedPayout": 25.00, // Monto de pago esperado por el socio "ResolutionDeadlineDate": "2026-05-01T00:00:00Z", // Fecha límite para aceptar o rechazar la consulta "TrackingLink": "https://proweb.com/click?cid=1&pid=555", // Enlace de seguimiento proporcionado por el socio "ActionId": "ACT-999000", // ID de la acción (si está asociada a una acción existente) "AutoApprovalDate": "2026-05-05T00:00:00Z", // Fecha en la que el sistema ejecutará las reglas de aprobación automática "ResolutionStatus": "PENDING", // Estado final de resolución de la consulta de acción "RejectReason": null, // Motivo por el que se rechazó la consulta de acción "FinalPayout": 0.00, // Pago final asociado a la consulta de acción "ResolutionDate": null, // Fecha en que se decidió la consulta "CreationDate": "2026-04-08T10:05:00Z", // Fecha en que se crea la consulta en el sistema "InquiryNotes": "El cliente afirma que hizo clic en el enlace, pero no se mostró ningún crédito.", // Notas de la consulta enviadas por el socio "ResolutionNotes": null, // Notas enviadas cuando se decidió la consulta "Comments": "[{\"user\": \"support_agent\", \"text\": \"Verificando los registros de clic ahora.\"}, {\"user\": \"partner\", \"text\": \"El cliente proporcionó el recibo.\"}]" // Comentarios añadidos a la consulta (en formato JSON) } ```
Eventos de liquidación de acciones Los eventos de liquidación de acciones emitirán una solicitud HTTP a una URL especificada (y cualquier parámetro incluido) cuando se liquiden acciones. ```json // Un ejemplo de POST en formato JSON { "ActionTrackerId": 12345, // ID del tipo de evento "ActionTrackerName": "Standard Sale Tracker", // Nombre del tipo de evento "CampaignId": 9876, // ID del programa "CampaignName": "Spring Global Promotion", // Nombre del programa "MediaPartnerId": 555, // ID del socio "MediaPartnerName": "Top Tier Affiliates", // Nombre del socio "OrderIds": "ORD-9921,ORD-9922", // IDs de pedido de las acciones informadas (separados por comas) "ActionIds": "ACT-101,ACT-102", // IDs de acción (separados por comas) "ClearedDate": "2026-04-15T12:00:00Z", // Fecha (ISO 8601) en que está programado que se liquide la acción "LedgerDate": "2026-04-08T09:54:43Z" // Fecha (ISO 8601) en que se liquidó la acción } ```
Eventos de solicitud de valor de seguimiento Los eventos de solicitud de valor de seguimiento emitirán una solicitud HTTP a una URL especificada (y cualquier parámetro incluido) cuando se creen solicitudes de seguimiento. ```json // Un ejemplo de POST en formato JSON { "CampaignId": 9876, // ID del programa "ActionTrackerId": 12345, // ID del tipo de evento "MediaPartnerId": 555, // ID del socio "ActionId": "ACT-778899", // ID de la acción "Amount": 150.00, // Monto de la acción en la moneda de la cuenta "Currency": "USD", // Moneda de la acción "Oid": "ORD-554433", // ID del pedido // Colección "items": desglose de los productos individuales en la acción "items": [{join(items, i, "\{\"sku\":\"{i.sku}\",\"item_price\":{i.amt},\"category\":\"{i.cat}\",\"quantity\":{i.qty},\"cartamt\":{i.cartamt},\"rbt\":\"{i.rbt}\",\"name\":\"{i.name}\"\}")}], "EventDate": "2026-04-08T09:00:00Z", // Fecha de conversión "IpAddress": "192.168.1.1", // Dirección IP del dispositivo "RefClickId": "CLK9988776655" // Identificador único de clic } ```
Eventos de trabajos completados Los eventos de trabajos completados emitirán una solicitud HTTP a una URL especificada (y cualquier parámetro adicional) cuando un trabajo se haya completado para un [Exportación de informe](https://integrations.impact.com/brand-api-reference/reference/report-export/report-export) o [Haz clic en Exportar](https://integrations.impact.com/brand-api-reference/reference/clicks/clickexport). ```json // Un ejemplo de POST en formato JSON { "JobId": 10293847, // ID único del trabajo "JobType": "REPORT_EXPORT", // El tipo de trabajo "AccountId": 7744, // ID de la cuenta "StartDate": "2026-04-08T10:00:05Z", // La hora en que comenzó el trabajo "EndDate": "2026-04-08T10:11:02Z", // La hora en que se completó el trabajo "RecordsProcessed": 5240, // El número de registros procesados o generados "ApiJobDetailUri": "https://api.impact.com/jobs/10293847", // URI de la API para obtener más detalles sobre el trabajo "ApiResultUri": "https://api.impact.com/jobs/10293847/result", // URI de la API para obtener el resultado de la salida del trabajo "ResultDownloadUrlExp5": "https://download.impact.com/file?token=a1b2...&exp=5min", // URL para descargar la salida (expira en 5 minutos) "ResultDownloadUrlExp15": "https://download.impact.com/file?token=a1b2...&exp=15min", // URL para descargar la salida (expira en 15 minutos) "ResultDownloadUrlExp30": "https://download.impact.com/file?token=a1b2...&exp=30min", // URL para descargar la salida (expira en 30 minutos) "ResultDownloadUrlExp60": "https://download.impact.com/file?token=a1b2...&exp=60min" // URL para descargar la salida (expira en 60 minutos) } ```
Eventos de solicitud de la aplicación del publicador {% hint style="success" %} **Nota:** Esta funcionalidad está en beta. Contacta a tu CSM o a nuestro [equipo de soporte](https://app.impact.com/support/portal.ihtml?createTicket=true&) si quieres probar esta función. {% endhint %} Los eventos de solicitud de aplicación del publicador emitirán una solicitud HTTP a una URL especificada cuando un socio envíe una solicitud y cada vez que la solicitud sea aprobada, rechazada o retirada. Los eventos de solicitud de aplicación del publicador también se conocen como el postback del evento Contract, el webhook de procesamiento de solicitudes o el webhook de la aplicación. Si una `PENDING` carga útil se entrega con puntos de datos vacíos, el sistema está diseñado para activar actualizaciones a medida que la información esté disponible. Las entregas correctas posteriores completarán esos campos vacíos anteriormente, asegurando que tus registros se mantengan sincronizados con la información procesada más reciente. {% hint style="warning" %} **Importante:** Si tienes [flujos de trabajo de la solicitud](/brand/es/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing.md) configurados, se ejecutan antes de que se active el webhook. El webhook se activa con el resultado *Estado*: `APROBADO` o `RECHAZADO` si un flujo de trabajo procesó la solicitud, `PENDING` si no se aplicó ningún flujo de trabajo, o `RETIRADO` si el socio retiró la solicitud. {% endhint %} Para ver cómo funciona este webhook junto con Recruitment Agent, consulta [Recruitment Agent](/brand/es/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent.md#see-where-the-agent-fits-with-your-existing-automation). El contenido de la carga útil varía según *Estado*. El siguiente ejemplo muestra un evento `PENDING` con comentarios que indican qué campos aparecen para otros estados. ```json // Un ejemplo de POST en formato JSON { "Status": "PENDING", // Estado de la solicitud: PENDING, APPROVED, REJECTED, RETRACTED "ProgramId": "9876", // ID del programa "TemplateTermsId": "4455", // ID de los términos de plantilla "ContractId": "112233", // ID del contrato "ApplicationDate": "2026-04-09T08:30:00Z", // Fecha de la solicitud "PublisherSignerName": "Sarah Chen", // Usuario del publicador que procesó "PublisherId": "555", // ID del socio "Name": "Elite Content Creators", // Nombre del socio "BusinessModel": "SOCIAL_INFLUENCER", // Modelo de negocio principal del socio "Address": "123 Marketing Way", // Dirección "City": "Los Angeles", // Ciudad "State": "CA", // Estado "Country": "US", // País // Solo APPROVED, REJECTED, RETRACTED "DecisionDate": null, // Fecha de la decisión // Solo APPROVED "ContractStartDate": null, // Fecha de inicio del contrato // Solo REJECTED "DeclineReason": null, // Motivo del rechazo // Solo APPROVED, REJECTED "AdvertiserSignerName": null, // Usuario del anunciante que procesó // Solo PENDING: campos de perfil del socio "Description": "Una red premium de influencers de estilo de vida y viajes.", // Descripción del perfil del socio "Language": "en-US", // Idioma "PublisherSize": "M", // XS, S, M, L, XL "PastRelationship": "false", // Booleano que indica contrato previo "MarketplaceApproved": "true", // Booleano que indica el estado en el marketplace "ReceivedPayout": "true", // Booleano que indica si han recibido un pago // Solo PENDING: propiedades de medios asociadas con el socio "properties": [{join(properties, i, "{\"platform\":\"{i.platform}\",\"verified\":\"{i.verified}\",\"url\":\"{i.url}\",\"category\":\"{i.category}\",\"reach\":\"{i.reach}\",\"engagementRate\":\"{i.engagementRate}\",\"audienceCountryPct\":\"{i.audienceCountryPct}\",\"audienceGenderPct\":\"{i.audienceGenderPct}\",\"audienceAgeRangePct\":\"{i.audienceAgeRangePct}\"}")}], // Solo PENDING: campos demográficos del creador "CreatorIncome": "", // Ingreso del hogar "CreatorGender": "", // Género "CreatorEthnicity": "", // Etnia "CreatorEducation": "", // Nivel educativo "CreatorRelationshipStatus": "", // Estado de relación "CreatorParentalStatus": "", // Estado parental "CreatorPronouns": "", // Pronombres "CreatorDOB": "", // Fecha de nacimiento // Solo PENDING: IDs de grupo "GroupIds": "1001,1002,1003" // IDs de grupo separados por comas } ```
## Mecanismo de reintento del postback Si un postback falla al intentar publicarse en la URL de destino, la entrega se reintenta automáticamente según un programa establecido hasta 15 veces. Los reintentos ayudan a cubrir problemas de red temporales o la indisponibilidad del servidor. ### Condiciones en las que no se producirán reintentos Un postback no se reintentará en los siguientes casos: * La URL de destino tiene un formato incorrecto o no es válida. * La URL de destino o su host no resuelven, por ejemplo, debido a un fallo de búsqueda DNS. ### Programa de reintentos Los intentos de reintento siguen el programa a continuación. Los reintentos 1, 2 y 3 se omiten si el código de respuesta HTTP está en el rango de `400` para `500`.
Referencia del programa de reintentos
Intento de reintentoRetraso antes del reintento
Reintento 1+15 segundos
Reintento 2+15 segundos
Reintento 3+15 segundos
Reintento 4+3 minutos
Reintento 5+3 minutos
Reintento 6+15 minutos
Reintento 7+15 minutos
Reintento 8+15 minutos
Reintento 9+2 horas
Reintento 10+2 horas
Reintento 11+2 horas
Reintento 12+6 horas
Reintento 13+6 horas
Reintento 14+6 horas
Reintento 15+6 horas
--- # 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/brand/es/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.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.