> 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 effettui l'onboarding con impact.com, potresti avere dati aggregati sulle prestazioni su un'altra rete o piattaforma che desideri importare. I dati sulle prestazioni ti consentono di monitorare e confrontare nel tempo le performance 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.
* Dovrai mappare i dati di terze parti e fornire mappature personalizzate prima di caricare i dati. Tratteremo questi passaggi di seguito.

#### Buone pratiche

* Devi aggiungere i dati nel formato corretto.
* Dopo una revisione tecnica dei dati storici mappati, è necessario caricare inizialmente un campione di alcune decine fino a un centinaio di record. I report sulle prestazioni devono quindi essere confermati come accurati prima di eseguire un caricamento di massa effettivo.
* Se devi ripristinare le modifiche, il file originale deve essere caricato nella *di eliminazione* cartella ‘così com’è’, senza modifiche.
* Assicurati che la dimensione del file dati finale sia di 1 GB o inferiore.

{% stepper %}
{% step %}

### Mappa i dati della tabella

Crea un nuovo file .csv e aggiungi intestazioni che corrispondano alle colonne dei tuoi dati. Consulta il CSV di esempio qui sotto per farti un'idea di come potrebbe apparire il 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 con le colonne corrispondenti nel CSV. Consulta il *Riferimento colonne* qui sotto per ulteriori informazioni sulle intestazioni di colonna supportate.

<details>

