> 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/submit-call-conversion-data-via-ftp.md). # Invia i dati di conversione delle chiamate tramite FTP Segui il corso PXA I brand che tengono traccia dei dati di conversione delle chiamate possono inviare tali dati in batch in un file .CSV caricato sul server FTP di Impact con credenziali univoche. I dati di conversione delle chiamate inviati in batch a impact.com tramite FTP vengono in genere elaborati entro 24 ore e appariranno come azioni in sospeso all'interno della piattaforma impact.com. #### Carica il tuo file .CSV Per inviare al server FTP di impact.com, dovrai prima recuperare le credenziali dell'account. Segui le istruzioni qui sotto per scoprire come farti inviare via email le credenziali esistenti. {% hint style="warning" %} **Nota:** Se non hai ricevuto l'email, contatta la persona che ha creato il tuo account impact.com, in alternativa [contatta il supporto](https://app.impact.com/secure/mediapartner/support/customer-support-portal-flow.ihtml?execution=e1s1). {% endhint %} 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 di destra, sotto *Tracciamento*, seleziona **Tipi di evento**. 3. Passa il cursore sul tipo di evento per cui vuoi inviare i dati, quindi seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[Altro] → Visualizza/Modifica**. 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) → Caricamento in batch**. 6. Scegli una connessione FTP selezionando ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[casella non selezionata]**. * In alternativa, seleziona **Crea nuova connessione**. Scopri come [crea una connessione di caricamento dati](/brand/it/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/create-a-data-upload-connection.md). 7. Una volta ottenute le credenziali FTP, usa un client FTP per connetterti a impact.com. * L'indirizzo FTP è `ftp://import.impact.com/{name}` * Puoi usare un set di credenziali esistente oppure un set di credenziali generato automaticamente. 8. Una volta connesso, carica il file nella directory principale del server. #### Specifiche del formato del file per la conversione delle chiamate I dati di conversione delle chiamate vengono inseriti in un file .CSV. Fai riferimento alla specifica qui sotto per tutte le intestazioni di colonna richieste nel tuo file .CSV.
Riferimento al formato del file per la conversione delle chiamate | Campo | Tipo | Obbligatorio | Descrizione | | ----------------------------- | ------------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `CampaignId` | Intero | **Obbligatorio** | Identificatore univoco della campagna (o del programma) a cui è associata la conversione della chiamata. | | `MediaId` | Intero | **Obbligatorio** | Identificatore univoco del partner o della fonte media. | | `EventDate` | datetime (ISO 8601) | **Obbligatorio** | Formato ISO 8601 della data e dell'ora in cui si è verificato l'evento di conversione della chiamata. | | `ActionTrackerId` | Intero | **Obbligatorio** | Identificatore univoco dell'action tracker (cioè il tipo di evento) che sta tracciando la telefonata. | | `CallProvider` | Stringa | **Obbligatorio** | Il fornitore o il cliente che invia i dati dell'evento di chiamata | | `CallSessionId` | Stringa | **Obbligatorio** | Un ID di sessione univoco che il fornitore o il cliente usa per identificare la chiamata. | | `CallerId` | Stringa | **Obbligatorio** | Il numero di telefono della chiamata originaria, usato per abbinare la conversione finale. | | `CalledPhoneNumber` | Stringa | **Obbligatorio** | Il numero di telefono di destinazione o il numero di telefono che ha ricevuto la chiamata. | | `CallDuration` | Stringa | **Obbligatorio** | Durata totale della chiamata (in secondi). | | `TalkDuration` | Stringa | **Obbligatorio** | Durata effettiva della conversazione (in secondi) della chiamata. | | `AdId` | Intero | Facoltativo | Identificatore univoco dell'annuncio associato alla conversione della chiamata. | | `CallStatus` | Stringa | Facoltativo |

Questo valore indica l'esito finale della chiamata. Se il campo non è presente nella richiesta, lo impostiamo ANSWER di default. I valori validi sono:

UNKNOWN\_CALLERID

FAILURE

CONGESTION

INCOMPLETE

CANCEL

IVR\_DROPOFF

NO\_TRANSFER\_ATTEMPT

ANSWER

