> 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/account-administration/account-settings/send-data-to-impactcom/import-aggregate-performance-data-from-other-networks.md).

# Importa dati aggregati sulle performance da altre reti

Quando inizi a utilizzare impact.com, potresti avere dati aggregati sulle prestazioni di un'altra rete o piattaforma che desideri importare. I dati sulle prestazioni ti consentono di monitorare e confrontare nel tempo i risultati del tuo programma. impact.com offre una soluzione flessibile per importare dati aggregati sulle prestazioni da qualsiasi rete o piattaforma.

## Prerequisiti

* Sono supportati solo i dati aggregati. I dati a livello di clic o di azione non sono supportati.
* Prima di caricare i dati, dovrai mappare i dati di terze parti e fornire mappature personalizzate. Di seguito illustreremo questi passaggi.

## Buone pratiche

* Devi aggiungere i dati nel formato corretto.
* Dopo una revisione tecnica dei dati storici mappati, è consigliabile caricare prima un campione iniziale di alcune decine o un centinaio di record. In seguito, è necessario verificare che i report sulle prestazioni siano accurati prima di procedere con un caricamento in blocco.
* Se devi annullare le modifiche, il file originale deve essere caricato nella cartella *delete* «così com'è», senza modifiche.
* Assicurati che il file di dati finale non superi 1 GB.

{% stepper %}
{% step %}

### Mappare i dati della tabella

Crea un nuovo file .csv e aggiungi intestazioni corrispondenti alle colonne dei tuoi dati. Consulta l'esempio CSV qui sotto per farti un'idea del possibile contenuto del file .csv.

<pre class="language-programlisting"><code class="lang-programlisting"><strong>SubAccountName,Discount,Revenue,Quantity,AdId,Cost,ReferringURL,AdName,AdCampaignId,EventDateTimeStart,OperatingSystem,DeviceType,EventType,MediaValue1,EventDateTimeEnd,ProductCategory,CampaignId,MediaId
</strong>"Some Partner",0.00,58.49,1,13564977,3.41,http://www.partner.com/email/onlineversion.jsp?dh_ABDA1546291792698~1,"Wired Plans",1554194,"2019-01-01 05:02:39 EST","Windows 10",Desktop,item_sale,,"2019-01-01 23:59:59 EST",Phones,15973,5343
"Some Partner",0.00,99.99,1,13564977,7.62,http://www.partner.com/email/onlineversion.jsp?dh_ABDA1546291792698~1,"Wired Plans",1554194,"2019-01-01 07:04:23 EST","Windows 10",Desktop,item_sale,2661135,"2019-01-01 23:59:59 EST",Phones,15973
</code></pre>

Mappa le colonne dei dati della tua piattaforma o rete alle colonne corrispondenti nel file CSV. Consulta il *Riferimento delle colonne* qui sotto per ulteriori informazioni sulle intestazioni di colonna supportate.

<details>

<summary>Riferimento delle colonne</summary>

