# Invia dati di conversione via FTP o email

<a href="https://pxa.impact.com/student/activity/1117597?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=tra-350&#x26;utm_campaign=help-center" class="button primary">Segui il corso PXA</a>

Se stai raccogliendo dati di conversione (cioè azioni) lato server o tramite cookie, dovrai inviare i tuoi dati a impact.com in modo da poter visualizzare le prestazioni del tuo programma, attribuire credito ai partner e modificare o annullare eventuali azioni prima che vengano bloccate.

Questo documento ti guida attraverso la formattazione e l'invio dei tuoi dati di conversione e presuppone che tu abbia già iniziato a raccogliere dati.

#### Prima di iniziare

* Se hai bisogno di aiuto per raccogliere dati di conversione con tracciamento non basato su pixel, contatta il tuo CSM o [contatta il supporto](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 Technical Services.
* 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](https://help.impact.com/brand/it/account-administration/account-settings/send-data-to-impactcom/data-connections-overview).
* I parametri richiesti per le azioni web e le azioni delle app mobili sono diversi. Vedi [Parametri specifici per mobile](https://help.impact.com/brand/it/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/mobile-specific-parameters-for-ftp-or-email-conversion-reporting) per maggiori informazioni sull'invio delle conversioni delle app mobili.

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

#### Fase 1: Prepara i tuoi dati

Segui le istruzioni qui sotto per visualizzare un file modello, inserire 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 SKU, quantità, ecc. di ciascun articolo in un ordine) o a livello *dell'ordine* (cioè tracciando solo gli ordini stessi, non gli articoli al loro interno). Puoi anche inviare [dati di azioni concatenate](https://help.impact.com/brand/it/platform-features/actions-and-payouts/actions/track-your-conversion-funnel-using-chained-actions) .

1. Seleziona uno dei link qui sotto per visualizzare il file .csv modello che corrisponde al livello a cui tracci le azioni.
   * [Modello dati/azioni a livello di articolo](https://integrations.impact.com/impact-brand/docs/item-level-data#item-level-template)
   * [Modello dati/azioni a livello di ordine](https://integrations.impact.com/impact-brand/docs/order-level-data#order-level-template)
   * [Modello dati conversioni per azioni concatenate](https://integrations.impact.com/impact-brand/docs/chained-actions#chained-actions-template)
2. Aggiungi i tuoi dati di conversione al file.
   * Vedi il [documento di riferimento sulle Azioni e i Dati di Conversione di impact.com](https://integrations.impact.com/impact-brand/docs/impactcom-action-conversion-data-references) per esempi e usa questo file come riferimento per i parametri accettati. Contatta il tuo CSM per scoprire 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 file in formato .CSV con un titolo e una data facilmente identificabili (ad es., `2020-01-01_ActionData.csv`).

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Nota:</strong> Per i file batch a livello di articolo, gli ID ordine che hanno più SKU associati devono essere elencati consecutivamente. Non raggruppare insieme le righe con lo stesso ID ordine e SKU diversi comporterà un <code>OID_DUPLICATE</code> errore per gli SKU elencati più avanti nel file.</p></div>

#### Fase 2: Invia il tuo file dati

{% tabs %}
{% tab title="Carica tramite FTP/SFTP" %}

* Consigliamo di dividere i file FTP/SFTP per mantenere il numero massimo di voci per file sotto 10000.
* Per inviare un file al server FTP/SFTP di impact.com, dovrai prima recuperare le credenziali dell'account. Segui le istruzioni qui sotto per sapere come farti inviare le credenziali esistenti via email.

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-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Profilo utente] →** **Impostazioni**.
2. Nella colonna di destra, sotto *Tracciamento*, seleziona **Tipi di evento**.
3. Passa il mouse sul tipo di evento per il quale desideri inviare i dati di tracciamento delle azioni lato server, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[Altro]** a destra, e seleziona **Visualizza / Modifica**.
4. Accanto a *Elaborazione resi*, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Modifica]**.
5. Seleziona **Automatizza l'elaborazione dei resi (avanzato) → Carica file sul server FTP di sistema**.
6. Seleziona **Invia via email nome utente e password FTP** e **Salva**.

   * Una volta ricevute le credenziali FTP/SFTP, utilizza un client FTP/SFTP 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 sensibile alle maiuscole.) | (Il tuo nome utente SFTP impact.com sensibile alle maiuscole.) |
   | **Password**    | (La tua password FTP impact.com sensibile alle maiuscole.)    | (La tua password SFTP impact.com sensibile alle maiuscole.)    |
7. Una volta connesso, carica il tuo file nella directory principale del server. Dopo un upload riuscito, vai alla **Fase 3: Rivedi l'invio del file** sezione qui sotto.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Nota:</strong> Se non hai ricevuto l'email con le credenziali FTP/SFTP, contatta la persona che ha creato il tuo account impact.com. In alternativa, <a href="https://app.impact.com/secure/mediapartner/support/customer-support-portal-flow.ihtml">contatta il supporto</a>.</p></div>

{% endtab %}

{% tab title="Estrai il file tramite FTP/SFTP" %}

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-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Profilo utente] →** **Impostazioni**.
2. Nella colonna di destra, sotto *Tracciamento*, seleziona **Tipi di evento**.
3. Passa il mouse sul tipo di evento per il quale desideri inviare i dati di tracciamento delle azioni lato server, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[Altro]** a destra, e seleziona **Visualizza / Modifica**.
4. Accanto a *Elaborazione resi*, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Modifica]**.
5. Seleziona **Estrai il file dal tuo server FTP**.
6. Inserisci il **URL del server**, **Porta**e il percorso della directory del file dei dati di azione sul tuo server FTP/SFTP/FTPS. Inserisci il **Nome utente** e **Password** che impact.com userà per connettersi al tuo server FTP/SFTP/FTPS.
7. Seleziona **Salva** e continua.
8. Carica il tuo file di dati di azione nella directory che hai specificato sopra (punto 6). impact.com tenta di connettersi e scaricare file dal tuo server FTP/SFTP/FTPS ogni 24 ore. Attendi almeno 24 ore affinché impact.com scarichi il tuo file.
   {% endtab %}

