> 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 in batch i dati di conversione

Puoi usare l’elaborazione batch per inviare i dati di conversione direttamente a impact.com se non vengono tracciati automaticamente, sia che tu li raccolga lato server o ti affidi ai cookie. Potresti anche dover [inviare retroattivamente i dati di conversione](https://help.impact.com/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. L’invio di questi dati ti consente di attribuire il merito ai partner corretti, mantenere accurati i report e, se necessario, modificare o annullare le azioni prima che vengano bloccate.

* If you need help collecting conversion data with non-pixel tracking, reach out to your CSM or [contact support](https://app.impact.com/support/portal.ihtml?createTicket=true). To learn more about your tracking method and integration, we recommend consulting the original Technical Integration Plan provided to you by our Technical Services team.
* If you have *Connections* turned on for your account, setting up a conversion data pipeline will look different for you. Learn how to [create a Connection](https://help.impact.com/brand/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/data-connections-overview.md).
* The required parameters for web actions and mobile app actions are different. See [Mobile-Specific Parameters](https://help.impact.com/brand/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) for more information on submitting mobile app conversions.

{% stepper %}
{% step %}

### Prepara il file di dati

Segui le istruzioni riportate di seguito per visualizzare un file modello, aggiungervi i dati di conversione e salvarlo in formato .csv. Il modello necessario dipende dal fatto che tu monitori le conversioni a *livello di articolo* (ovvero includendo lo SKU, la quantità e così via di ciascun articolo di un ordine) oppure a *livello di ordine* (ovvero monitorando solo gli ordini, non i singoli articoli che li compongono). Puoi anche inviare dati di [azioni concatenate](https://help.impact.com/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" %}
**Avviso:** Ti consigliamo vivamente di non inviare azioni con più di 88 giorni, poiché attualmente impact.com non elabora le conversioni inviate tramite FTP con date evento che superano tale intervallo. È possibile elaborare conversioni fino a 398 giorni, ma solo se l’attribuzione viene eseguita usando `MediaId`.
{% endhint %}

1. Seleziona uno dei link seguenti per visualizzare il modello di file .csv corrispondente al livello a cui monitori le azioni.
   * [Modello di dati di 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 di 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 di conversione per azioni concatenate](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/chained-actions-template)
2. Aggiungi i dati di conversione al file.
   * Consulta il [riferimento ai dati di azioni e conversioni di impact.com](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references) per alcuni esempi e usa questo file come riferimento per i parametri accettati. Contatta il tuo CSM per scoprire quali parametri è meglio includere nel modello dei dati di conversione.
3. Aggiungi eventuali parametri facoltativi da includere nei report come nuove colonne del file.
4. Salva il file in formato .CSV, assegnandogli un titolo e una data facilmente riconoscibili (ad es., `2020-01-01_ActionData.csv`).

{% hint style="success" %}
**Nota:** Nei file batch a livello di articolo, gli ID ordine associati a più SKU devono essere elencati in sequenza. Assicurati che le righe degli articoli con lo stesso ID ordine e SKU diversi siano raggruppate, 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 dati tramite FTP/SFTP o email. Scegli il metodo più adatto al risultato che vuoi ottenere.

| If you want to...                             | Use this method...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Submit a manual, one-time file with no coding | ​[Email](https://help.impact.com/brand/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) batch processing or [upload file via FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md)​                                                                                                                       |
| Set up automated conversion reporting         | ​[Conversions API](https://integrations.impact.com/integration-guides/for-brands/tracking-integrations/api-online-sale/implementation), [push file via FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md), or [pull file via FTP​](https://help.impact.com/brand/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 di dati

1. Nella 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 a 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 cui vuoi inviare modifiche in batch.
4. Accanto a *Elaborazione 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 l’elaborazione dei resi (avanzato)**.
6. Scegli uno dei seguenti metodi tramite FTP o email per inviare il file:

<details>

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

{% hint style="info" %}
Ti consigliamo di suddividere i file FTP/SFTP in modo che ciascun file contenga al massimo 10.000 voci.
{% endhint %}

1. Seleziona **Carica il file sul server FTP del sistema.**
2. Seleziona **Invia nome utente e password FTP via email** e **Salva**.
3. Dopo aver ricevuto 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, che distingue tra maiuscole e minuscole.) | (Il tuo nome utente SFTP di impact.com, che distingue tra maiuscole e minuscole.) |
   | **Password**    | (La tua password FTP di impact.com, che distingue tra maiuscole e minuscole.)    | (La tua password SFTP di impact.com, che distingue tra maiuscole e minuscole.)    |
4. Una volta connesso, carica il 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>Preleva il file dal tuo server FTP</summary>

{% hint style="info" %}
Ti consigliamo di suddividere i file FTP/SFTP in modo che ciascun file contenga al massimo 10.000 voci.
{% endhint %}

1. Seleziona **Preleva il file dal tuo server FTP**.
2. Inserisci l' **URL del server**, **Porta** e **Directory** e il percorso del file di modifiche in batch sul tuo server FTP. Inserisci il **Nome utente** e la **Password** che impact.com userà per connettersi al tuo server FTP.
3. Seleziona **Salva** e continua.
4. Carica il file nella *directory* specificata sopra.
   * impact.com tenta di connettersi al tuo server FTP e scaricare i file ogni 24 ore, quindi l'elaborazione del file potrebbe richiedere fino a 24 ore dal caricamento.

</details>

<details>

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

1. Seleziona **Invia il file al server SMTP di sistema via email.**
2. Sotto il metodo selezionato ti verrà fornito un indirizzo email univoco. Copia questo indirizzo email.
3. Usando un qualsiasi client di posta, invia un'email all'indirizzo univoco allegando il file di modifiche in batch.
   * Inserisci solo l'indirizzo email univoco per il tipo di evento nel campo *A:* . Se devi inviare il file ad altri, aggiungili nel campo *CC:* .
4. Puoi lasciare vuoti il campo dell'oggetto e il corpo del messaggio.
   * Di seguito trovi un esempio dell'indirizzo email (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 %}

### Verifica l'invio del file

1. Nella 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 a sinistra, sotto la sezione *Tecnica* , seleziona [**Invio di file**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. Usa la tabella per esaminare gli invii di file recenti ricevuti da impact.com, incluso lo stato di elaborazione corrente.
   * Di seguito puoi consultare i vari errori che potresti riscontrare durante l’esame degli invii di file e le azioni che puoi intraprendere per risolverli.

<details>

<summary>Submission troubleshooting reference</summary>

| Issue                                              | Action to take                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Records column shows 0                             | Make sure the file extension is . CSV or .XML.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `NO_CHANGE`                                        | There is no change made to the action. Please ensure you enter the final amount into the *Amount* column (e.g., enter 0 if you want to reverse actions).                                                                                                                                                                                                                                                                                                                                                                           |
| `BAD_DISPOSITION`                                  | <p>The reason code you provided is not valid. Please use one of the standard <a href="https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md">reason codes</a>.</p><p>Alternatively, you can set up a <a href="https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">custom disposition code</a>.</p> |
| `ALREADY_LOCKED`                                   | The action locking period has already passed. The action can no longer undergo modifications or reversals.                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `ActionTrackerld:ActionTrackerld value is invalid` | This should correspond to the [Event Type ID](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md) entered.                                                                                                                                                                                                                                                                                                                                          |
| `ACTION_NOT_FOUND`                                 | The `OID` you provided is incorrect. Please provide a correct `OID`.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `ALREADY_REVERSED`                                 | The action has already been reversed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `ALREADY_APPROVED`                                 | The action has already been approved.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