<table><thead><tr><th width="228.7734375">Nome della colonna di destinazione</th><th width="83.328125">Tipo</th><th width="139.15625">Obbligatorio*</th><th>Descrizione</th></tr></thead><tbody><tr><td>CampaignId</td><td>Intero</td><td>Sì</td><td>L'ID del programma di impact.com.</td></tr><tr><td>EventDateTimeEnd</td><td>Data</td><td>Sì</td><td>Data e ora corrispondenti alla fine dell'evento, nel formato seguente: yyyyMMddd hh:mm:ss z (ad es.: 2023-10-18 23:59:59 EST).</td></tr><tr><td>EventDateTimeStart</td><td>Data</td><td>Sì</td><td>Data e ora corrispondenti all'inizio dell'evento, nel formato seguente: yyyyMMddd hh:mm:ss z (ad es.: 2023-10-18 09:23:67 EST).</td></tr><tr><td>MediaId</td><td>Intero</td><td>Obbligatorio in determinate condizioni, se MediaValue1 non è specificato</td><td>L'ID univoco del partner associato a impact.com.</td></tr><tr><td>MediaValue1</td><td>Stringa</td><td>Obbligatorio in determinate condizioni, se MediaId non è specificato</td><td>Un identificatore univoco fornito da un partner di terze parti. Questo campo accetta qualsiasi valore alfanumerico. Se utilizzi MediaValue1, il valore deve essere mappato. Per ulteriori informazioni, consulta <a href="#conditional-upload-custom-partner-mappings"><em>le mappature personalizzate dei partner</em></a> qui sotto.</td></tr><tr><td>AvgViewsPerUniqueViewer</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Numero medio di visualizzazioni per spettatore univoco.</td></tr><tr><td>Abbandoni</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di abbonati che hanno email respinte, secondo il monitoraggio della piattaforma di terze parti.</td></tr><tr><td>Chiamate</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Numero di chiamate.</td></tr><tr><td>Clic</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di clic sull'annuncio pubblicato.</td></tr><tr><td>Conversioni</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di conversioni generate dall'annuncio.</td></tr><tr><td>Conversioni rifiutate</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di conversioni rifiutate dopo la convalida.</td></tr><tr><td>Costo</td><td>Decimale</td><td>Obbligatorio in determinate condizioni</td><td>Il valore del costo.</td></tr><tr><td>Consegne</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di email o posta diretta inviate ai consumatori tramite la piattaforma di terze parti durante la campagna pubblicitaria.</td></tr><tr><td>Sconto</td><td>Decimale</td><td>Obbligatorio in determinate condizioni</td><td>Il valore dello sconto.</td></tr><tr><td>Impressioni</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di impressioni dell'annuncio pubblicate.</td></tr><tr><td>Margine</td><td>Decimale</td><td>Obbligatorio in determinate condizioni</td><td>Un campo importo per le azioni predefinite o approvate, calcolato come Importo della vendita - Costo dei beni.</td></tr><tr><td>Clic sulle offerte</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di clic sulle offerte.</td></tr><tr><td>Aperture</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di email aperte dai consumatori tramite la piattaforma di terze parti per la campagna.</td></tr><tr><td>Mi piace alla pagina</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di «Mi piace» alla pagina.</td></tr><tr><td>Ricavi</td><td>Decimale</td><td>Obbligatorio in determinate condizioni</td><td>Il valore dei ricavi.</td></tr><tr><td>Invii</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di email o posta diretta inviate ai consumatori tramite la piattaforma di terze parti durante la campagna pubblicitaria.</td></tr><tr><td>Visualizzatori unici sui social</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di visualizzatori sui social.</td></tr><tr><td>Spazi pubblicitari</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Gli spazi pubblicitari di terze parti.</td></tr><tr><td>Disiscrizioni</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di iscritti che hanno annullato l'iscrizione alle email promozionali o alla posta diretta, secondo i dati registrati dalla piattaforma di terze parti.</td></tr><tr><td>Conversioni post-visualizzazione</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di conversioni post-visualizzazione.</td></tr><tr><td>Clic sul sito web</td><td>Intero</td><td>Obbligatorio in determinate condizioni</td><td>Il numero di clic sul sito web.</td></tr><tr><td>ID del rilevatore di azioni</td><td>Intero</td><td>No</td><td>L'identificatore univoco del tipo di evento (precedentemente noto come rilevatore di azioni).</td></tr><tr><td>ID del gruppo di campagne pubblicitarie</td><td>Intero</td><td>No</td><td>L'ID univoco associato al gruppo di campagne pubblicitarie di terze parti.</td></tr><tr><td>Nome del gruppo di campagne pubblicitarie</td><td>Stringa</td><td>No</td><td>Il nome del gruppo di campagne pubblicitarie di terze parti. I gruppi di campagne pubblicitarie semplificano la gestione delle campagne raggruppandole.</td></tr><tr><td>ID della campagna pubblicitaria</td><td>Intero</td><td>No</td><td>L'ID univoco assegnato alla campagna nella piattaforma di marketing di terze parti.</td></tr><tr><td>Nome della campagna pubblicitaria</td><td>Stringa</td><td>No</td><td>Il nome associato a ciascuna campagna nella piattaforma di marketing di terze parti.</td></tr><tr><td>Tipo di distribuzione dell'annuncio</td><td>Stringa</td><td>No</td><td>Il canale di distribuzione dell'annuncio di terze parti, ad esempio Google Search.</td></tr><tr><td>ID del gruppo di annunci</td><td>Intero</td><td>No</td><td>L'ID univoco associato al gruppo di annunci di terze parti.</td></tr><tr><td>Nome del gruppo di annunci</td><td>Stringa</td><td>No</td><td>Il nome del gruppo di annunci di terze parti a cui appartiene l'annuncio che ha generato il clic.</td></tr><tr><td>ID dell'annuncio</td><td>Stringa</td><td>No</td><td>L'ID dell'annuncio pubblicitario di terze parti.</td></tr><tr><td>Nome dell'annuncio</td><td>Stringa</td><td>No</td><td>Il nome dell'annuncio pubblicitario nella piattaforma di terze parti.</td></tr><tr><td>Rete pubblicitaria</td><td>Stringa</td><td>No</td><td>Il nome della rete pubblicitaria di terze parti su cui è stato pubblicato l'annuncio.</td></tr><tr><td>Posizionamento dell'annuncio</td><td>Stringa</td><td>No</td><td>Il posizionamento dell'annuncio di terze parti che ha generato il clic.</td></tr><tr><td>Posizione dell'annuncio</td><td>Stringa</td><td>No</td><td>L'ordine in cui l'annuncio appare su una pagina rispetto agli altri annunci.</td></tr><tr><td>DimensioneAnnuncio</td><td>Stringa</td><td>No</td><td>La dimensione dell'annuncio.</td></tr><tr><td>TipoAnnuncio</td><td>Stringa</td><td>No</td><td>Il tipo di annuncio di terze parti.</td></tr><tr><td>CostoAsta</td><td>Decimale</td><td>No</td><td>Il costo dell'asta.</td></tr><tr><td>PosizioneMedia</td><td>Intero</td><td>No</td><td>Statistica che descrive il posizionamento tipico del tuo annuncio rispetto agli altri annunci. Questo posizionamento determina l'ordine in cui gli annunci vengono visualizzati nella pagina.</td></tr><tr><td>Browser</td><td>Stringa</td><td>No</td><td>Il browser del dispositivo, ad esempio Safari o Firefox.</td></tr><tr><td>Città</td><td>Stringa</td><td>No</td><td>La città in cui si trovava l'utente quando è stato pubblicato l'annuncio.</td></tr><tr><td>Paese</td><td>Stringa</td><td>No</td><td>Il Paese in cui si trovava l'utente quando è stato pubblicato l'annuncio.</td></tr><tr><td>EmailCliente</td><td>Stringa</td><td>No</td><td>L'indirizzo email del cliente.</td></tr><tr><td>IdCliente</td><td>Stringa</td><td>No</td><td>L'ID del cliente presso terze parti.</td></tr><tr><td>SegmentoCliente</td><td>Stringa</td><td>No</td><td>Il segmento di terze parti a cui è assegnato il cliente.</td></tr><tr><td>CostoDati</td><td>Decimale</td><td>No</td><td>Il costo dei dati.</td></tr><tr><td>NomeDispositivo</td><td>Stringa</td><td>No</td><td>Il nome del dispositivo.</td></tr><tr><td>TipoDispositivo</td><td>Stringa</td><td>No</td><td>Il tipo di dispositivo sul quale è stato pubblicato l'annuncio.</td></tr><tr><td>NomeEvento</td><td>Stringa</td><td>No</td><td>Il nome dell'evento di terze parti.</td></tr><tr><td>TipoEvento</td><td>Stringa</td><td>No</td><td>Il tipo di evento che si è verificato.</td></tr><tr><td>IdAnnuncioImpact</td><td>Intero</td><td>No</td><td>L'ID dell'annuncio di impact.com.</td></tr><tr><td>ParolaChiave</td><td>Stringa</td><td>No</td><td>La parola chiave dell'offerta che ha corrisposto alla ricerca.</td></tr><tr><td>IdParolaChiave</td><td>Intero</td><td>No</td><td>L'ID della parola chiave dell'offerta di terze parti associato alla parola chiave dell'offerta.</td></tr><tr><td>RilevanzaParolaChiave</td><td>Stringa</td><td>No</td><td>Quanto gli elementi della tua campagna pubblicitaria corrispondono alle parole chiave di ricerca.</td></tr><tr><td>RilevanzaPaginaDestinazione</td><td>Stringa</td><td>No</td><td>Quanto gli elementi della tua pagina di destinazione corrispondono alle parole chiave di ricerca.</td></tr><tr><td>URLPaginaDestinazione</td><td>Stringa</td><td>No</td><td>L'URL della pagina di destinazione.</td></tr><tr><td>EsperienzaUtentePaginaDestinazione</td><td>Stringa</td><td>No</td><td>Una misura utilizzata da AdWords per stimare quanto la pagina di destinazione del tuo sito web sarà pertinente e utile per le persone che fanno clic sul tuo annuncio. Le pagine di destinazione con valutazioni più alte sono generalmente ben organizzate e contengono testo correlato ai termini di ricerca delle persone.</td></tr><tr><td>TipoCorrispondenza</td><td>Stringa</td><td>No</td><td>Il tipo di corrispondenza ottenuto dal motore di ricerca.</td></tr><tr><td>CPCMassimo</td><td>Intero</td><td>No</td><td>L'offerta massima che sei disposto a pagare per una determinata campagna o annuncio sulla tua piattaforma di ricerca a pagamento.</td></tr><tr><td>Metodo</td><td>Stringa</td><td>No</td><td>Il meccanismo utilizzato per inserire il record. I metodi comunemente utilizzati sono <em>Inserisci</em>, <em>Aggiorna</em>, <em>Sostituisci</em>, oppure <em>Elimina</em>.</td></tr><tr><td>Money1</td><td>Decimale</td><td>No</td><td>Un parametro monetario generico.</td></tr><tr><td>Money2</td><td>Decimale</td><td>No</td><td>Un parametro monetario generico.</td></tr><tr><td>Money3</td><td>Decimale</td><td>No</td><td>Un parametro monetario generico.</td></tr><tr><td>MSA</td><td>Stringa</td><td>No</td><td>Acronimo di Metropolitan Statistical Area (area statistica metropolitana): l'area metropolitana dell'utente in cui è stato pubblicato l'annuncio.</td></tr><tr><td>Numeric1</td><td>Intero</td><td>No</td><td>Un parametro numerico generico.</td></tr><tr><td>Numeric2</td><td>Intero</td><td>No</td><td>Un parametro numerico generico.</td></tr><tr><td>Numeric3</td><td>Intero</td><td>No</td><td>Un parametro numerico generico.</td></tr><tr><td>OperatingSystem</td><td>Stringa</td><td>No</td><td>Il sistema operativo del dispositivo: iOS, Android, Windows, Mac.</td></tr><tr><td>Param1</td><td>Stringa</td><td>No</td><td>Un parametro di monitoraggio generico.</td></tr><tr><td>Param2</td><td>Stringa</td><td>No</td><td>Un parametro di monitoraggio generico.</td></tr><tr><td>Param3</td><td>Stringa</td><td>No</td><td>Un parametro di monitoraggio generico.</td></tr><tr><td>Param4</td><td>Stringa</td><td>No</td><td>Un parametro di monitoraggio generico.</td></tr><tr><td>PricingModel</td><td>Stringa</td><td>No</td><td>Il modello di determinazione dei prezzi utilizzato.</td></tr><tr><td>ProductCategory</td><td>Stringa</td><td>No</td><td>La categoria del prodotto.</td></tr><tr><td>ProductCategoryId</td><td>Intero</td><td>No</td><td>L'ID della categoria di prodotto di terze parti.</td></tr><tr><td>ProductId</td><td>Stringa</td><td>No</td><td>L'ID prodotto o SKU del prodotto mostrato nell'annuncio su cui è stato fatto clic.</td></tr><tr><td>ProductSubCategory</td><td>Stringa</td><td>No</td><td>La sottocategoria del prodotto.</td></tr><tr><td>QualityScore</td><td>Intero</td><td>No</td><td>Una stima della qualità dei tuoi annunci.</td></tr><tr><td>Quantità</td><td>Intero</td><td>No</td><td>La quantità di prodotto resa disponibile nell'annuncio.</td></tr><tr><td>ReferringDomain</td><td>Stringa</td><td>No</td><td>Il dominio da cui proviene il referral.</td></tr><tr><td>ReferringURL</td><td>Stringa</td><td>No</td><td>L'URL di provenienza.</td></tr><tr><td>Regione</td><td>Stringa</td><td>No</td><td>La regione in cui si trovava l'utente quando è stato pubblicato l'annuncio.</td></tr><tr><td>SearchText</td><td>Stringa</td><td>No</td><td>Il termine di ricerca inserito dall'utente nel motore di ricerca.</td></tr><tr><td>SharedId</td><td>Stringa</td><td>No</td><td>Un valore di monitoraggio condiviso con l'inserzionista.</td></tr><tr><td>SubAccountId</td><td>Intero</td><td>No</td><td>L'ID dell'affiliato secondario o del partner sulla piattaforma impact.com.</td></tr><tr><td>SubAccountName</td><td>Stringa</td><td>No</td><td>Il nome dell'affiliato secondario o del partner.</td></tr><tr><td>SubId1</td><td>Stringa</td><td>No</td><td>Un valore di monitoraggio incluso nei report del data warehouse.</td></tr><tr><td>SubId2</td><td>Stringa</td><td>No</td><td>Un valore di monitoraggio incluso nei report del data warehouse.</td></tr><tr><td>SubId3</td><td>Stringa</td><td>No</td><td>Un valore di monitoraggio incluso nei report del data warehouse.</td></tr><tr><td>TargetMarketSize</td><td>Stringa</td><td>No</td><td>Dimensione del mercato target.</td></tr><tr><td>Text1</td><td>Stringa</td><td>No</td><td>Un parametro di testo generico.</td></tr><tr><td>Text2</td><td>Stringa</td><td>No</td><td>Un parametro di testo generico.</td></tr><tr><td>Text3</td><td>Stringa</td><td>No</td><td>Un parametro di testo generico.</td></tr><tr><td>TrafficSource</td><td>Stringa</td><td>No</td><td>La fonte di traffico del partner media per la ricerca a pagamento.</td></tr><tr><td>TrafficType</td><td>Stringa</td><td>No</td><td>La categoria o il tipo di traffico, utilizzato in CPC/CPL/CPA.</td></tr><tr><td>UniqueClicks</td><td>Intero</td><td>No</td><td>Il numero di clic unici.</td></tr><tr><td>UniquePeopleConverting</td><td>Intero</td><td>No</td><td>Il numero di persone uniche che effettuano una conversione.</td></tr><tr><td>UniqueViewers</td><td>Intero</td><td>No</td><td>Il numero di spettatori unici.</td></tr><tr><td>UserAgent</td><td>Stringa</td><td>No</td><td>La stringa dello user agent che identifica il browser dell'utente.</td></tr></tbody></table>