{% tab title="Allega il file tramite email" %}

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-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Profilo utente] →** **Impostazioni**.
2. Nella colonna di destra, sotto *Tracciamento*, seleziona **Tipi di evento**.
3. Passa il mouse sul tipo di evento per il quale desideri inviare i dati di tracciamento delle azioni lato server, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[Altro]** a destra, e seleziona **Visualizza / Modifica**.
4. Accanto a *Elaborazione resi*, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Modifica]**.
5. Seleziona **Invia il file via email al server SMTP di sistema**, quindi copia il tuo indirizzo email univoco.
6. Usando qualsiasi client di posta elettronica, invia un'email all'indirizzo univoco con il tuo file di dati di azione come allegato. (Includi solo **l'indirizzo email univoco per il tipo di evento** nella *A:* campo. Se hai bisogno di inviare questo file ad altri, includili in *CC:* riga.)

   Puoi lasciare il campo oggetto e il corpo del messaggio vuoti.
   {% endtab %}
   {% endtabs %}

#### Fase 3: 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%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Profilo utente] →** **Impostazioni**.
2. Nella colonna di sinistra, sotto la *sezione Tecnica* , seleziona **Invii file**.
3. Usa la tabella per rivedere gli invii di file recenti ricevuti da impact.com, inclusi 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>Errori durante la revisione degli invii di file</summary>

Alcuni errori comuni durante la revisione dell'invio di file possono includere:

| Problema                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Azione da intraprendere                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La colonna Records mostra 0                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Assicurati che l'estensione del file sia .CSV o .XML.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `ActionTrackerId: Valore non valido`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>Il <code>ActionTrackerId</code> non appartiene al <code>Tipo di evento</code> inviato.</p><p>1. Vai a <img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media" alt=""> <strong>\[Profilo utente] → Impostazioni → Tracciamento</strong>.</p><p>2. Seleziona <strong>Tipi di evento</strong> e verifica il corretto <code>Tipo di evento</code>.</p>       |
| <p><code>NO\_REFERRERS\_FOUND</code> oppure è richiesto uno dei seguenti parametri:</p><p>• <code>ClickId</code></p><p>• <code>CustomerId</code></p><p>• <code>CustomProfileId</code></p><p>• <code>CustomClickId</code></p><p>• <code>OrderPromoCode</code></p><p>• <code>MediaPartnerId</code></p><p>• <code>UniqueUrl</code></p><p>• <code>CallerId</code></p><p>• <code>GoogAId</code></p><p>• <code>AndroidId</code></p><p>• <code>AppleIfa</code></p><p>• <code>AppleIfv</code></p><p>• <code>WinId</code></p><p>• <code>PhoneNumber</code></p><p>• <code>Odin1</code></p><p>• <code>DeviceId</code></p><p>• <code>OpenUdId</code></p><p>• <code>Mac</code></p><p>• <code>MacMd5</code> è richiesto</p> | <p>Non hai fornito alcun parametro relativo all'attribuzione.</p><p>Fornisci almeno un parametro di attribuzione, in modo che il sistema possa identificare quale partner a cui attribuire.</p>                                                                                                                                                                                                                                                                                                                                                                           |
| `OID_Duplicate`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p>Il <code>OID</code> è già nel sistema di impact.com. Fornisci un tipo di evento unico.</p><p><strong>Nota:</strong> Se stai tentando di caricare conversioni non attribuite che ci sono già state segnalate in passato, usa un OID leggermente diverso. Es. xxxxxx <strong>\_1</strong>.</p>                                                                                                                                                                                                                                                                           |
| `CLICK_AFTER_CONVERSION_EVENT`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Il clickid inviato si è verificato dopo l'evento di conversione. Assicurati che la `ClickId` e `EventDate` inviata sia corretta.                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `NO_VALID_REFERRERS_FOUND ACTIONTERMS_NOT_FOUND`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Il contratto con il partner attivo durante il `EventDate` non include questo specifico tipo di evento. Assicurati di controllare il tuo contratto con il partner sotto ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Contratti → Contratti**.                                                                                             |
| `NO_VALID_REFERRERS _ FOUND CONTRACT_NOT_FOUND`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p>Non esiste un contratto attivo con il partner durante il <code>EventDate</code>.</p><p>• Seleziona <img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media" alt=""> <strong>\[Engage] → Contratti → Contratti</strong> per controllare la cronologia dei contratti.</p>                                                                                   |
| `NO_VALID_REFERNO_VALID_REFERRERS_FOUND OUTSIDE_ASSOCIATION_WINDOW`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <p>La conversione è fuori dalla finestra di riferimento del click indicata nei termini del contratto. L'impostazione predefinita è 30 giorni.</p><p>• Seleziona <img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media" alt=""> <strong>\[Engage] → Contratti → Contratti</strong> per verificare la finestra di riferimento per uno specifico partner.</p> |

</details>
