> 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/it/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md).

# Abilita i postback delle notifiche degli eventi per i brand

Le notifiche di eventi tramite callback (webhook) informano i tuoi sistemi interni in tempo reale quando si verificano eventi specifici. I dati inviati variano in base all’evento, ma la procedura di configurazione è la stessa per tutti.

{% stepper %}
{% step %}

## Accedere alle callback di notifica degli eventi

1. Nella barra di navigazione superiore, seleziona ![](https://1043985218-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) **\[Profilo utente] → Impostazioni**.
2. Nella sezione *Tecnica* seleziona [**Notifiche degli eventi**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?).
   {% endstep %}

{% step %}

## Compilare i campi di configurazione globali

1. Passa il puntatore sull’evento per cui vuoi configurare una callback di notifica e seleziona ![](https://1043985218-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) **\[Modifica]**.
2. Usa la tabella seguente per configurare le impostazioni di consegna:

<table><thead><tr><th width="225.36328125">Campo</th><th>Descrizione</th></tr></thead><tbody><tr><td>URL</td><td>L’endpoint sul tuo server che riceverà i dati.</td></tr><tr><td>Metodo HTTP</td><td><p><code>GET</code>: i dati vengono aggiunti all’URL come parametri di query.</p><p><code>POST</code>: i dati vengono inviati nel corpo della richiesta, che include vari parametri facoltativi che puoi impostare.<br><br>Per ulteriori informazioni su ciascun evento e sul contenuto del payload, consulta <a href="#notification-events-and-payloads">Eventi di notifica e payload</a> .</p></td></tr><tr><td>Header HTTP</td><td>(Facoltativo) Aggiungi header personalizzati per l’autenticazione (ad es., <code>Authorization: Bearer token</code>).</td></tr><tr><td>Ritardo minimo</td><td>Imposta <em>Ritardo minimo</em> in secondi per proteggere il server dai picchi di traffico.</td></tr><tr><td>Numero massimo di richieste</td><td>Imposta <em>il numero massimo di richieste</em> al secondo per proteggere il server dai picchi di traffico.</td></tr><tr><td>Risposta di successo</td><td>La stringa di testo specifica o il codice di stato HTTP che il server restituisce quando una callback viene gestita correttamente.</td></tr><tr><td>Risposta di errore</td><td>La stringa di testo o il codice di stato che indica un errore (ad es., <code>ERROR</code> oppure <code>500</code>).</td></tr></tbody></table>
{% endstep %}
{% endstepper %}

## Eventi di notifica e payload

Ogni notifica di evento invia un insieme univoco di dati configurabili (ad es., `{ActionId}`). Consulta gli eventi seguenti per scoprire quali dati puoi estrarre dai payload.

<details>

<summary>Eventi del ciclo di vita delle azioni</summary>

Gli eventi del ciclo di vita delle azioni inviano una richiesta HTTP a un URL specificato (e agli eventuali parametri inclusi) quando un’azione viene tracciata, modificata o annullata.

```json
// Un esempio di POST in formato JSON
{
  "CampaignId": 9876, // ID del programma
  "ActionTrackerId": 12345, // ID del tipo di evento
  "MediaPartnerId": 555, // ID del partner
  "CampaignName": "Spring Global Promotion", // Nome del programma
  "ActionTrackerName": "Standard Sale Tracker", // Nome del tipo di evento
  "MediaPartnerName": "Top Tier Affiliates", // Nome del partner
  "ActionId": "ACT-778899", // ID dell’azione
  "Status": "MODIFIED", // Stato dell’azione
  "StatusDetail": "Item return - payout adjusted", // Maggiori dettagli sullo stato dell'azione
  "AdId": 44332, // ID annuncio
  "Payout": 10.50, // Importo corrisposto per l'azione al partner, nella valuta del partner
  "DeltaPayout": -5.00, // Importo della commissione corretto rispetto all'azione precedente
  "IntendedPayout": 15.50, // Importo della commissione previsto per un'azione oltre il limite
  "Amount": 100.00, // Importo dell'azione, nella valuta dell'account
  "DeltaAmount": -50.00, // Importo corretto rispetto all'azione precedente
  "IntendedAmount": 150.00, // Importo della vendita previsto per un'azione oltre il limite
  "Currency": "USD", // Valuta dell'azione
  "OriginalCurrency": "USD", // Valuta originale (ossia del carrello) dell'azione
  "OriginalAmount": 100.00, // Importo originale (ossia del carrello) dell'azione
  // Raccolta "items": dati dei singoli articoli inclusi in questa azione
  "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", // Data della conversione
  "CreationDate": "2026-04-08T09:05:00Z", // Data di creazione nel sistema
  "LockingDate": "2026-05-08T00:00:00Z", // Data in cui l'azione verrà bloccata
  "ClearedDate": "2026-05-15T00:00:00Z", // Data prevista per la liquidazione
  "ReferringDomain": "blog.partner.com", // Dominio di provenienza
  "LandingPageUrl": "https://brand.com/sale", // URL della pagina di destinazione
  "RefCustomerArea": "California", // Area del cliente (ricavata dall'indirizzo IP)
  "RefCustomerCity": "San Francisco", // Città del cliente (ricavata dall'indirizzo IP)
  "RefCustomerRegion": "CA", // Regione del cliente (ricavata dall'indirizzo IP)
  "RefCustomerCountry": "US", // Codice paese del cliente (ricavato dall'indirizzo IP)
  "RefClickId": "CLK9988776655", // Identificativo univoco del clic
  "SharedId": "social_post_01", // ID condiviso del partner
  "PromoCode": "SAVE20", // Codice promozionale generico
  "CustomerStatus": "EXISTING", // Stato del cliente
  "Oid": "ORD-554433", // ID ordine
  "Note": "Partial return processed", // Nota fornita insieme all'azione
  "CustomerPostCode": "94105", // Codice postale del cliente
  "CustomerCity": "San Francisco", // Città del cliente
  "CustomerCountry": "US", // Codice paese del cliente
  "CustomerRegion": "CA", // Regione del cliente
  "CustomerId": "CUST-12345", // ID cliente
  "CustomerEmail": "a665a45920422f9d417...", // Email del cliente sottoposta ad hashing
  "IpAddress": "192.168.1.1", // Indirizzo IP
  "CallerId": null, // Numero di telefono del chiamante
  // Campi supplementari personalizzati
  "Text1": "Custom Val 1", // Testo 1
  "Date1": "2026-04-08", // Data 1
  "Money1": 10.00, // Importo 1
  "Numeric1": 1, // Valore numerico 1
  // Metadati del dispositivo e dell'app
  "appPackage": "com.brand.app", // Pacchetto dell'app mobile
  "appName": "BrandStore", // Nome dell'app mobile
  "appVersion": "4.2.1", // Versione dell'app mobile
  "deviceOs": "iOS", // Sistema operativo del dispositivo
  "deviceOsVersion": "17.4", // Versione del sistema operativo del dispositivo
  "deviceManuf": "Apple", // Produttore del dispositivo
  "deviceModel": "iPhone 15", // Modello del dispositivo
  "macAddress": "00:1B:44:11:3A:B7", // Indirizzo MAC (maiuscolo)
  "macAddressLower": "00:1b:44:11:3a:b7", // Indirizzo MAC (minuscolo)
  "macAddressAlpha": "001B44113AB7", // Indirizzo MAC (senza due punti)
  "macAddressSha1": "47a32...", // SHA1 dell'indirizzo MAC
  "iosIfa": "EA7583CD-A667-48BC-B806-42ECB2B48606", // ID pubblicitario iOS
  "iosAdTracking": "1", // Impostazione del tracciamento pubblicitario iOS
  "androidId": null, // ID Android
  "deviceId": "D-556677", // ID del dispositivo
  "deviceIp": "192.168.1.1" // IP del dispositivo
}
```

</details>

<details>

<summary>Eventi di richiesta di verifica delle azioni</summary>

Gli eventi di richiesta di verifica delle azioni invieranno una richiesta HTTP a un URL specificato (e a tutti i parametri inclusi) quando le richieste di verifica delle azioni vengono create o risolte.

```json
// Un esempio di POST in formato JSON
{
  "Id": 554433, // Identificatore univoco della richiesta di verifica dell'azione nel sistema
  "MediaPartnerId": 555, // ID del partner
  "MediaPartnerName": "Top Tier Affiliates", // Nome del partner
  "CampaignId": 9876, // ID del programma
  "CampaignName": "Spring Global Promotion", // Nome del programma
  "OrderId": "ORD-12345", // ID dell'ordine relativo all'azione segnalata
  "TransactionDate": "2026-04-01T14:30:00Z", // Data della transazione che ha attivato la richiesta di verifica dell'azione
  "TransactionAmount": 250.00, // Importo della transazione che ha attivato la richiesta di verifica dell'azione
  "InquiryType": "MISSING_ACTION", // Tipo di richiesta di verifica dell'azione
  "ExpectedPayout": 25.00, // Importo del pagamento previsto dal partner
  "ResolutionDeadlineDate": "2026-05-01T00:00:00Z", // Data entro la quale la richiesta deve essere accettata o rifiutata
  "TrackingLink": "https://proweb.com/click?cid=1&pid=555", // Link di tracciamento fornito dal partner
  "ActionId": "ACT-999000", // ID dell'azione (se associata a un'azione esistente)
  "AutoApprovalDate": "2026-05-05T00:00:00Z", // Data in cui il sistema applicherà le regole di approvazione automatica
  "ResolutionStatus": "PENDING", // Stato finale della richiesta di verifica dell'azione
  "RejectReason": null, // Motivo del rifiuto della richiesta di verifica dell'azione
  "FinalPayout": 0.00, // Importo finale del pagamento associato alla richiesta di verifica dell'azione
  "ResolutionDate": null, // Data in cui è stata presa una decisione sulla richiesta
  "CreationDate": "2026-04-08T10:05:00Z", // Data di creazione della richiesta nel sistema
  "InquiryNotes": "Customer claims they clicked the link but no credit was shown.", // Note sulla richiesta inviate dal partner
  "ResolutionNotes": null, // Note inviate al momento della decisione sulla richiesta
  "Comments": "[{\"user\": \"support_agent\", \"text\": \"Verifying click logs now.\"}, {\"user\": \"partner\", \"text\": \"Customer provided receipt.\"}]" // Commenti aggiunti alla richiesta (in formato JSON)
}
```

</details>

<details>

<summary>Eventi di contabilizzazione delle azioni</summary>

Gli eventi di contabilizzazione delle azioni invieranno una richiesta HTTP a un URL specificato (e a tutti i parametri inclusi) quando le azioni vengono contabilizzate.

```json
// Un esempio di POST in formato JSON
{
  "ActionTrackerId": 12345, // ID del tipo di evento
  "ActionTrackerName": "Standard Sale Tracker", // Nome del tipo di evento
  "CampaignId": 9876, // ID del programma
  "CampaignName": "Spring Global Promotion", // Nome del programma
  "MediaPartnerId": 555, // ID del partner
  "MediaPartnerName": "Top Tier Affiliates", // Nome del partner
  "OrderIds": "ORD-9921,ORD-9922", // ID degli ordini relativi alle azioni segnalate (separati da virgole)
  "ActionIds": "ACT-101,ACT-102", // ID delle azioni (separati da virgole)
  "ClearedDate": "2026-04-15T12:00:00Z", // Data (ISO 8601) in cui è prevista la contabilizzazione dell'azione
  "LedgerDate": "2026-04-08T09:54:43Z" // Data (ISO 8601) in cui l'azione è stata contabilizzata
}
```

</details>

<details>

<summary>Eventi di richiesta dei valori di tracciamento</summary>

Gli eventi di richiesta dei valori di tracciamento invieranno una richiesta HTTP a un URL specificato (e a tutti i parametri inclusi) quando vengono create richieste di tracciamento.

```json
// Un esempio di POST in formato JSON
{
  "CampaignId": 9876, // ID del programma
  "ActionTrackerId": 12345, // ID del tipo di evento
  "MediaPartnerId": 555, // ID del partner
  "ActionId": "ACT-778899", // ID dell’azione
  "Amount": 150.00, // Importo dell'azione nella valuta del conto
  "Currency": "USD", // Valuta dell'azione
  "Oid": "ORD-554433", // ID ordine
  // Raccolta "items": dettaglio dei singoli prodotti nell'azione
  "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", // Data della conversione
  "IpAddress": "192.168.1.1", // Indirizzo IP del dispositivo
  "RefClickId": "CLK9988776655" // Identificatore univoco del clic
}
```

</details>

<details>

<summary>Eventi di completamento dei job</summary>

Gli eventi di completamento dei job inviano una richiesta HTTP a un URL specificato (e a eventuali parametri aggiuntivi) quando un job viene completato per un [Esportazione dei report](https://integrations.impact.com/brand-api-reference/reference/report-export/report-export) oppure [Fai clic su Esporta](https://integrations.impact.com/brand-api-reference/reference/clicks/clickexport).

```json
// Un esempio di POST in formato JSON
{
  "JobId": 10293847, // ID univoco del job
  "JobType": "REPORT_EXPORT", // Tipo di job
  "AccountId": 7744, // ID account
  "StartDate": "2026-04-08T10:00:05Z", // Ora di avvio del job
  "EndDate": "2026-04-08T10:11:02Z", // Ora di completamento del job
  "RecordsProcessed": 5240, // Numero di record elaborati o generati
  "ApiJobDetailUri": "https://api.impact.com/jobs/10293847", // URI API per ottenere ulteriori dettagli sul job
  "ApiResultUri": "https://api.impact.com/jobs/10293847/result", // URI API per ottenere il risultato del job
  "ResultDownloadUrlExp5": "https://download.impact.com/file?token=a1b2...&exp=5min", // URL per scaricare l'output (scadenza di 5 minuti)
  "ResultDownloadUrlExp15": "https://download.impact.com/file?token=a1b2...&exp=15min", // URL per scaricare l'output (scadenza di 15 minuti)
  "ResultDownloadUrlExp30": "https://download.impact.com/file?token=a1b2...&exp=30min", // URL per scaricare l'output (scadenza di 30 minuti)
  "ResultDownloadUrlExp60": "https://download.impact.com/file?token=a1b2...&exp=60min" // URL per scaricare l'output (scadenza di 60 minuti)
}
```

</details>

<details>

<summary>Eventi dell'applicazione del publisher</summary>

{% hint style="success" %}
**Nota:** Questa funzionalità è in versione beta. Contatta il tuo CSM o il nostro [team di supporto](https://app.impact.com/support/portal.ihtml?createTicket=true&) se desideri provare questa funzionalità.
{% endhint %}

Gli eventi dell'applicazione del publisher inviano una richiesta HTTP a un URL specificato quando un partner invia una candidatura e ogni volta che questa viene approvata, rifiutata o ritirata.

Gli eventi dell'applicazione del publisher sono noti anche come callback dell'evento Contratto, webhook di elaborazione delle candidature o webhook delle candidature.

Se un payload `PENDING` viene recapitato con punti dati vuoti, il sistema è progettato per attivare aggiornamenti man mano che le informazioni diventano disponibili. Le successive consegne riuscite compileranno i campi precedentemente vuoti, assicurando che i tuoi dati restino sincronizzati con le informazioni elaborate più recenti.

{% hint style="warning" %}
**Importante:** Se hai configurato dei [flussi di lavoro delle candidature](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing.md) , questi vengono eseguiti prima dell'invio del webhook. Il webhook viene inviato con lo *stato*: `APPROVED` oppure `REJECTED` se un flusso di lavoro ha elaborato la candidatura, `PENDING` se non è stato applicato alcun flusso di lavoro, oppure `RETRACTED` se il partner ha ritirato la candidatura.
{% endhint %}

Per vedere come funziona questo webhook insieme al Recruitment Agent, consulta [Recruitment Agent](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent.md#see-where-the-agent-fits-with-your-existing-automation).

Il contenuto del payload varia in base allo *stato*. L'esempio seguente mostra un evento `PENDING` , con commenti che indicano quali campi sono presenti per gli altri stati.

```json
// Un esempio di POST in formato JSON
{
  "Status": "PENDING", // Stato della candidatura: PENDING, APPROVED, REJECTED, RETRACTED
  "ProgramId": "9876", // ID del programma
  "TemplateTermsId": "4455", // ID delle condizioni del modello
  "ContractId": "112233", // ID del contratto
  "ApplicationDate": "2026-04-09T08:30:00Z", // Data della richiesta
  "PublisherSignerName": "Sarah Chen", // Utente del publisher che ha elaborato la richiesta
  "PublisherId": "555", // ID del partner
  "Name": "Elite Content Creators", // Nome del partner
  "BusinessModel": "SOCIAL_INFLUENCER", // Modello di business principale del partner
  "Address": "123 Marketing Way", // Indirizzo
  "City": "Los Angeles", // Città
  "State": "CA", // Stato
  "Country": "US", // Paese

  // Solo APPROVED, REJECTED, RETRACTED
  "DecisionDate": null, // Data della decisione

  // Solo APPROVED
  "ContractStartDate": null, // Data di inizio del contratto

  // Solo REJECTED
  "DeclineReason": null, // Motivo del rifiuto

  // Solo APPROVED, REJECTED
  "AdvertiserSignerName": null, // Utente dell'inserzionista che ha elaborato la richiesta

  // Solo PENDING: campi del profilo del partner
  "Description": "A premium network of lifestyle and travel influencers.", // Descrizione del profilo del partner
  "Language": "en-US", // Lingua
  "PublisherSize": "M", // XS, S, M, L, XL
  "PastRelationship": "false", // Valore booleano che indica un contratto precedente
  "MarketplaceApproved": "true", // Valore booleano che indica lo stato nel marketplace
  "ReceivedPayout": "true", // Valore booleano che indica se è stato ricevuto un pagamento

  // Solo PENDING: proprietà multimediali associate al partner
  "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: dati demografici del creator
  "CreatorIncome": "", // Reddito familiare
  "CreatorGender": "", // Genere
  "CreatorEthnicity": "", // Etnia
  "CreatorEducation": "", // Livello di istruzione
  "CreatorRelationshipStatus": "", // Stato sentimentale
  "CreatorParentalStatus": "", // Stato genitoriale
  "CreatorPronouns": "", // Pronomi
  "CreatorDOB": "", // Data di nascita

  // Solo PENDING: ID dei gruppi
  "GroupIds": "1001,1002,1003" // ID dei gruppi separati da virgole
}
```

</details>

## Meccanismo di nuovo tentativo dei postback

Se un postback non riesce durante l'invio all'URL di destinazione, il sistema riprova automaticamente la consegna secondo una pianificazione prestabilita, fino a 15 volte. I nuovi tentativi consentono di gestire problemi di rete temporanei o l'indisponibilità del server.

### Condizioni in cui non vengono effettuati nuovi tentativi

Il sistema non riproverà a inviare un postback nei seguenti casi:

* L'URL di destinazione è malformato o non valido.
* L'URL di destinazione o il relativo host non viene risolto, ad esempio a causa di un errore nella ricerca DNS.

### Pianificazione dei nuovi tentativi

I tentativi seguono la pianificazione riportata di seguito. I tentativi 1, 2 e 3 vengono saltati se il codice di risposta HTTP è compreso nell'intervallo da `400` a `500`.

<details>

<summary>Riferimento alla pianificazione dei nuovi tentativi</summary>

<table><thead><tr><th width="180.5390625">Tentativo</th><th>Attesa prima del nuovo tentativo</th></tr></thead><tbody><tr><td>Nuovo tentativo 1</td><td>+15 secondi</td></tr><tr><td>Nuovo tentativo 2</td><td>+15 secondi</td></tr><tr><td>Nuovo tentativo 3</td><td>+15 secondi</td></tr><tr><td>Nuovo tentativo 4</td><td>+3 minuti</td></tr><tr><td>Nuovo tentativo 5</td><td>+3 minuti</td></tr><tr><td>Nuovo tentativo 6</td><td>+15 minuti</td></tr><tr><td>Nuovo tentativo 7</td><td>+15 minuti</td></tr><tr><td>Nuovo tentativo 8</td><td>+15 minuti</td></tr><tr><td>Nuovo tentativo 9</td><td>+2 ore</td></tr><tr><td>Nuovo tentativo 10</td><td>+2 ore</td></tr><tr><td>Nuovo tentativo 11</td><td>+2 ore</td></tr><tr><td>Nuovo tentativo 12</td><td>+6 ore</td></tr><tr><td>Nuovo tentativo 13</td><td>+6 ore</td></tr><tr><td>Nuovo tentativo 14</td><td>+6 ore</td></tr><tr><td>Nuovo tentativo 15</td><td>+6 ore</td></tr></tbody></table>

</details>


---

# 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/it/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md?ask=<question>&goal=<user_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.