**\***&#x4E;el file deve essere inclusa almeno una delle colonne contrassegnate come *obbligatoria in determinate condizioni* .

</details>
{% endstep %}

{% step %}

### (Condizionale) Caricare le mappature personalizzate dei partner

{% hint style="warning" %}
**Avviso:** Prima di caricare i dati, è consigliabile abilitare le mappature personalizzate dei partner. Se aggiorni le mappature dopo aver caricato i dati, le modifiche non avranno effetto.
{% endhint %}

Le mappature personalizzate dei partner sono necessarie se non puoi fornire a impact.com gli ID dei partner nei dati.

1. Nel menu di navigazione a sinistra, seleziona ![](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] → Partner → Partner**.
2. Carica le mappature personalizzate dei partner selezionando **Modifica in blocco** nell'angolo in alto a destra. Scopri di più sulle [mappature personalizzate dei partner](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/assign-custom-tracking-values-to-partners.md).

<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%2FRaOrVAstmTBOzraeDOfB%2FUntitled%20design%20(1).png?alt=media&amp;token=b486fded-0351-4e70-8df5-36bba301047a" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Inviare il file

1. Segui i passaggi descritti in [Creare una connessione per il caricamento dei dati](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/create-a-data-upload-connection.md) per creare una connessione SFTP.
   * Il tipo di dati da selezionare quando configuri una connessione per i dati storici sulle prestazioni è `aggregate_performance_data`.
   * Il fuso orario delle prestazioni aggregate selezionato durante il passaggio *Configurazione aggiuntiva* non è rilevante e va ignorato.
2. Prima di caricare il file CSV, contatta [l'assistenza](https://app.impact.com/support/portal.ihtml) e collabora con un ingegnere dell'implementazione di impact.com per verificare il file.
   {% 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/account-administration/account-settings/send-data-to-impactcom/import-aggregate-performance-data-from-other-networks.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.
