> 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/partner/it/di-cosa-vorresti-saperne-di-piu/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md).

# Configura i postback del ciclo di vita dell'azione

Esistono due tipi principali di callback postback per il ciclo di vita delle azioni. **A livello globale** crea postback per l'intero account, mentre **a livello di evento** crea postback per tipi di evento specifici. Seleziona l'opzione più adatta alle tue esigenze per scoprire di più sulla procedura di configurazione.

{% hint style="warning" %}
**Avviso:** Per i postback a livello globale, dovresti ricevere un postback ogni volta che si verifica un evento «non standard», ad esempio una modifica o uno storno. Tieni presente che i postback a livello di evento non vengono attivati dagli eventi non standard del ciclo di vita delle azioni.
{% endhint %}

## Configura un postback per il ciclo di vita delle azioni

<details>

<summary>Configura un postback per il ciclo di vita delle azioni a livello globale</summary>

Questa sezione illustra come creare postback per l'intero account in una sola volta. I partner che dispongono di un unico sistema in grado di ricevere ed elaborare questi postback, oppure che desiderano ricevere notifiche per tutti gli eventi non standard, devono configurare i postback per il ciclo di vita delle azioni a livello globale.

{% hint style="success" %}
**Nota:** Se vuoi selezionare con maggiore precisione i tipi di evento per i quali ricevere postback, consulta la sezione seguente per configurare i *postback per il ciclo di vita delle azioni a livello di evento*.
{% endhint %}

