> 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/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md). # Invia modifiche e inversioni in batch Quando un partner genera una conversione—come una vendita—e il periodo di blocco per quell'azione non è ancora trascorso, puoi correggere eventuali dati errati dell'azione inviando una modifica o una revoca. Questo garantisce che il partner venga pagato correttamente quando il periodo di blocco termina. Le azioni vengono in genere modificate o revocate quando i clienti restituiscono ordini, commettono errori durante il checkout o quando gli articoli non sono disponibili. Puoi inviare modifiche e revoche in blocco tramite API oppure tramite FTP/email, come descritto in questo articolo. Il modello di cui hai bisogno per gli invii FTP/email dipende dal fatto che tu stia tracciando a livello di ordine o di articolo, poiché ciascuno richiede campi diversi. Se non sei sicuro di quale file usare, chiedi al tuo CSM o [contatta l'assistenza](https://app.impact.com/support/portal.ihtml). ### Quale metodo di invio è adatto a te? | Se vuoi... | Usa questo metodo... | | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Invia un file manuale, una tantum, senza codice | ​[Email](/brand/it/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/submit-conversion-data-via-ftp-or-email.md#before-you-start) elaborazione in batch o [carica file tramite FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#upload-file-to-system-ftp-server) | | Configura la reportistica automatizzata delle conversioni | ​[Conversioni](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [Azioni](https://integrations.impact.com/brand-api-reference/reference/actions) API, [invia file tramite FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#upload-file-to-system-ftp-server), oppure [recupera file tramite FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#pull-file-from-your-own-ftp-server) | ### Cose da tenere a mente: * **Usa formati di file supportati** — Il tuo file di invio deve essere in formato .CSV o .XML. * **Non aggiungere nuovi punti dati** — Non puoi aggiungere nuovi campi a una transazione, puoi solo aggiornare quelli esistenti. * **Comprendi la gestione della deduplicazione** — Quando più azioni condividono lo stesso *Oid/OrderId*, impact.com applica gli aggiornamenti al più recente *ActionId*. Per sovrascriverlo, specifica il desiderato *ActionId*. * **Usa *****Importo***** correttamente per le revoche** — Per revocare un'azione, puoi impostare *Amount = 0*. Tuttavia, se l'originale *Amount = 0*, mantenerlo a 0 verrà registrato come una modifica e l'azione non verrà revocata. {% stepper %} {% step %} #### Passaggio 1: prepara il tuo file di dati 1. Individua il file modello pertinente al tuo caso d'uso. * Vedi [Riferimento per modifiche e revoche in blocco](/brand/it/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md) per file modello con dati di esempio. 2. Incolla il contenuto del modello in un'applicazione per fogli di calcolo (ad es. Microsoft Excel) o in un editor di testo (ad es. Notepad). 3. Sotto la riga di intestazione, inizia ad aggiungere i dati dell'azione modificati. * Se usi un editor di testo, usa le virgole per separare ogni punto dati. * Se usi un editor per fogli di calcolo, aggiungi ogni punto dati in una cella separata.

Nota: Assicurati di modificare le celle del foglio di calcolo nel formato "Testo normale" o "Testo" in modo che i valori non vengano omessi accidentalmente.

