> 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/cosa-vorresti-imparare/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md).
# Configura i postback del ciclo di vita delle azioni
Esistono due tipi principali di postback del ciclo di vita dell'azione. **A livello globale** crea postback per l'intero account e **a livello di evento** crea postback per tipi di evento specifici. Seleziona quello più adatto alle tue esigenze per saperne di più sul processo di configurazione.
{% hint style="warning" %}
**Avvertenza:** Per i postback a livello globale, dovresti ricevere un postback ogni volta che si verifica un evento "non standard", come una modifica o un annullamento. Tieni presente che i postback a livello di evento non attiveranno eventi del ciclo di vita dell'azione non standard.
{% endhint %}
#### Configura un postback del ciclo di vita dell'azione
Configura un postback del ciclo di vita dell'azione a livello globale
Questa sezione illustrerà come creare postback per l'intero account in una sola volta. I partner che dispongono solo di un sistema in grado di ricevere e utilizzare questi postback oppure che desiderano notifiche per tutti gli eventi non standard dovrebbero configurare postback del ciclo di vita dell'azione a livello globale.
{% hint style="info" %}
**Nota:** Se desideri essere più selettivo riguardo ai tipi di eventi per i quali riceverai i postback, consulta la sezione seguente per configurare *postback del ciclo di vita dell'azione a livello di evento*.
{% endhint %}
1. Dalla barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. In *Tecnico*, seleziona **Notifiche eventi**.
3. Accanto a *Eventi del ciclo di vita dell'azione*, seleziona  **\[Modifica]**.
4. Inserisci l'URL del tuo server. Questo è l'URL al quale impact.com invierà i postback.
5. Seleziona il metodo HTTP che preferisci.
* Visualizza alcuni dei [parametri del corpo disponibili](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
* Se selezioni **POST**, inserirai quindi il corpo della richiesta e selezionerai un **Formato del corpo**. Di seguito è riportato un esempio di come potresti mappare ciascun punto dati per un formato JSON. Le chiavi in ogni coppia chiave-valore devono provenire dalla configurazione del tuo sistema e i valori saranno il punto dati corrispondente che hai scelto e che impact.com fornisce e che devono essere inseriti tra parentesi `{ }`.
* Non vedi il valore che ti serve? Rivolgiti al tuo Account Manager (o [contatta l'assistenza](https://app.impact.com/support/portal.ihtml)).
6. Seleziona **Eventi del ciclo di vita dell'azione**. Queste impostazioni sono facoltative.
* Inserisci un **Intestazione HTTP**. Se sono necessarie più coppie, separale con un punto e virgola.
* Inserisci un **Ritardo minimo** tra il momento in cui si verifica un evento non standard e il momento in cui il postback viene generato e inviato al tuo sistema.
* Inserisci un limite di velocità per il **Richieste massime** che impact.com può effettuare al tuo sistema al secondo.
* Inserisci ciò che vuoi che **Risposta di successo** sia a un postback.
* Inserisci ciò che vuoi che **Risposta di errore** sia 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 del postback, consulta la sezione *Testare un postback del ciclo di vita dell'azione* qui sotto.
**Esempio di valori dinamici**
Se hai configurato variabili dinamiche per i tuoi link di tracciamento, puoi configurare un URL di postback verso il tuo server per notificarti quando si verificano azioni e recuperare il/i valore/i popolato/i dinamicamente associato/i all'azione.
Questo esempio mostra come passare un `SharedId` valore (un valore che vuoi condividere con i brand) a un parametro in un postback (`MyParam`). Alcuni brand potrebbero richiederti di configurarlo.
Un URL di postback potrebbe essere simile a questo:
`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`
L'URL di postback popolerà il `MyParam` parametro con il valore recuperato da `SharedId`.
Configura i postback del ciclo di vita dell'azione a livello di evento
Questa sezione illustrerà come creare postback per tipi di evento specifici che tracciano quando generi azioni. Se vuoi essere più selettivo riguardo ai tipi di evento per i quali ricevi i postback, dovresti configurare postback del ciclo di vita dell'azione a livello di evento.
{% hint style="info" %}
**Nota:** Se configuri postback del ciclo di vita dell'azione a livello globale, non è necessario configurare quelli a livello di evento.
{% endhint %}
1. Dalla barra di navigazione superiore, seleziona **Scopri → I miei brand**.
2. Seleziona la scheda del brand proprietario del postback che vuoi testare.
3. Sotto il nome del brand, seleziona  **\[Altro]** → **Integrazione di tracciamento**.
4. Vicino all'angolo in alto a destra della pagina, seleziona **Aggiungi postback**.
5. Seleziona il tipo di evento (in precedenza *tracker di azione*) per il quale vuoi configurare i postback del ciclo di vita dell'azione.
6. Inserisci l'URL del tuo server. Questo è l'URL al quale impact.com invierà i postback.
7. Seleziona il metodo HTTP che preferisci.
* Se selezioni **POST**, inserirai quindi il corpo della richiesta e selezionerai un **Formato del corpo**. Di seguito è riportato un esempio di come potresti mappare ciascun punto dati per un formato JSON. Le chiavi in ogni coppia chiave-valore devono provenire dalla configurazione del tuo sistema e i valori saranno il punto dati corrispondente che hai scelto e che impact.com fornisce e che devono essere inseriti tra parentesi { }.
* Visualizza alcuni dei [parametri del corpo disponibili](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
* Non vedi il valore che ti serve? Rivolgiti al tuo Account Manager (o [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 momento in cui si verifica un evento non standard e il momento in cui il postback viene generato e inviato al tuo sistema.
* Inserisci un limite di velocità per il **Richieste massime** che impact.com può effettuare al tuo sistema al secondo.
* Inserisci ciò che vuoi che **Risposta di successo** sia a un postback.
* Inserisci ciò che vuoi che **Risposta di errore** sia 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 in *Passaggio 5*. Per scoprire come testare la nuova configurazione del postback, consulta la sezione *Testare un postback del ciclo di vita dell'azione* qui sotto.
**Esempio di valori dinamici**
Se hai configurato variabili dinamiche per i tuoi link di tracciamento, puoi configurare un URL di postback verso il tuo server per notificarti quando si verificano azioni e recuperare il/i valore/i popolato/i dinamicamente associato/i all'azione.
Questo esempio mostra come passare un `SharedId` valore (un valore che vuoi condividere con i brand) a un parametro in un postback (`MyParam`). Alcuni brand potrebbero richiederti di configurarlo.
Un URL di postback potrebbe essere simile a questo:
`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`
L'URL di postback popolerà il `MyParam` parametro con il valore recuperato da `SharedId`.
#### Testare un postback del ciclo di vita dell'azione
Una volta configurato un postback del ciclo di vita dell'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 fallisce quando impact.com lo invia all'URL di destinazione, impact.com ritenta automaticamente la consegna. impact.com ritenta un postback fallito fino a 15 volte in totale. impact.com salta i primi 3 tentativi per le risposte HTTP da `400` a `500`. Per il programma completo dei tentativi e i dettagli sulla risoluzione dei problemi, consulta [Testare e risolvere i problemi di un URL di postback](/partner/it/cosa-vorresti-imparare/platform-features/action-management/event-notifications-and-postbacks/test-and-troubleshoot-a-postback-url.md).
Esegui un postback di test in impact.com
Se hai configurato un postback a livello di evento, puoi testarlo all'interno del tuo account impact.com.
1. Dalla barra di navigazione superiore, seleziona **Scopri → I miei brand**.
2. Seleziona la scheda del brand proprietario del postback che vuoi testare.
3. Sotto il nome del brand, seleziona  **Altro** → **Integrazione di tracciamento**.
4. Dalla *sezione Postback* , seleziona  **\[Freccia in giù] Azioni**, quindi seleziona **Avvia test**.
5. Conferma che l'URL del postback sia corretto, quindi seleziona **Avvia test**.
Crea una conversione di test
Questo test non verrà eseguito nell'app web di impact.com. Invece, eseguirai un test end-to-end che segue un tipico percorso utente. Assicurati di informare il brand partner che eseguirai il test.
1. Dalla barra di navigazione superiore, seleziona **Contenuti → Asset**.
2. Seleziona un annuncio.
3. Sotto il nome dell'annuncio, seleziona **Ottieni link di tracciamento**.
4. Seleziona  **\[Attiva]** **Parametri di tracciamento**.
5. Inserisci **Sub ID** oppure un **Shared ID** come richiesto. Ogni campo richiede almeno una voce.
* Salta questo passaggio se hai già valori in questi campi.
6. Facoltativamente, seleziona una **Proprietà** dal menu 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 nel tuo sistema il postback generato da questa azione di test.
* Di solito 15 minuti è il tempo necessario per l'elaborazione dell'azione.
* Potrai anche vedere questa nuova azione in sospeso nella schermata [Azioni in sospeso](https://app.impact.com/secure/mediapartner/actionworkflows/mp-pending-actions-flow.ihtml) . Se vedi l'azione nella *Azioni in sospeso* schermata ma non hai ancora ricevuto un postback, ricontrolla la configurazione del postback.
12. Chiedi al tuo brand di annullare l'azione.
13. Controlla nel tuo sistema il postback generato da questo annullamento.
* Se vedi 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.
Risolvi gli errori
| Errore | Descrizione |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Parametro obbligatorio mancante | È probabile che il tuo server si aspetti un valore invece di una variabile. Modifica il tuo URL di postback per passare un valore di test (ad es. "12345678" invece di `{SubId1}`) e verifica se accetta il valore hard-coded. |
| Variabili con distinzione tra maiuscole e minuscole | Le variabili dinamiche sono sensibili alle maiuscole e minuscole e devono essere esatte, il che significa che `{SubId1}` non è la stessa cosa di `{subid1}`. Controlla attentamente che le tue variabili riflettano la corretta distinzione tra maiuscole e minuscole. |
| Accesso negato | La maggior parte dei server di postback dispone di un token di sicurezza o di un valore che deve essere trasmesso insieme alle variabili dinamiche. Collabora con il team tecnico del tuo sito web (o consulta la documentazione del fornitore del sito) per conoscere il token o il valore di sicurezza necessari per accedere al server. |
{% hint style="success" icon="circle-info" %}
**Nota:** Se non riesci a trovare alcun problema nella configurazione del postback ma non li ricevi ancora, [contatta l'assistenza](https://app.impact.com/support/portal.ihtml). impact.com può verificare se i postback vengono generati, qual è il codice di risposta per ciascuno e il corpo di ciascun 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.impact.com/partner/it/cosa-vorresti-imparare/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.