# Invia modifiche e inversioni 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 una revoca. Questo garantisce che il partner venga pagato correttamente al termine del periodo di blocco.

Le azioni vengono solitamente 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 o [tramite API](https://integrations.impact.com/impact-brand/reference/actions-overview), o tramite un server FTP/SMTP come descritto di seguito. Il modello di cui hai bisogno per le sottomissioni 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 usare, 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 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 alla più recente *ActionId*. Per sovrascrivere questo comportamento, specifica la *ActionId*.
* **Usa correttamente Amount per le revoche** — Per revocare un'azione, puoi impostare *Amount = 0*. Tuttavia, se l'originale *Amount = 0*, lasciandolo a 0 verrà registrato come una modifica e l'azione non sarà revocata.

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

Per un elenco completo dei campi che puoi usare nell'elaborazione batch FTP/SMTP, vedi [Riferimento Modifiche & Revoche in Batch](https://help.impact.com/brand/it/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference).

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

   * Se stai usando un editor di testo, usa le virgole per separare ogni punto dati.
   * Se stai usando 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 normale" 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 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 in alto, 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**.
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 correlati a FTP o SMTP per inviare il tuo file:

<details>

<summary>Carica 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 file dal tuo server FTP</summary>

1. Seleziona **Preleva file dal tuo server FTP**.
2. Inserisci il **URL del server**, **Porta**, e **Directory** percorso al file delle modifiche in batch sul tuo server FTP. Inserisci la **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 in 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 richiedere fino a 24 ore per essere elaborato dopo il caricamento.

</details>

<details>

<summary>Invia file al server SMTP di sistema</summary>

1. Seleziona **Invia file al server SMTP di 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 in batch come allegato.
   * Includi solo l'indirizzo email univoco per il tipo di evento nel *A:* campo. Se devi inviare questo file ad altri, includili in *CC:* campo.
3. Puoi lasciare vuoti il campo oggetto e il corpo del messaggio.

</details>

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

Una volta che hai inviato il tuo file .CSV o .XML a impact.com, puoi controllarne lo stato per vedere se è stato elaborato.

1. Dalla barra di navigazione in alto, 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 **Submission di file**.
3. Usa la tabella per revisionare gli invii di file recenti che impact.com ha ricevuto, inclusa l'attuale stato di elaborazione.

   * I file inviati appariranno entro 10-15 minuti dall'invio, mentre gli aggiornamenti dei report generali possono richiedere 2+ ore.
   * Di seguito sono riportati vari problemi che potresti incontrare durante la revisione degli invii di file e le azioni che puoi intraprendere per correggerli.

   | Problema                                                  | Azione da intraprendere                                                                                                                                                                                                                                                                 |
   | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | La colonna Records 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 colonna *Importo* (ad es., inserisci 0 se vuoi revocare le azioni).                                                                                                                     |
   | `BAD_DISPOSITION`                                         | <p>Il codice motivo fornito non è valido. Usa 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à passato. L'azione non può più subire modifiche o revoche.                                                                                                                                                                                        |
   | `ActionTrackerId: il valore ActionTrackerId non è valido` | Questo dovrebbe corrispondere al [ID tipo evento](https://help.impact.com/brand/it/platform-features/event-types/how-do-i-find-my-event-type-ids) inserito.                                                                                                                             |
   | `ACTION_NOT_FOUND`                                        | Il `OID` che hai fornito è errato. Fornisci un `OID`.                                                                                                                                                                                                                                   |
   | `ALREADY_REVERSED`                                        | L'azione è già stata revocata.                                                                                                                                                                                                                                                          |
   | `ALREADY_APPROVED`                                        | L'azione è già stata approvata.                                                                                                                                                                                                                                                         |
