> 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/submit-conversion-data/batch-submit-conversion-data.md).

# Invia dati di conversione in batch

Puoi usare l'elaborazione batch per inviare i dati di conversione direttamente a impact.com se i tuoi dati di conversione non vengono tracciati automaticamente, sia che tu li raccolga lato server sia che tu faccia affidamento sui cookie. Potresti anche dover [inviare retroattivamente i dati di conversione](/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) in certi momenti, ad esempio quando un cliente non inserisce il codice promo di un partner. L'invio di questi dati assicura che tu attribuisca il credito ai partner corretti, mantenga accurati i tuoi report e, facoltativamente, modifichi o annulli le azioni prima che vengano bloccate.

* Se hai bisogno di aiuto per raccogliere i dati di conversione con il tracciamento non basato su pixel, contatta il tuo CSM o [contatta l'assistenza](https://app.impact.com/support/portal.ihtml?createTicket=true). Per saperne di più sul tuo metodo di tracciamento e sull'integrazione, ti consigliamo di consultare il Piano di integrazione tecnica originale fornito dal nostro team di Servizi tecnici.
* Se hai *Connessioni* attivate per il tuo account, la configurazione di una pipeline di dati di conversione sarà diversa per te. Scopri come [creare una Connessione](/brand/it/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/data-connections-overview.md).
* I parametri richiesti per le azioni web e per le azioni dell'app mobile sono diversi. Consulta [Parametri specifici per dispositivi mobili](/brand/it/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/mobile-specific-parameters-for-ftp-or-email-conversion-reporting.md) per ulteriori informazioni sull'invio delle conversioni delle app mobili.

{% stepper %}
{% step %}

### Prepara il file dei dati

Segui le istruzioni qui sotto per visualizzare un file modello, aggiungere i tuoi dati di conversione e salvarlo in formato .csv. Il modello di cui hai bisogno dipende dal fatto che tu stia tracciando le conversioni a livello di *articolo* (cioè includendo lo SKU, la quantità, ecc. di ciascun articolo in un ordine) oppure a livello di *ordine* (cioè tracciando solo gli ordini stessi, non gli articoli al loro interno). Puoi anche inviare dati di [azione concatenata](/brand/it/what-would-you-like-to-learn-about/platform-features/actions-and-payouts/actions/track-your-conversion-funnel-using-chained-actions.md) .

{% hint style="warning" %}
**Attenzione:** Consigliamo vivamente di non inviare azioni più vecchie di 88 giorni, poiché impact.com al momento non elabora le conversioni inviate tramite FTP con date evento oltre tale finestra. Le conversioni fino a 398 giorni possono essere elaborate, ma solo se l'attribuzione viene effettuata usando `MediaId`.
{% endhint %}

1. Seleziona uno dei link qui sotto per visualizzare il modello di file .csv che corrisponde al livello a cui tracci le azioni.
   * [Modello dati azione/conversione a livello di articolo](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/item-level-template)
   * [Modello dati azione/conversione a livello di ordine](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/order-level-template)
   * [Modello dati conversione azioni concatenate](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/chained-actions-template)
2. Aggiungi al file i tuoi dati di conversione.
   * Consulta il [riferimento per i dati di azione e conversione di impact.com](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references) per esempi e usa questo file come riferimento per i parametri accettati. Rivolgiti al tuo CSM per scoprire quali parametri sarebbe meglio includere nel tuo modello di dati di conversione.
3. Aggiungi eventuali parametri opzionali che desideri segnalare come nuove colonne nel file.
4. Salva il file in formato .CSV con un titolo e una data facilmente identificabili (ad esempio, `2020-01-01_ActionData.csv`).

{% hint style="success" %}
**Nota:** Per i file batch a livello di articolo, gli ID ordine che hanno più SKU associati devono essere elencati consecutivamente. Assicurati che le righe con lo stesso ID ordine e SKU diversi siano raggruppate insieme, altrimenti potresti ricevere un errore `OID_DUPLICATE` per gli SKU elencati più avanti nel file.
{% endhint %}
{% endstep %}

{% step %}

### Scegli il metodo di invio

Puoi formattare e inviare i tuoi dati tramite FTP/SFTP o email. Usa il metodo più adatto a ciò che vuoi ottenere.

| 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) elaborazione in batch o [carica file tramite FTP](/brand/it/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md)                                                                                                                              |
| Configura la reportistica automatizzata delle conversioni | [API di conversioni](https://integrations.impact.com/integration-guides/for-brands/tracking-integrations/api-online-sale/implementation), [invia file tramite FTP](/brand/it/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md), o [recupera file tramite FTP](/brand/it/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md) |
| {% endstep %}                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

{% step %}

### Invia il tuo file di dati

1. Dalla barra di navigazione in alto, seleziona ![](/files/9cd266a8f48956f16b756268ec5df533881606b9) **\[Profilo utente] → Impostazioni**.
2. Nella colonna destra, sotto *Monitoraggio*, 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 vuoi inviare modifiche batch.
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:

<details>

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

{% hint style="info" %}
Ti 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 via email nome utente e password FTP** e **Salva**.
3. Una volta ricevute via email le 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 impact.com, con distinzione tra maiuscole e minuscole.) | (Il tuo nome utente SFTP impact.com, con distinzione tra maiuscole e minuscole.) |
   | **Password**    | (La tua password FTP impact.com, con distinzione tra maiuscole e minuscole.)    | (La tua password SFTP 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).

