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

Puoi usare l'elaborazione in batch per inviare direttamente a impact.com i dati di conversione, 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 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 inserisce il codice promozionale di un partner. L'invio di questi dati garantisce che tu attribuisca il credito ai partner giusti, mantenga accurata la reportistica e, facoltativamente, modifichi o annulli le azioni prima che si blocchino.

* 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 fornitoti dal nostro team di Servizi tecnici.
* Se hai *Connessioni* è attivato per il tuo account, la configurazione di una pipeline di dati di conversione per te sarà diversa. 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 tuo file 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* (ovvero includendo lo SKU, la quantità, ecc. di ogni articolo in un ordine) oppure a livello di *a livello di ordine* (ovvero tracciando solo gli ordini stessi, non gli articoli al loro interno). Puoi anche inviare [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) dati.

{% hint style="warning" %}
**Avvertenza:** Raccomandiamo 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 eseguita 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 di azioni/conversioni a livello di articolo](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references/item-level-template)
   * [Modello di dati di azioni/conversioni a livello di ordine](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references/order-level-template)
   * [Modello di dati di conversione per azioni concatenate](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references/chained-actions-template)
2. Aggiungi al file i dati di conversione.
   * Vedi il [Riferimento ai dati di azioni e conversioni di impact.com](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) documentazione 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 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 in modo consecutivo. Assicurati che gli elementi con lo stesso ID ordine e SKU diversi siano raggruppati 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 più adatto a ciò che vuoi ottenere.

| Se vuoi...                                                | Usa questo metodo...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Invia un file manuale, una tantum, senza codice           | ​[Email](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#email-file-to-system-smtp-server) elaborazione in batch o [carica file tramite 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#upload-file-to-system-ftp-server)                                                                                                                |
| Configura la reportistica automatizzata delle conversioni | ​[Conversioni](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) API, [invia file tramite 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#upload-file-to-system-ftp-server), oppure [recupera file tramite 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#pull-file-from-your-own-ftp-server) |
| {% endstep %}                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

{% step %}

### Invia il tuo file dati

1. Dalla barra di navigazione superiore, seleziona ![](/files/9cd266a8f48956f16b756268ec5df533881606b9) **\[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 il quale desideri inviare modifiche in 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 file:

<details>

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

{% hint style="info" %}
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 per 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 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" %}
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 **Directory** percorso del file delle modifiche in batch sul tuo server FTP. Inserisci il **Nome utente** e **Password** che impact.com userà 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 file potrebbe richiedere fino a 24 ore per essere elaborato dopo il caricamento.

</details>

<details>

<summary>Invia il file al server SMTP del sistema</summary>

1. Seleziona **Invia il file al server SMTP del sistema.**
2. Ti verrà fornito un indirizzo email univoco subito sotto al metodo selezionato. Copia questo indirizzo email.
3. Usando qualsiasi client email, 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 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 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 %}

### Controlla l'invio del file

1. Dalla barra di navigazione superiore, seleziona ![](/files/c0279a0e9c22a5b78cc1bbb3be84cac24b0fd825) **\[Profilo utente] →** **Impostazioni**.
2. Nella colonna 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.

<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 *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.                                                                        |
| `ActionTrackerId: valore ActionTrackerId 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.