1. Nella barra di navigazione in alto, seleziona ![](https://1708986086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FhyR4iWDS0fO9ZcKFGf82%2FUser%20profile.svg?alt=media\&token=281d8f1b-b9c5-4208-a0a2-a078f54e0eb6) **\[Profilo utente] → Impostazioni**.
2. In *Tecnico*, seleziona [**Notifiche degli eventi**](https://app.impact.com/secure/mediapartner/accountSettings/view-edit-pingback-settings-flow.ihtml).
3. Accanto a *Eventi del ciclo di vita delle azioni*, seleziona ![](https://1708986086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FZMLVDhHLGefqRDHaIWTm%2FEdit.svg?alt=media\&token=1f1168ae-5bd3-456c-a366-904d0ecf00cb) **\[Modifica]**.
4. Inserisci l'URL del tuo server. È l'URL a cui impact.com invierà i postback.
5. Seleziona il metodo HTTP che preferisci.
   * Consulta alcuni dei [parametri del body disponibili](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * Se selezioni **POST**, dovrai quindi inserire il body della richiesta e selezionare un **Formato del body**. Di seguito trovi un esempio di come potresti mappare ogni dato per un formato JSON. Le chiavi di ciascuna coppia chiave-valore devono corrispondere alla configurazione del tuo sistema; i valori saranno i dati corrispondenti che scegli tra quelli forniti da impact.com e dovranno essere inseriti tra parentesi quadre `{ }`.

     <div data-with-frame="true"><figure><img src="https://1708986086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FFNWShmuaxZ5VpP14AlWv%2FScreenshot%202026-05-23%20at%2010.58.15.png?alt=media&amp;token=00e80c87-6c12-4f6d-8ca5-3885c9002533" alt="" width="563"><figcaption></figcaption></figure></div>
   * Non trovi il valore che ti serve? Contatta il tuo Account Manager (oppure [contatta l'assistenza](https://app.impact.com/support/portal.ihtml)).
6. Seleziona **Eventi del ciclo di vita delle azioni**. Queste impostazioni sono facoltative.
   * Inserisci un **header HTTP**. Se sono necessarie più coppie, separale con un punto e virgola.
   * Inserisci un **ritardo minimo** tra il verificarsi di un evento non standard e la generazione e l'invio del postback al tuo sistema.
   * Imposta un limite di frequenza per il numero massimo di **richieste** al secondo che impact.com può inviare al tuo sistema.
   * Inserisci il contenuto che desideri ricevere come **risposta di successo** a un postback.
   * Inserisci il contenuto che desideri ricevere come **risposta di errore** a un postback.
7. Seleziona **Salva**.

Ora che hai configurato i postback a livello globale, il tuo sistema dovrebbe iniziare a ricevere postback ogni volta che si verificano eventi non standard, indipendentemente dal brand che esegue le azioni non standard. Per scoprire come testare la nuova configurazione dei postback, consulta la sezione *Testare un postback del ciclo di vita di un'azione* qui sotto.

### Esempio di valori dinamici

Se hai configurato variabili dinamiche per i tuoi link di tracciamento, puoi configurare un URL di postback per il tuo server, così da ricevere una notifica quando si verificano azioni e recuperare i valori popolati dinamicamente associati all'azione.

Questo esempio mostra come passare un valore `SharedId` (un valore che vuoi condividere con i brand) a un parametro in un postback (`MyParam`). Alcuni brand potrebbero richiederti di configurarlo.

<div data-with-frame="true"><figure><img src="https://1708986086-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>

Un URL di postback potrebbe essere simile a questo:

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

L'URL di postback popolerà il parametro `MyParam` con il valore recuperato da `SharedId`.

</details>

<details>

<summary>Configurare i postback del ciclo di vita delle azioni a livello di evento</summary>

Questa sezione descrive come creare postback per tipi di evento specifici che monitorano le azioni generate. Se vuoi selezionare con maggiore precisione i tipi di evento per i quali ricevere postback, devi configurare i postback del ciclo di vita delle azioni a livello di evento.

{% hint style="success" %}
**Nota:** Se configuri i postback del ciclo di vita delle azioni a livello globale, non è necessario configurare quelli a livello di evento.
{% endhint %}

1. Nella barra di navigazione in alto, seleziona **Discover →** [**Brand**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml).
2. Seleziona la scheda del brand a cui appartiene il postback che vuoi testare.
3. Sotto il nome del brand, seleziona ![](https://1708986086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[Altro]** → **Integrazione del tracciamento**.
4. Nell'angolo in alto a destra della pagina, seleziona **Aggiungi postback**.
5. Seleziona il tipo di evento (in precedenza chiamato *tracker di azioni*) per cui vuoi configurare i postback del ciclo di vita delle azioni.
6. Inserisci l'URL del tuo server. È l'URL a cui impact.com invierà i postback.
7. Seleziona il metodo HTTP che preferisci.
   * Se selezioni **POST**, dovrai quindi inserire il body della richiesta e selezionare un **Formato del body**. Di seguito è riportato un esempio di come potresti mappare ogni punto dati in formato JSON. Le chiavi di ogni coppia chiave-valore devono provenire dalla configurazione del tuo sistema; i valori corrispondono invece ai punti dati che scegli e che impact.com fornisce, e devono essere inseriti tra parentesi graffe { }.

     <div data-with-frame="true"><figure><img src="https://1708986086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FwVvNFu7iuPM0eAwyMk6L%2FScreenshot%202026-05-23%20at%2013.07.16.png?alt=media&amp;token=f33b091a-cead-4e1b-80f2-0ebd97810835" alt="" width="563"><figcaption></figcaption></figure></div>
   * Consulta alcuni dei [parametri del body disponibili di impact.com](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * Non trovi il valore che ti serve? Contatta il tuo Account Manager (oppure [contatta l'assistenza](https://app.impact.com/support/portal.ihtml)).
8. Seleziona **Mostra impostazioni avanzate**. Queste impostazioni sono facoltative.
   * Inserisci un **ritardo minimo** tra il verificarsi di un evento non standard e la generazione e l'invio del postback al tuo sistema.
   * Imposta un limite di frequenza per il numero massimo di **richieste** al secondo che impact.com può inviare al tuo sistema.
   * Inserisci il contenuto che desideri ricevere come **risposta di successo** a un postback.
   * Inserisci il contenuto che desideri ricevere come **risposta di errore** a un postback.
9. Seleziona **Salva**.

Ora che hai configurato i postback a livello di evento, il tuo sistema dovrebbe iniziare a ricevere postback per il tipo di evento selezionato nel *Passaggio 5*. Per scoprire come testare la nuova configurazione dei postback, consulta la sezione *Testare un postback del ciclo di vita di un'azione* qui sotto.

### Esempio di valori dinamici

Se hai configurato variabili dinamiche per i tuoi link di tracciamento, puoi configurare un URL di postback per il tuo server, così da ricevere una notifica quando si verificano azioni e recuperare i valori popolati dinamicamente associati all'azione.

Questo esempio mostra come passare un valore `SharedId` (un valore che vuoi condividere con i brand) a un parametro in un postback (`MyParam`). Alcuni brand potrebbero richiederti di configurarlo.

<div data-with-frame="true"><figure><img src="https://1708986086-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>

Un URL di postback potrebbe essere simile a questo:

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

L'URL di postback popolerà il parametro `MyParam` con il valore recuperato da `SharedId`.

</details>

## Testare un postback del ciclo di vita di un'azione

Dopo aver configurato un postback del ciclo di vita di un'azione, indipendentemente dal livello a cui si applica, dovresti testarlo. Puoi eseguire un postback di test in impact.com (disponibile solo per i postback a livello di evento) oppure effettuare una conversione.

Se un postback non va a buon fine quando impact.com invia una richiesta all'URL di destinazione, impact.com riprova automaticamente a recapitarlo. impact.com effettua fino a 15 tentativi complessivi per un postback non riuscito. impact.com salta i primi 3 tentativi per le risposte HTTP da `400` a `500`. Per consultare la pianificazione completa dei tentativi e i dettagli sulla risoluzione dei problemi, vedi [Testare e risolvere i problemi di un URL di postback](https://help.impact.com/partner/it/di-cosa-vorresti-saperne-di-piu/platform-features/action-management/event-notifications-and-postbacks/test-and-troubleshoot-a-postback-url.md).

<details>

<summary>Eseguire un postback di test in impact.com</summary>

Se hai configurato un postback a livello di evento, puoi testarlo dal tuo account impact.com.

1. Nella barra di navigazione in alto, seleziona **Discover →** [**Brand**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml).
2. Seleziona la scheda del brand a cui appartiene il postback che vuoi testare.
3. Sotto il nome del brand, seleziona ![](https://1708986086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **Altro** → **Integrazione di tracciamento**.
4. Nella sezione *Postback* , seleziona ![](https://1708986086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-df93ac0f80fc5cece7983980a5ce3fbcf19aabce%2F3ef9d737089bc07dbb7e4fd41a97edfbaec261e4f55ab3a1666f3daf957f69c3.svg?alt=media) **\[Freccia giù] Azioni**, quindi seleziona **Avvia test**.
5. Verifica che l'URL del postback sia corretto, quindi seleziona **Avvia test**.

</details>

<details>

<summary>Creare una conversione di test</summary>

Questo test non verrà eseguito nell'app web di impact.com. Eseguirai invece un test end-to-end che riproduce il percorso tipico di un utente. Assicurati di avvisare il brand partner che effettuerai il test.

1. Dalla barra di navigazione superiore, seleziona **Gestisci →** [**Creatività del brand**](https://app.impact.com/secure/mediapartner/ads/searchAdsDirectoryMP.ihtml#adType=all).
2. Seleziona un annuncio.
3. Sotto il nome dell'annuncio, seleziona **Ottieni link di tracciamento**.
4. Seleziona ![](https://1708986086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FNb1O82vHF1ZWPG3qRZj3%2FToggle.svg?alt=media\&token=58221b77-b655-4ce3-bfba-64a50f3f60db) **\[Attiva interruttore]** **Parametri di tracciamento**.
5. Inserisci **ID secondari** oppure un **ID condiviso** come richiesto. Ogni campo deve contenere almeno un valore.
   * Salta questo passaggio se questi campi contengono già dei valori.
6. Facoltativamente, seleziona una **Proprietà** dall'elenco a discesa.
7. Seleziona **Salva**.
8. Seleziona **Copia link di tracciamento**.
9. **Incolla** il link in una nuova finestra del browser.
10. Completa l'azione.
11. Dopo circa 15 minuti, controlla il tuo sistema per verificare la presenza del postback generato da questa azione di test.
    * L'elaborazione delle azioni richiede in genere 15 minuti.
    * Potrai inoltre visualizzare questa nuova azione in sospeso nella schermata [Azioni in sospeso](https://app.impact.com/secure/mediapartner/actionworkflows/mp-pending-actions-flow.ihtml)  . Se visualizzi l'azione nella schermata *Azioni in sospeso* ma non hai ancora ricevuto un postback, ricontrolla la configurazione del postback.
12. Chiedi al brand di annullare l'azione.
13. Controlla il tuo sistema per verificare la presenza del postback generato dall'annullamento.
    * Se visualizzi l'azione annullata nella schermata [Azioni annullate](https://app.impact.com/secure/mediapartner/MP_Performance_Report/action-workflows/mp-reversed-actions-flow.ihtml) ma non hai ricevuto un postback, ricontrolla la configurazione del postback.

</details>

### Risoluzione degli errori

Usa la tabella di riferimento qui sotto per identificare e risolvere i problemi più comuni che si verificano durante la configurazione dei postback del ciclo di vita delle azioni.

<table><thead><tr><th width="199.859375">Errore</th><th>Descrizione</th></tr></thead><tbody><tr><td>Parametro obbligatorio mancante</td><td>È probabile che il tuo server si aspetti un valore anziché una variabile. Modifica l’URL di postback per passare un valore di prova (ad es. "12345678" invece di <code>{SubId1}</code>) e verifica se accetta il valore statico.</td></tr><tr><td>Variabili con distinzione tra maiuscole e minuscole</td><td>Le variabili dinamiche distinguono tra maiuscole e minuscole e devono essere riportate esattamente; ciò significa che <code>{SubId1}</code> non equivale a <code>{subid1}</code>. Verifica attentamente che le variabili rispettino la corretta distinzione tra maiuscole e minuscole.</td></tr><tr><td>Accesso negato</td><td>La maggior parte dei server di postback richiede un token o un valore di sicurezza da inviare insieme alle variabili dinamiche. Rivolgiti al team tecnico del tuo sito web (oppure consulta la documentazione del provider del sito) per sapere quale token o valore di sicurezza è necessario per accedere al server.</td></tr></tbody></table>

{% hint style="success" icon="circle-info" %}
**Nota:** Se non riesci a individuare problemi nella configurazione del postback, ma continui a non riceverli, [contatta il supporto](https://app.impact.com/support/portal.ihtml). impact.com può verificare se i postback vengono generati, qual è il codice di risposta di ciascuno e qual è il corpo di ogni postback. Queste informazioni potrebbero aiutarti a eseguire il debug della configurazione.
{% endhint %}


---

# 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/partner/it/di-cosa-vorresti-saperne-di-piu/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.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.