</details>

<details>

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

{% hint style="info" %}
Ti 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 il **percorso della** directory del file delle modifiche batch 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 *percorso della* che hai specificato sopra.
   * impact.com tenta di connettersi e scaricare file dal tuo server FTP ogni 24 ore, quindi l'elaborazione del tuo file dopo il caricamento può richiedere fino a 24 ore.

</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.**
2. Ti verrà fornito un indirizzo email univoco subito sotto il metodo selezionato. Copia questo indirizzo email.
3. Usando qualsiasi client email, invia un'email all'indirizzo univoco con il file delle modifiche batch come allegato.
   * Includi solo l'indirizzo email univoco per il tipo di evento nel campo *A:* . Se devi inviare questo file ad altre persone, includile nel campo *CC:* .
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):

<div data-with-frame="true"><figure><img src="/files/c81361965d23bde2d310533504879ef757dfdb28" alt="" width="446"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

### Rivedi l'invio del file

1. Dalla barra di navigazione in alto, seleziona ![](/files/c0279a0e9c22a5b78cc1bbb3be84cac24b0fd825) **\[Profilo utente] →** **Impostazioni**.
2. Nella colonna sinistra, sotto la *sezione* Tecnica [**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 di file ricevuti da impact.com, incluso lo stato attuale dell'elaborazione.
   * Di seguito puoi visualizzare vari errori che potresti incontrare durante la revisione degli invii di file e le azioni che puoi intraprendere per correggerli.

<details>

<summary>Riferimento per la risoluzione dei problemi di invio</summary>

| 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 esempio, inserisci 0 se vuoi annullare le azioni).            |
| `ALREADY_LOCKED`                                   | Il periodo di blocco dell'azione è già trascorso. L'azione non può più essere modificata o annullata.                                                                               |
| `ActionTrackerld:ActionTrackerld value is invalid` | Questo dovrebbe corrispondere all' [ID del tipo di 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`                                 | L' `OID` fornito non è corretto. Fornisci un `OID`.                                                                                                                                 |
| `ALREADY_REVERSED`                                 | L'azione è già stata annullata.                                                                                                                                                     |
| `ALREADY_APPROVED`                                 | L'azione è già stata approvata.                                                                                                                                                     |

</details>
{% 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/submit-conversion-data/batch-submit-conversion-data.md?ask=<question>&goal=<endgoal>
```

`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.