| | `CallerPhoneNumberCountry` | Stringa | Facoltativo | Codice paese a due lettere per il numero di telefono di origine (ISO 3166 alpha-2). Se NULL, il valore predefinito è US. | | `CalledPhoneNumberCountry` | Stringa | Facoltativo | Codice paese a due lettere per il numero di telefono chiamato (ISO 3166 alpha-2). Se NULL, il valore predefinito è US. | | `SubId1` | Stringa | Facoltativo | Questo valore è specifico ed è disponibile solo per il media partner. Questo è il segnaposto in cui il Media Partner può aggiungere i punti dati che desidera che impact.com gli riporti. | | `SubId2` | Stringa | Facoltativo | | | `SubId3` | Stringa | Facoltativo | | | `ClickId` | Stringa | Facoltativo | Identificatore univoco con distinzione tra maiuscole e minuscole generato da impact.com di un clic di riferimento, usato per costruire il percorso di un consumatore. | | `Paese` | Stringa | Facoltativo | Paese del CallerId - come identificato dal fornitore di call tracking. | | `Città` | Stringa | Facoltativo | Città del CallerId - come identificata dal fornitore di call tracking. | | `Regione` | Stringa | Facoltativo | Regione del CallerId - come identificata dal fornitore di call tracking. | | `Zip` | Intero | Facoltativo | CAP del CallerId - come identificato dal fornitore di call tracking. | | `RepeatCaller` | Stringa | Facoltativo | Chiamata ripetuta vs nuova per indicare se il chiamante è stato registrato come chiamante ripetuto dal fornitore di call tracking. | | `PhoneType` | Stringa | Facoltativo | Il tipo di telefono (ad es. fisso, mobile). | | `CallRecording` | Stringa | Facoltativo | URL univoco della registrazione della chiamata. | | `IvrDuration` | Stringa | Facoltativo | Durata in secondi trascorsa dalla chiamata nell'albero IVR. | | `Keypresses` | Stringa | Facoltativo | Elenco dei nomi univoci dei tasti premuti durante la chiamata. | | `Key1` | Stringa | Facoltativo | Nome del primo tasto premuto. | | `Key2` | Stringa | Facoltativo | Nome del secondo tasto premuto. | | `Key3` | Stringa | Facoltativo | Nome del terzo tasto premuto. | | `Key4` | Stringa | Facoltativo | Nome del quarto tasto premuto. | | `TrafficSource` | Stringa | Facoltativo | Fonte della transazione (fonte media di riferimento). | | `OptInSms` | Stringa | Facoltativo | Indica se il chiamante ha acconsentito a ricevere una promozione via SMS. | | `UserAgent` | Stringa | Facoltativo | Lo user agent del generatore della conversione. | | `DispositionName` | Stringa | Facoltativo | Il nome dell'evento di conversione. | | `SaleAmount` | Valuta | Facoltativo | Se si tratta di una conversione di vendita, importo della vendita | | `ReferenceId` | Stringa | Facoltativo | Codice di disposizione del cliente di riferimento. | | `CustomConversionEvent1Name` | Stringa | Facoltativo | Nome personalizzato per la reportistica sugli eventi di conversione | | `CustomConversionEvent2Name` | Stringa | Facoltativo | | | `CustomConversionEvent3Name` | Stringa | Facoltativo | | | `CustomConversionEvent1Value` | Stringa | Facoltativo | Valore personalizzato per la reportistica sugli eventi di conversione | | `CustomConversionEvent2Value` | Stringa | Facoltativo | | | `CustomConversionEvent3Value` | Stringa | Facoltativo | | | `VendorEventId` | Stringa | Facoltativo | Saranno univoci per l'evento di chiamata e univoci per l'evento di conversione. | | `PromoNumberDescription` | Stringa | Facoltativo | Descrive il numero di telefono chiamato | | `CustomCallEvent1Name` | Stringa | Facoltativo | Nome personalizzato per la reportistica sugli eventi di chiamata | | `CustomCallEvent2Name` | Stringa | Facoltativo | | | `CustomCallEvent3Name` | Stringa | Facoltativo | | | `CustomCallEvent1Value` | Stringa | Facoltativo | Valore personalizzato per la reportistica sugli eventi di chiamata | | `CustomCallEvent2Value` | Stringa | Facoltativo | | | `CustomCallEvent3Value` | Stringa | Facoltativo | |
#### CSV di esempio Copia questi dati CSV di esempio da usare per l'importazione del file. ```programlisting CampaignId,MediaId,EventDate,ActionTrackerId,CallProvider,CallSessionId,CallerId,CalledPhoneNumber,CallDuration,TalkDuration,AdId,CallStatus,CallerPhoneNumberCountry,CalledPhoneNumberCountry,SubId1,SubId2,SubId3,ClickId,City,Region,Zip,RepeatCaller,PhoneType,CallRecording,IvrDuration,Keypresses,Key1,Key2,Key3,Key4,OptInSms,UserAgent,DispositionName,SaleAmount,ReferenceId,CustomConversionEvent1Name,CustomConversionEvent2Name,CustomConversionEvent3Name,CustomConversionEvent1Value,CustomConversionEvent2Value,CustomConversionEvent3Value,VendorEventId,PromoNumberDescription,CustomCallEvent1Name,CustomCallEvent2Name,CustomCallEvent3Name,CustomCallEvent1Value,CustomCallEvent2Value,CustomCallEvent3Value 1000,987654,2022-03-01T04:10:49-05:00,19283,Acme,1A5B9C4D0E0F7G1H0I,8005550100,11,8, ``` --- # 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/submit-call-conversion-data-via-ftp.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.