> 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 annullamenti in batch Quando un partner genera una conversione—come una vendita—e il periodo di blocco per quell'azione non è ancora scaduto, puoi correggere eventuali dati azione errati inviando una modifica o uno storno. In questo modo si garantisce che il partner venga pagato correttamente alla scadenza del periodo di blocco. Le azioni vengono in genere modificate o stornate quando i clienti restituiscono ordini, commettono errori durante il checkout o quando gli articoli non sono disponibili. Puoi inviare modifiche e storni in blocco tramite API, oppure tramite FTP/email come descritto in questo articolo. Il modello di cui hai bisogno per gli invii via 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 è giusto per 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 file inviato deve essere in formato .CSV o .XML. * **Non aggiungere nuovi punti dati** — Non puoi aggiungere nuovi campi a una transazione, ma 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 sovrascrivere questo, specifica il desiderato *ActionId*. * **Usa *****Importo***** correttamente per gli storni** — Per stornare un'azione, puoi impostare *Amount = 0*. Tuttavia, se l'originale *Amount = 0*, lasciandolo a 0 verrà registrato come una modifica e l'azione non verrà stornata. {% stepper %} {% step %} #### Passaggio 1: prepara il tuo file di dati 1. Identifica il file modello pertinente al tuo caso d'uso. * Vedi [Riferimento per modifiche e storni in batch](/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 azione modificati. * Se stai usando un editor di testo, usa le virgole per separare ogni punto dati. * Se stai usando un editor per fogli di calcolo, aggiungi ogni punto dati in una cella separata.

Nota: Assicurati di modificare le celle del foglio di calcolo in formato "testo semplice" 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 batch via FTP/email, vedi [Riferimento per modifiche e storni in batch](/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 le nostre [Riferimenti dei campi di azione e conversione](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) per l'elenco completo dei campi supportati. {% endstep %} {% step %} impact.com consente un massimo di 1.000 modifiche per azione. Se dopo hai bisogno di apportare ulteriori modifiche, [contatta l'assistenza](https://app.impact.com/support/portal.ihtml). 1. Dalla barra di navigazione superiore, seleziona ![](/files/9cd266a8f48956f16b756268ec5df533881606b9) **\[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 *Elaborazione dei resi*, seleziona ![](/files/06805c880643774310ff3dae44fb97e4b59a7553) **\[Modifica]**. 5. Seleziona **Automatizza l'elaborazione 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" %} Consigliamo di suddividere i file FTP/SFTP per mantenere il numero massimo di voci per file sotto 10.000. {% endhint %} 1. Seleziona **Carica il file sul server FTP del sistema.** 2. Seleziona **Invia per email nome utente e password FTP** e **Salva**. 3. Una volta ricevute via email le tue credenziali FTP, 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" %} Consigliamo di suddividere i file FTP/SFTP per mantenere il numero massimo di voci per file sotto 10.000. {% endhint %} 1. Seleziona **Recupera il file dal tuo server FTP**. 2. Inserisci il **URL del server**, **Porta**, e **Directory** percorso del 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 nella *Directory* che hai 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 per email al server SMTP del sistema 1. Seleziona **Invia il file per email al server SMTP del sistema.** 2. Ti verrà fornito un indirizzo email univoco subito sotto il metodo selezionato. Copia questo indirizzo email. 3. Utilizzando qualsiasi client email, invia un'email all'indirizzo univoco con il tuo file delle modifiche in blocco come allegato. * Includi solo l'indirizzo email univoco per il tipo di evento nel *A:* campo. Se devi inviare questo file ad altri, includili nel *CC:* campo. 4. Puoi lasciare vuoti il campo oggetto e il corpo del messaggio. * Vedi di seguito un esempio dell'indirizzo email (il tuo sarà leggermente diverso):
{% endstep %} {% step %} #### Passaggio 3: controlla l'invio del tuo file Dopo aver inviato il tuo file .CSV o .XML a impact.com, puoi verificare il suo stato per vedere se è stato elaborato. 1. Dalla barra di navigazione superiore, seleziona ![](/files/9cd266a8f48956f16b756268ec5df533881606b9) **\[Profilo utente] → Impostazioni**. 2. Nella colonna a sinistra, scorri fino a *Tecnico* sezione e seleziona [**Invio file**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml). 3. Usa la tabella per rivedere i recenti invii di file ricevuti da impact.com, incluso lo stato di elaborazione attuale. * 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 dell'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 dei codici standard codici di motivo.

In alternativa, puoi configurare un codice di disposizione personalizzato.

| | `ALREADY_LOCKED` | Il periodo di blocco dell'azione è già scaduto. L'azione non può più essere modificata o annullata. | | `Il valore ActionTrackerld:ActionTrackerld non è valido` | Questo dovrebbe corrispondere a [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 `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.