# 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 modificare qualsiasi dato azione errato inviando una modifica o una revoca. Ciò garantisce che il partner venga pagato correttamente al termine del periodo di blocco.

Le azioni vengono normalmente modificate o revocate quando i clienti restituiscono ordini, commettono errori durante il checkout o quando gli articoli sono esauriti.

Puoi inviare modifiche e revoche in blocco sia [tramite API](https://integrations.impact.com/impact-brand/reference/actions-overview), sia tramite un server FTP/SMTP come descritto di seguito. Il modello di cui hai bisogno per le submission FTP/SMTP 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 utilizzare, chiedi al tuo CSM o [contatta il supporto](https://app.impact.com/support/portal.ihtml).

#### Cose da tenere a mente

* **Usa formati di file supportati** — Il file che invii 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 forzare un override, specifica il *ActionId*.
* **Usa&#x20;*****Importo*****&#x20;correttamente per le revoche** — Per revocare un'azione, puoi impostare *Importo = 0*. Tuttavia, se l'originale *Importo = 0*, lasciarlo a 0 verrà registrato come una modifica e l'azione non sarà revocata.

#### Passo 1: Prepara il tuo file di dati

Per un elenco dei campi comunemente usati nell'elaborazione batch FTP/SMTP, vedi [Riferimento Modifiche e Revoche in Batch](https://help.impact.com/brand/it/su-cosa-vorresti-saperne-di-piu/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference). In alternativa, vedi [Riferimenti dati azione e conversione di impact.com](https://integrations.impact.com/impact-brand/docs/impactcom-action-conversion-data-references) per un elenco completo dei campi supportati.

1. Identifica il file modello pertinente al tuo caso d'uso.
   * Vedi [Riferimento Modifiche e Revoche in Batch](https://help.impact.com/brand/it/su-cosa-vorresti-saperne-di-piu/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference) per i file modello con dati di esempio.
2. Incolla il contenuto del modello in un'applicazione di foglio di calcolo (es., Microsoft Excel) o in un editor di testo (es., Notepad).
3. Sotto la riga dell'intestazione, inizia ad aggiungere i dati azione modificati.

   * Se usi un editor di testo, usa le virgole per separare ogni punto dati.
   * Se usi un editor di fogli di calcolo, aggiungi ogni punto dati in una cella separata.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Importante:</strong> Assicurati di modificare le celle del foglio di calcolo in formato "Testo semplice" o "Testo" in modo che i valori non vengano accidentalmente omessi.</p></div>
4. Salva il file con un nome identificabile, ad esempio: `Batch_Mods/Reversals_2025_02_12.csv`

#### Passo 2: Invia il tuo file di dati

impact.com consente un massimo di 1.000 modifiche per azione. Se hai bisogno di effettuare ulteriori modifiche successivamente, contatta il supporto.

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. A 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 il quale desideri inviare modifiche in batch.
4. Accanto a *Elaborazione resi*, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Modifica]**.
5. Seleziona **Automatizza l'elaborazione dei resi (avanzato)**.
   * Scegli uno dei seguenti metodi relativi a FTP o SMTP per inviare il tuo file:

<details>

<summary>Carica il file sul server FTP del sistema</summary>

1. Seleziona **Carica il file sul server FTP del sistema.**
2. Seleziona **Salva**.
3. Una volta ricevute le tue credenziali FTP via email, usa un client FTP per connetterti a impact.com con le seguenti informazioni:

   <div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-602f57b0b5ea7fdd8e0b57e60b8bfbb03682a471%2Fb97d7d89206c581acaa9d0ec8e5da972dd3cfa859e0e78d3b23845104b796417.png?alt=media" alt=""><figcaption></figcaption></figure></div>
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 il supporto](https://app.impact.com/support/portal.ihtml).

</details>

<details>

<summary>Preleva il file dal tuo server FTP</summary>

1. Seleziona **Preleva il file dal tuo server FTP**.
2. Inserisci il **URL del server**, **Porta**, e **Directory** percorso del file di modifiche batch sul tuo server FTP. Inserisci il **Nome utente** e **Password** che impact.com userà per connettersi al tuo server FTP.
3. Seleziona **Salva** e continua.
4. Carica il tuo file di modifiche batch 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.

</details>

<details>

<summary>Invia il file via email al server SMTP del sistema</summary>

1. Seleziona **Invia il file via email al server SMTP del sistema**, quindi copia il tuo indirizzo email univoco.
2. Usando qualsiasi client di posta elettronica, invia un'email all'indirizzo univoco con il tuo file di modifiche batch in 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.
3. Puoi lasciare vuoti il campo oggetto e il corpo del messaggio.

</details>

#### Passo 3: Revisiona l'invio del file

Una volta inviato il tuo file .CSV o .XML a impact.com, puoi verificare 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 alla *Tecnico* sezione e seleziona [**Invii file**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. Usa la tabella per rivedere gli invii di file recenti che impact.com ha ricevuto, incluso lo stato di elaborazione attuale.

   * I file inviati appariranno entro 10-15 minuti dall'invio, mentre gli aggiornamenti di reportistica generale possono richiedere 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.

   | Problema                                                  | Azione da intraprendere                                                                                                                                                                                                                                                                              |
   | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | La colonna Record mostra 0                                | Assicurati che l'estensione del file sia .CSV o .XML.                                                                                                                                                                                                                                                |
   | `NO_CHANGE`                                               | Non è stata effettuata alcuna modifica all'azione. Assicurati di inserire l'importo finale nella *Importo* colonna (es., inserisci 0 se vuoi revocare le azioni).                                                                                                                                    |
   | `BAD_DISPOSITION`                                         | <p>Il codice motivo che hai fornito non è valido. Utilizza uno dei <a href="batch-modifications-and-reversals-reference">codici motivo</a>.</p><p>In alternativa, puoi impostare un <a href="../../tracking/set-up-tracking/manage-disposition-codes">codice di disposizione personalizzato</a>.</p> |
   | `ALREADY_LOCKED`                                          | Il periodo di blocco dell'azione è già scaduto. L'azione non può più essere modificata o revocata.                                                                                                                                                                                                   |
   | `ActionTrackerId: il valore ActionTrackerId non è valido` | Questo dovrebbe corrispondere all' [ID del Tipo di Evento](https://help.impact.com/brand/it/su-cosa-vorresti-saperne-di-piu/platform-features/event-types/how-do-i-find-my-event-type-ids) inserito.                                                                                                 |
   | `ACTION_NOT_FOUND`                                        | L' `OID` che hai fornito è errato. Fornisci un `OID`.                                                                                                                                                                                                                                                |
   | `ALREADY_REVERSED`                                        | L'azione è già stata revocata.                                                                                                                                                                                                                                                                       |
   | `ALREADY_APPROVED`                                        | L'azione è già stata approvata.                                                                                                                                                                                                                                                                      |
