> 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 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 che meglio si adatta alle tue esigenze per saperne di più sul processo di configurazione. {% hint style="warning" %} **Attenzione:** 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. Nota 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 spiegherà come creare postback per l'intero account in una sola volta. I partner che hanno un solo sistema in grado di ricevere e utilizzare questi postback oppure che desiderano notifiche per tutti gli eventi non standard dovrebbero configurare i postback del ciclo di vita dell'azione a livello globale. {% hint style="success" %} **Nota:** Se vuoi essere più selettivo riguardo ai tipi di eventi per cui riceverai i postback, consulta la sezione seguente per configurare *i postback del ciclo di vita dell'azione a livello di evento*. {% endhint %} 1. Dalla barra di navigazione superiore, 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 evento**](https://app.impact.com/secure/mediapartner/accountSettings/view-edit-pingback-settings-flow.ihtml). 3. Accanto a *Eventi del ciclo di vita dell'azione*, 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. Questo è l'URL a cui impact.com invierà i postback. 5. Seleziona il metodo HTTP preferito. * Visualizza alcuni dei [parametri del corpo disponibili](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing). * Se selezioni **POST**, dovrai quindi inserire il corpo della richiesta e selezionare 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 dovrebbero provenire dalla configurazione del tuo sistema, mentre i valori saranno il punto dati corrispondente che hai scelto e che impact.com fornisce e che dovrebbero essere inseriti tra parentesi `{ }`.
* Non vedi un valore di cui hai bisogno? Rivolgiti al tuo Account Manager (o [contatta il supporto](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 quando si verifica un evento non standard e quando il postback viene generato e inviato al tuo sistema. * Inserisci un limite di velocità per il **Numero massimo di richieste** che impact.com può effettuare al tuo sistema al secondo. * Inserisci quello che vuoi che la **Risposta di successo** a un postback sia. * Inserisci quello che vuoi che la **Risposta di errore** a un postback sia. 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 imparare a testare la nuova configurazione del postback, consulta la *Sezione Testa 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 sul tuo server per notificarti quando si verificano azioni e recuperare i valori popolati dinamicamente associati 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 avrebbe un aspetto simile a: `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 spiegherà come creare postback per tipi di evento specifici che tracciano quando generi azioni. Se vuoi essere più selettivo con i tipi di eventi per cui ricevi i postback, dovresti configurare i postback del ciclo di vita dell'azione a livello di evento. {% hint style="success" %} **Nota:** Se configuri i 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 →** [**Brand**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml). 2. Seleziona la scheda del brand che possiede 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. Vicino all'angolo in alto a destra della pagina, seleziona **Aggiungi postback**. 5. Seleziona il tipo di evento (precedentemente *action tracker*) per cui vuoi configurare i postback del ciclo di vita dell'azione. 6. Inserisci l'URL del tuo server. Questo è l'URL a cui impact.com invierà i postback. 7. Seleziona il metodo HTTP preferito. * Se selezioni **POST**, dovrai quindi inserire il corpo della richiesta e selezionare 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 dovrebbero provenire dalla configurazione del tuo sistema, mentre i valori saranno il punto dati corrispondente che impact.com fornisce e che dovrebbero 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 un valore di cui hai bisogno? Rivolgiti al tuo Account Manager (o [contatta il supporto](https://app.impact.com/support/portal.ihtml)). 8. Seleziona **Mostra impostazioni avanzate**. Queste impostazioni sono facoltative. * Inserisci un **Ritardo minimo** tra quando si verifica un evento non standard e quando il postback viene generato e inviato al tuo sistema. * Inserisci un limite di velocità per il **Numero massimo di richieste** che impact.com può effettuare al tuo sistema al secondo. * Inserisci quello che vuoi che la **Risposta di successo** a un postback sia. * Inserisci quello che vuoi che la **Risposta di errore** a un postback sia. 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 che hai selezionato nel *Passaggio 5*. Per imparare a testare la nuova configurazione del postback, consulta la *Sezione Testa 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 sul tuo server per notificarti quando si verificano azioni e recuperare i valori popolati dinamicamente associati 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 avrebbe un aspetto simile a: `https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}` L'URL di postback popolerà il `MyParam` parametro con il valore recuperato da `SharedId`.
## Sezione Testa 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 invia il post al tuo URL di destinazione, impact.com ritenta automaticamente la consegna. impact.com ritenta un postback non riuscito 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 [Testa e risolvi i problemi di un URL di postback](/partner/it/di-cosa-vorresti-saperne-di-piu/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 →** [**Brand**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml). 2. Seleziona la scheda del brand che possiede 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. Dalla *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. Conferma che l'URL del postback sia corretto, quindi seleziona **Avvia il 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 avvisare il brand partner che eseguirai 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%2FEv341AdIiPndQSb7uGMI%2FToggle%20on.svg?alt=media\&token=4ae8972d-c510-4ee2-adc5-e7170981650b) **\[Attiva]** **Parametri di tracciamento**. 5. Inserisci **Sub ID** o un **ID condiviso** come richiesto. Ogni campo richiede almeno una voce. * Salta questo passaggio se hai già valori in questi campi. 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 nel tuo sistema il postback generato da questa azione di test. * 15 minuti è in genere 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 schermata *Azioni in sospeso* 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 Usa la tabella di riferimento qui sotto per identificare e risolvere i problemi comuni riscontrati durante la configurazione dei postback del ciclo di vita dell'azione.
ErroreDescrizione
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 case-sensitiveLe variabili dinamiche distinguono tra maiuscole e minuscole e devono essere esatte, il che significa che {SubId1} non è la stessa cosa di {subid1}. Ricontrolla che le tue variabili rispettino la corretta distinzione tra maiuscole e minuscole.
Accesso negatoLa maggior parte dei server di postback dispone di un token di sicurezza o di un valore che deve essere passato insieme alle variabili dinamiche. Collabora con il team tecnico del tuo sito web (o consulta la documentazione del tuo provider del sito web) per conoscere il token o il valore di sicurezza necessario per accedere al server.
{% hint style="success" icon="circle-info" %} **Nota:** Se non riesci a trovare alcun problema con la configurazione del postback ma ancora non li ricevi, [contatta il supporto](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 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=&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.