<summary>Riferimento 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 seguente formato: 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 seguente formato: yyyyMMddd hh:mm:ss z (ad es.: 2023-10-18 09:23:67 EST).</td></tr><tr><td>MediaId</td><td>Intero</td><td>Condizionalmente, se MediaValue1 non è fornito</td><td>L'ID partner univoco associato a impact.com.</td></tr><tr><td>MediaValue1</td><td>Stringa</td><td>Condizionalmente, se MediaId non è fornito</td><td>Un identificatore univoco di un partner di terze parti. Questo campo accetta qualsiasi valore alfanumerico. Se si utilizza MediaValue1, il valore deve essere mappato. Vedi <a href="#conditional-upload-custom-partner-mappings"><em>mappature partner personalizzate</em></a> di seguito per ulteriori informazioni.</td></tr><tr><td>AvgViewsPerUniqueViewer</td><td>Intero</td><td>Condizionalmente</td><td>Visualizzazioni medie per visualizzatore univoco.</td></tr><tr><td>Rimbalzi</td><td>Intero</td><td>Condizionalmente</td><td>Il numero di iscritti per i quali le email risultano respinte, come tracciato dalla piattaforma di terze parti.</td></tr><tr><td>Chiamate</td><td>Intero</td><td>Condizionalmente</td><td>Numero di chiamate.</td></tr><tr><td>clic</td><td>Intero</td><td>Condizionalmente</td><td>Il numero di clic sull'annuncio visualizzato.</td></tr><tr><td>Conversioni</td><td>Intero</td><td>Condizionalmente</td><td>Il numero di conversioni generate dall'annuncio.</td></tr><tr><td>ConversionsRejected</td><td>Intero</td><td>Condizionalmente</td><td>Il numero di conversioni rifiutate dopo la convalida.</td></tr><tr><td>Costo</td><td>Decimale</td><td>Condizionalmente</td><td>Il valore del costo.</td></tr><tr><td>Consegne</td><td>Intero</td><td>Condizionalmente</td><td>Il numero di email o posta diretta consegnate ai consumatori tramite la piattaforma di terze parti durante la campagna pubblicitaria.</td></tr><tr><td>Sconto</td><td>Decimale</td><td>Condizionalmente</td><td>Il valore dello sconto.</td></tr><tr><td>impression</td><td>Intero</td><td>Condizionalmente</td><td>Numero di impression dell'annuncio visualizzato.</td></tr><tr><td>Margine</td><td>Decimale</td><td>Condizionalmente</td><td>Un campo importo per le azioni predefinite o approvate, calcolato come Importo di vendita - Costo della merce.</td></tr><tr><td>OfferClicks</td><td>Intero</td><td>Condizionalmente</td><td>Il numero di clic sull'offerta.</td></tr><tr><td>Opens</td><td>Intero</td><td>Condizionalmente</td><td>Il numero di email aperte dai consumatori tramite la piattaforma di terze parti per la campagna.</td></tr><tr><td>PageLikes</td><td>Intero</td><td>Condizionalmente</td><td>Il numero di mi piace alla pagina.</td></tr><tr><td>Ricavi</td><td>Decimale</td><td>Condizionalmente</td><td>Il valore delle entrate.</td></tr><tr><td>Sends</td><td>Intero</td><td>Condizionalmente</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>SocialUniqueViewers</td><td>Intero</td><td>Condizionalmente</td><td>Il numero di visualizzatori social.</td></tr><tr><td>Spots</td><td>Intero</td><td>Condizionalmente</td><td>Gli spot di terze parti.</td></tr><tr><td>Unsubscribes</td><td>Intero</td><td>Condizionalmente</td><td>Il numero di iscritti che hanno annullato l'iscrizione alla ricezione di email promozionali o posta diretta, come tracciato dalla piattaforma di terze parti.</td></tr><tr><td>ViewThroughConversions</td><td>Intero</td><td>Condizionalmente</td><td>Il numero di conversioni view-through.</td></tr><tr><td>WebsiteClicks</td><td>Intero</td><td>Condizionalmente</td><td>Il numero di clic sul sito web.</td></tr><tr><td>ActionTrackerId</td><td>Intero</td><td>No</td><td>L'identificatore univoco del tipo di evento (in precedenza noto come action tracker).</td></tr><tr><td>AdCampaignGroupId</td><td>Intero</td><td>No</td><td>L'ID univoco associato al gruppo di campagne pubblicitarie di terze parti.</td></tr><tr><td>AdCampaignGroupName</td><td>Stringa</td><td>No</td><td>Il nome del gruppo di campagne pubblicitarie di terze parti. I gruppi di campagne pubblicitarie vengono usati per semplificare la gestione delle campagne raggruppandole.</td></tr><tr><td>AdCampaignId</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>AdCampaignName</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>AdDistributionType</td><td>Stringa</td><td>No</td><td>Il canale di distribuzione pubblicitaria di terze parti, ad esempio Google Search.</td></tr><tr><td>AdGroupId</td><td>Intero</td><td>No</td><td>L'ID univoco associato al gruppo di annunci di terze parti.</td></tr><tr><td>AdGroupName</td><td>Stringa</td><td>No</td><td>Il nome del gruppo di annunci di terze parti dell'annuncio che ha attivato il clic.</td></tr><tr><td>AdId</td><td>Stringa</td><td>No</td><td>L'ID dell'inserzione di terze parti.</td></tr><tr><td>AdName</td><td>Stringa</td><td>No</td><td>Il nome dell'annuncio nella piattaforma di terze parti.</td></tr><tr><td>AdNetwork</td><td>Stringa</td><td>No</td><td>Il nome della rete pubblicitaria di terze parti su cui è stato inserito l'annuncio.</td></tr><tr><td>AdPlacement</td><td>Stringa</td><td>No</td><td>L'inserimento pubblicitario di terze parti dell'annuncio che ha attivato il clic.</td></tr><tr><td>AdPosition</td><td>Stringa</td><td>No</td><td>L'ordine in cui il tuo annuncio appare in una pagina rispetto ad altri annunci.</td></tr><tr><td>AdSize</td><td>Stringa</td><td>No</td><td>La dimensione dell'annuncio.</td></tr><tr><td>AdType</td><td>Stringa</td><td>No</td><td>Il tipo di annuncio di terze parti.</td></tr><tr><td>AuctionCost</td><td>Decimale</td><td>No</td><td>Costo dell'asta.</td></tr><tr><td>AveragePosition</td><td>Intero</td><td>No</td><td>Statistica che descrive come il tuo annuncio si posiziona tipicamente rispetto ad altri annunci. Questa posizione determina l'ordine in cui gli annunci appaiono sulla 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 l'annuncio è stato visualizzato.</td></tr><tr><td>Paese</td><td>Stringa</td><td>No</td><td>Il paese in cui si trovava l'utente quando l'annuncio è stato visualizzato.</td></tr><tr><td>CustomerEmail</td><td>Stringa</td><td>No</td><td>L'email del cliente.</td></tr><tr><td>CustomerId</td><td>Stringa</td><td>No</td><td>ID di terze parti del cliente.</td></tr><tr><td>CustomerSegment</td><td>Stringa</td><td>No</td><td>Il segmento di terze parti a cui il cliente è assegnato.</td></tr><tr><td>DataCost</td><td>Decimale</td><td>No</td><td>Il costo dei dati.</td></tr><tr><td>DeviceName</td><td>Stringa</td><td>No</td><td>Il nome del dispositivo.</td></tr><tr><td>DeviceType</td><td>Stringa</td><td>No</td><td>Il tipo di dispositivo a cui è stato visualizzato l'annuncio.</td></tr><tr><td>EventName</td><td>Stringa</td><td>No</td><td>Il nome dell'evento di terze parti.</td></tr><tr><td>EventType</td><td>Stringa</td><td>No</td><td>Il tipo di evento che ha avuto luogo.</td></tr><tr><td>ImpactAdId</td><td>Intero</td><td>No</td><td>L'ID dell'annuncio di impact.com.</td></tr><tr><td>Parola chiave</td><td>Stringa</td><td>No</td><td>La parola chiave dell'offerta che corrispondeva alla ricerca.</td></tr><tr><td>KeywordId</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>KeywordRelevance</td><td>Stringa</td><td>No</td><td>Quanto strettamente gli elementi della tua campagna pubblicitaria corrispondono alle parole chiave di ricerca.</td></tr><tr><td>LandingPageRelevance</td><td>Stringa</td><td>No</td><td>Quanto strettamente gli elementi della tua landing page corrispondono alle parole chiave di ricerca.</td></tr><tr><td>LandingPageURL</td><td>Stringa</td><td>No</td><td>L'URL della landing page.</td></tr><tr><td>LandingPageUserExperience</td><td>Stringa</td><td>No</td><td>Una misura che AdWords utilizza per stimare quanto sarà pertinente e utile la landing page del tuo sito web per le persone che fanno clic sul tuo annuncio. Le landing page con valutazioni più alte sono solitamente ben organizzate e contengono testo correlato ai termini di ricerca di una persona.</td></tr><tr><td>MatchType</td><td>Stringa</td><td>No</td><td>Il tipo di corrispondenza ottenuto dal motore di ricerca.</td></tr><tr><td>MaxCPC</td><td>Intero</td><td>No</td><td>Offerta massima che sei disposto a pagare per una determinata campagna o annuncio nella tua piattaforma di ricerca a pagamento.</td></tr><tr><td>Metodo</td><td>Stringa</td><td>No</td><td>Il meccanismo usato per inserire il record. I metodi comunemente usati 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: l'area metropolitana dell'utente, in cui è stato visualizzato 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 tracciamento vario.</td></tr><tr><td>Param2</td><td>Stringa</td><td>No</td><td>Un parametro di tracciamento vario.</td></tr><tr><td>Param3</td><td>Stringa</td><td>No</td><td>Un parametro di tracciamento vario.</td></tr><tr><td>Param4</td><td>Stringa</td><td>No</td><td>Un parametro di tracciamento vario.</td></tr><tr><td>PricingModel</td><td>Stringa</td><td>No</td><td>Il modello di pricing 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 presente nell'annuncio cliccato.</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à del prodotto resa disponibile nell'annuncio.</td></tr><tr><td>ReferringDomain</td><td>Stringa</td><td>No</td><td>Il dominio che ha effettuato 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 l'annuncio è stato visualizzato.</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 tracciamento condiviso con l'inserzionista.</td></tr><tr><td>SubAccountId</td><td>Intero</td><td>No</td><td>L'ID del sotto-affiliato o partner sulla piattaforma impact.com.</td></tr><tr><td>SubAccountName</td><td>Stringa</td><td>No</td><td>Il nome del sotto-affiliato o partner.</td></tr><tr><td>SubID1</td><td>Stringa</td><td>No</td><td>Un valore di tracciamento incluso nella reportistica del data warehouse.</td></tr><tr><td>SubId2</td><td>Stringa</td><td>No</td><td>Un valore di tracciamento incluso nella reportistica del data warehouse.</td></tr><tr><td>SubId3</td><td>Stringa</td><td>No</td><td>Un valore di tracciamento incluso nella reportistica del data warehouse.</td></tr><tr><td>TargetMarketSize</td><td>Stringa</td><td>No</td><td>Dimensione del mercato di riferimento.</td></tr><tr><td>Testo1</td><td>Stringa</td><td>No</td><td>Un parametro testuale generico.</td></tr><tr><td>Testo2</td><td>Stringa</td><td>No</td><td>Un parametro testuale generico.</td></tr><tr><td>Testo3</td><td>Stringa</td><td>No</td><td>Un parametro testuale generico.</td></tr><tr><td>TrafficSource</td><td>Stringa</td><td>No</td><td>La fonte di traffico del partner media di 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 univoco di persone che convertono.</td></tr><tr><td>UniqueViewers</td><td>Intero</td><td>No</td><td>Il numero univoco di visualizzatori.</td></tr><tr><td>UserAgent</td><td>Stringa</td><td>No</td><td>La stringa user agent che traccia il browser dell'utente.</td></tr></tbody></table>

