> 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 in 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 ti affidi ai cookie. Potresti anche dover [inviare i dati di conversione retroattivamente](/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 alcuni casi, ad esempio quando un cliente non utilizza il codice promozionale di un partner. Inviare questi dati garantisce che tu attribuisca il credito ai partner giusti, mantenga accurata la reportistica e, facoltativamente, modifichi o annulli le azioni prima che vengano bloccate.

* Se hai bisogno di aiuto per raccogliere dati di conversione con un 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* attivato per il tuo account, la configurazione di una pipeline di dati di conversione avrà un aspetto diverso 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 le azioni dell'app mobile sono diversi. Vedi [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 dell'app mobile.

{% stepper %}
{% step %}

### Prepara il file di 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 *a livello di articolo* (vale a dire includendo l'SKU, la quantità, ecc. di ogni articolo in un ordine) oppure a livello di *a livello di ordine* (vale a dire tracciando solo gli ordini stessi, non gli articoli al loro interno). Puoi anche inviare [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) dati.

{% hint style="warning" %}
**Avviso:** Ti consigliamo vivamente di non inviare azioni più vecchie di 88 giorni, poiché attualmente impact.com non elabora le conversioni inviate via FTP con date evento oltre tale intervallo. Le conversioni fino a 398 giorni di età 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 di dati Azioni/Conversioni a livello di articolo](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/item-level-template)
   * [Modello di dati Azioni/Conversioni a livello di ordine](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/order-level-template)
   * [Modello di dati Conversioni per 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.
   * Vedi il [Riferimento ai dati di azioni e conversioni di impact.com](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references) documentazione per gli 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 facilmente identificabile e una data (ad es., `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 voci con lo stesso ID ordine e SKU diversi siano raggruppate insieme, altrimenti potresti ricevere un `OID_DUPLICATE` errore per gli SKU elencati più avanti nel file.
{% endhint %}
{% endstep %}

{% step %}

### Scegli il tuo metodo di invio

Puoi formattare e inviare i tuoi dati tramite FTP/SFTP o email. Usa il metodo che meglio si adatta 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 | ​[Conversions API](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), oppure [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 file dei dati

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:

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

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

</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 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):

<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%2FbTqEWPIFtSUGlMvxsfbw%2FScreenshot_2026-03-27_at_8_36_19%E2%80%AFAM.png?alt=media&amp;token=eeaa8a95-fe91-427a-9db7-7b55def0db1b" alt="" width="446"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

### Rivedi l'invio del file

1. Dalla barra di navigazione superiore, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Profilo utente] →** **Impostazioni**.
2. Nella colonna di sinistra, sotto *Tecnico* sezione, 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 di file recenti ricevuti da impact.com, incluso l'attuale stato di 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 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).      |
| `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 a [ID 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`                                       | Il `OID` che hai 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.
