> 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 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 aver bisogno di [inviare 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. L'invio di questi dati ti assicura di attribuire il credito ai partner giusti, mantenere accurata la tua reportistica e, facoltativamente, 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](/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](/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 tuo 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 *articolo* (cioè includendo l'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 [azioni concatenate](/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:** Ti 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 intervallo. Le conversioni fino a 398 giorni di età possono essere elaborate, ma solo se l'attribuzione viene eseguita utilizzando `MediaId`.
{% endhint %}
1. Seleziona uno dei link qui sotto per visualizzare il modello di file .csv corrispondente al livello a cui tracci le azioni.
* [Modello di dati azioni/conversione a livello articolo](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/item-level-template)
* [Modello di dati azioni/conversione a livello ordine](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/order-level-template)
* [Modello di dati conversione per azioni concatenate](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/chained-actions-template)
2. Aggiungi i tuoi dati di conversione al file.
* Vedi il [Riferimento dati azioni e conversioni di impact.com](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references) documentazione per esempi e usa questo file come riferimento per i parametri accettati. Contatta il tuo CSM per sapere quali parametri sarebbe meglio includere nel tuo modello di dati di conversione.
3. Aggiungi eventuali parametri opzionali che vuoi segnalare come nuove colonne nel tuo file.
4. Salva il tuo file in formato .CSV con un titolo e una data facilmente identificabili (ad es., `2020-01-01_ActionData.csv`).
{% hint style="success" %}
**Nota:** Per i file batch a livello articolo, gli ID ordine che hanno più SKU associati devono essere elencati in modo consecutivo. Assicurati che le righe 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 metodo di invio
Puoi formattare e inviare i tuoi dati tramite FTP/SFTP o email. Usa il metodo che funziona meglio per ciò che vuoi ottenere.
| If you want to... | Use this method... |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Submit a manual, one-time file with no coding | [Email](/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](/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](/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](/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 tuo file di dati
1. Dalla barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. Nella colonna di 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 batch.
4. Accanto a *Elaborazione dei resi*, seleziona  **\[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:
Carica il file sul server FTP del sistema
{% hint style="info" %}
Ti consigliamo di dividere 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 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, sensibile alle maiuscole e minuscole.) | (Il tuo nome utente SFTP di impact.com, sensibile alle maiuscole e minuscole.) |
| **Password** | (La tua password FTP di impact.com, sensibile alle maiuscole e minuscole.) | (La tua password SFTP di impact.com, sensibile alle 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).
Scarica il file dal tuo server FTP
{% hint style="info" %}
Ti consigliamo di dividere i file FTP/SFTP per mantenere il numero massimo di voci per file sotto 10.000.
{% endhint %}
1. Seleziona **Scarica il file dal tuo server FTP**.
2. Inserisci il **URL del server**, **Porta**, e **Directory** percorso 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 nel *Directory* che hai specificato sopra.
* impact.com tenta di connettersi e scaricare file dal tuo server FTP ogni 24 ore, quindi il tuo file potrebbe richiedere fino a 24 ore per essere elaborato dopo il caricamento.
Invia il file via email al server SMTP del sistema
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 anche ad altri, includili nel campo *CC:* .
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):
{% endstep %}
{% step %}
### Rivedi l'invio del tuo file
1. Dalla barra di navigazione superiore, seleziona  **\[Profilo utente] →** **Impostazioni**.
2. Nella colonna di sinistra, sotto *Tecnico* sezione, seleziona [**Invio file**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. Usa la tabella per rivedere i recenti invii di file ricevuti da impact.com, incluso lo stato di elaborazione attuale.
* Di seguito, puoi visualizzare vari errori che potresti incontrare durante la revisione degli invii di file e le azioni che puoi intraprendere per correggerli.
Submission troubleshooting reference
| 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` | The reason code you provided is not valid. Please use one of the standard reason codes.
Alternatively, you can set up a custom disposition code.
|
| `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](/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. |
{% 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=&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.