![](/files/b4b476a3c2475775c360c31bec6e9342a36d1699) Almeno una delle colonne contrassegnate come *Condizionalmente* obbligatorie deve essere inclusa nel tuo file.

</details>
{% endstep %}

{% step %}

### (Condizionale) Carica mappature partner personalizzate

{% hint style="warning" %}
**Avvertenza:** Dovresti abilitare eventuali mappature partner personalizzate prima di tentare di caricare i tuoi dati. L'aggiornamento delle mappature dopo il caricamento dei dati non avrà alcun effetto.
{% endhint %}

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

1. Dal menu di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage] → Partner → Partner**.
2. Carica le mappature partner personalizzate selezionando **Modifica in blocco** nell'angolo in alto a destra. Leggi di più su [mappature partner personalizzate](/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="/files/20b4ba04d65fdd9cb8a9ba402d76760f7312abf6" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Invia il file

1. Segui i passaggi in [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) per creare una connessione SFTP.
   * Il tipo di dati appropriato da selezionare quando si configura una connessione per i dati storici sulle prestazioni è `aggregate_performance_data`.
   * Il fuso orario delle prestazioni aggregate selezionato durante il *Configurazione aggiuntiva* è irrilevante e deve essere ignorato.
2. Prima di caricare il tuo file CSV, contatta [supporto](https://app.impact.com/support/portal.ihtml) e collabora con un ingegnere di 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 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/account-administration/account-settings/send-data-to-impactcom/import-aggregate-performance-data-from-other-networks.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.