4. Salva il file con un nome identificabile, ad esempio: `Batch_Mods/Reversals_2025_02_12.csv` * Per un elenco dei campi comunemente usati nell'elaborazione in batch via FTP/email, vedi [Riferimento per modifiche e revoche in blocco](/brand/it/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md). In alternativa, consulta il nostro [Riferimenti ai campi di azione e conversione](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) per un elenco completo dei campi supportati. {% endstep %} {% step %} impact.com consente un massimo di 1.000 modifiche per azione. Se in seguito devi apportare ulteriori modifiche, [contatta l'assistenza](https://app.impact.com/support/portal.ihtml). 1. Dalla barra di navigazione superiore, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b527686787b925f477dff4feb9be3a63f51250a7%2Fdcf31aa89710c2f91d880b79ce8d8c18489cd8cad334e5cd91dd7ee0372a44fd.svg?alt=media) **\[Profilo utente] → Impostazioni**. 2. Nella colonna di destra, sotto *Tracciamento*, seleziona [**Tipi di evento**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml). 3. Seleziona il **nome** del tipo di evento per cui desideri inviare modifiche in blocco. 4. Accanto a *Gestione dei resi*, 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]**. 5. Seleziona **Automatizza la gestione dei resi (avanzato)**. 6. Scegli uno dei seguenti metodi relativi a FTP o email per inviare il tuo file:
Carica il file sul server FTP del sistema {% hint style="info" %} Ti consigliamo di suddividere i file FTP/SFTP per mantenere il numero massimo di voci per file inferiore a 10.000. {% endhint %} 1. Seleziona **Carica il file sul server FTP del sistema.** 2. Seleziona **Invia via email nome utente e password FTP** e **Salva**. 3. Una volta ricevute le credenziali FTP via email, usa un client FTP per connetterti a impact.com con le seguenti informazioni: | | FTP | SFTP | | --------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | **Server** | batch.impact.com | sftp\://batch.impact.com | | **Porta** | 21 | 22 | | **Nome utente** | (Il tuo nome utente FTP di impact.com, con distinzione tra maiuscole e minuscole.) | (Il tuo nome utente SFTP di impact.com, con distinzione tra maiuscole e minuscole.) | | **Password** | (La tua password FTP di impact.com, con distinzione tra maiuscole e minuscole.) | (La tua password SFTP di impact.com, con distinzione tra maiuscole e minuscole.) | 4. Una volta connesso, carica il tuo file nella directory principale del server. * Se non hai ricevuto l'email con le credenziali FTP, contatta la persona che ha creato il tuo account impact.com. In alternativa, [contatta l'assistenza](https://app.impact.com/support/portal.ihtml).
Recupera il file dal tuo server FTP {% hint style="info" %} Ti consigliamo di suddividere i file FTP/SFTP per mantenere il numero massimo di voci per file inferiore a 10.000. {% endhint %} 1. Seleziona **Recupera il file dal tuo server FTP**. 2. Inserisci il **URL del server**, **Porta**, e **Directory** percorso al file delle modifiche in blocco sul tuo server FTP. Inserisci il **Nome utente** e **Password** che impact.com utilizzerà per connettersi al tuo server FTP. 3. Seleziona **Salva** e continua. 4. Carica il tuo file nel *Directory* specificato sopra. * impact.com tenta di connettersi e scaricare i file dal tuo server FTP ogni 24 ore, quindi il tuo file potrebbe impiegare fino a 24 ore per essere elaborato dopo il caricamento.
Invia il file via email al server SMTP del sistema 1. Seleziona **Invia il file via email al server SMTP del sistema.** 2. Ti verrà fornito un indirizzo email univoco subito sotto il metodo selezionato. Copia questo indirizzo email. 3. Usando qualsiasi client di posta, invia un'email all'indirizzo univoco con il file delle modifiche in blocco come allegato. * Includi solo l'indirizzo email univoco per il tipo di evento nel campo *A:* Se devi inviare questo file ad altri, includili nel campo *CC:* campo. 4. Puoi lasciare vuoti il campo oggetto e il corpo del messaggio. * Vedi un esempio dell'indirizzo email qui sotto (il tuo sarà leggermente diverso):
{% endstep %} {% step %} #### Passaggio 3: rivedi l'invio del file Dopo aver inviato il tuo file .CSV o .XML a impact.com, puoi controllarne lo stato per vedere se è stato elaborato. 1. Dalla barra di navigazione superiore, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b527686787b925f477dff4feb9be3a63f51250a7%2Fdcf31aa89710c2f91d880b79ce8d8c18489cd8cad334e5cd91dd7ee0372a44fd.svg?alt=media) **\[Profilo utente] → Impostazioni**. 2. Nella colonna di sinistra, scorri fino a *Tecnico* sezione e seleziona [**Invii di file**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml). 3. Usa la tabella per rivedere gli invii recenti dei file ricevuti da impact.com, incluso lo stato di elaborazione corrente. * I file inviati appariranno entro 10-15 minuti dall'invio, mentre gli aggiornamenti generali dei report possono richiedere più di 2 ore. * Di seguito sono riportati vari problemi che potresti incontrare durante la revisione degli invii dei file e le azioni che puoi intraprendere per risolverli.
Riferimento per la risoluzione dei problemi di invio | Problema | Azione da intraprendere | | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | La colonna dei record mostra 0 | Assicurati che l'estensione del file sia . CSV o .XML. | | `NO_CHANGE` | Non è stata apportata alcuna modifica all'azione. Assicurati di inserire l'importo finale nella *Importo* colonna (ad es., inserisci 0 se desideri annullare le azioni). | | `BAD_DISPOSITION` |

Il codice motivo che hai fornito non è valido. Utilizza uno degli standard codici motivo.

In alternativa, puoi impostare un codice di disposizione personalizzato.

| | `ALREADY_LOCKED` | Il periodo di blocco dell'azione è già trascorso. L'azione non può più essere modificata o annullata. | | `Il valore ActionTrackerld:ActionTrackerld non è valido` | Questo dovrebbe corrispondere al [ID tipo evento](/brand/it/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md) inserito. | | `ACTION_NOT_FOUND` | Il `OID` che hai fornito non è corretto. Fornisci un corretto `OID`. | | `ALREADY_REVERSED` | L'azione è già stata annullata. | | `ALREADY_APPROVED` | L'azione è già stata approvata. |
{% endstep %} {% endstepper %} --- # 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/brand/it/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.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.