# Importa dati aggregati sulle performance da altre reti

Quando esegui 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 l'andamento del tuo programma nel tempo. 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. Tratteremo questi passaggi di seguito.

#### Best practice

* Devi aggiungere i dati nel formato corretto.
* Dopo una revisione tecnica dei dati storici mappati, per prima cosa deve essere caricato un campione iniziale di poche decine fino a un centinaio di record. I report sulle prestazioni devono quindi essere confermati come accurati prima di eseguire un caricamento massivo effettivo.
* Se devi annullare le modifiche, il file originale deve essere caricato nella cartella *elimina* “così com'è”, senza modifiche.
* Assicurati che la dimensione del file dati finale sia di 1 GB o meno.

{% 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 potrebbero apparire i contenuti 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 nei dati provenienti dalla tua piattaforma o rete alle 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 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>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>La 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>Condizionale, se MediaValue1 non è fornito</td><td>L'ID partner univoco associato a impact.com. </td></tr><tr><td>MediaValue1</td><td>Stringa</td><td>Condizionale, se MediaId non è fornito</td><td>Un identificatore univoco di un partner di terze parti. Questo campo accetta qualsiasi valore alfanumerico. Se utilizzi MediaValue1, il valore deve essere mappato. Consulta <a href="#conditional-upload-custom-partner-mappings"><em>mappature personalizzate dei partner</em></a> qui sotto per ulteriori informazioni.</td></tr><tr><td>AvgViewsPerUniqueViewer</td><td>Intero</td><td>Condizionale</td><td>Visualizzazioni medie per visualizzatore univoco.</td></tr><tr><td>Bounces</td><td>Intero</td><td>Condizionale</td><td>Il numero di iscritti che hanno riscontrato il rimbalzo delle email, come tracciato dalla piattaforma di terze parti.</td></tr><tr><td>Calls</td><td>Intero</td><td>Condizionale</td><td>Numero di chiamate.</td></tr><tr><td>Clicks</td><td>Intero</td><td>Condizionale</td><td>Il numero di clic sull'annuncio visualizzato.</td></tr><tr><td>Conversions</td><td>Intero</td><td>Condizionale</td><td>Il numero di conversioni generate dall'annuncio.</td></tr><tr><td>ConversionsRejected</td><td>Intero</td><td>Condizionale</td><td>Il numero di conversioni rifiutate dopo la validazione.</td></tr><tr><td>Cost</td><td>Decimale</td><td>Condizionale</td><td>Il valore del costo.</td></tr><tr><td>Delivers</td><td>Intero</td><td>Condizionale</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>Discount</td><td>Decimale</td><td>Condizionale</td><td>Il valore dello sconto.</td></tr><tr><td>Impressions</td><td>Intero</td><td>Condizionale</td><td>Numero di impression dell'annuncio visualizzato.</td></tr><tr><td>Margin</td><td>Decimale</td><td>Condizionale</td><td>Un campo importo per azioni predefinite o approvate, calcolato come Importo vendita - Costo merci.</td></tr><tr><td>OfferClicks</td><td>Intero</td><td>Condizionale</td><td>Il numero di clic sulle offerte.</td></tr><tr><td>Opens</td><td>Intero</td><td>Condizionale</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>Condizionale</td><td>Il numero di Mi piace della pagina.</td></tr><tr><td>Revenue</td><td>Decimale</td><td>Condizionale</td><td>Il valore dei ricavi.</td></tr><tr><td>Sends</td><td>Intero</td><td>Condizionale</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>Condizionale</td><td>Il numero di visualizzatori social.</td></tr><tr><td>Spots</td><td>Intero</td><td>Condizionale</td><td>Gli spot di terze parti.</td></tr><tr><td>Unsubscribes</td><td>Intero</td><td>Condizionale</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>Condizionale</td><td>Il numero di conversioni post-view.</td></tr><tr><td>WebsiteClicks</td><td>Intero</td><td>Condizionale</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 (precedentemente 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 utilizzati 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 delle campagne 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 generato 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'inserzione 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 posizionato l'annuncio.</td></tr><tr><td>AdPlacement</td><td>Stringa</td><td>No</td><td>Il posizionamento pubblicitario di terze parti dell'annuncio che genera il clic.</td></tr><tr><td>AdPosition</td><td>Stringa</td><td>No</td><td>L'ordine in cui il tuo annuncio appare su 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 il posizionamento tipico del tuo annuncio rispetto ad altri annunci. Questo posizionamento determina l'ordine in cui gli annunci appaiono 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>City</td><td>Stringa</td><td>No</td><td>La città in cui si trovava l'utente quando è stato visualizzato l'annuncio.</td></tr><tr><td>Country</td><td>Stringa</td><td>No</td><td>Il paese in cui si trovava l'utente quando è stato visualizzato l'annuncio.</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 del cliente di terze parti.</td></tr><tr><td>CustomerSegment</td><td>Stringa</td><td>No</td><td>Il segmento di terze parti a cui è assegnato il cliente.</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 su 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 si è verificato.</td></tr><tr><td>ImpactAdId</td><td>Intero</td><td>No</td><td>L'ID dell'annuncio di impact.com.</td></tr><tr><td>Keyword</td><td>Stringa</td><td>No</td><td>La parola chiave dell'offerta che corrisponde 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 metrica che AdWords utilizza per stimare quanto la landing page del tuo sito web sarà pertinente e utile per le persone che fanno clic sul tuo annuncio. Le landing page con valutazioni più alte sono solitamente ben organizzate e hanno 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>Method</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: 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 generico.</td></tr><tr><td>Param2</td><td>Stringa</td><td>No</td><td>Un parametro di tracciamento generico.</td></tr><tr><td>Param3</td><td>Stringa</td><td>No</td><td>Un parametro di tracciamento generico.</td></tr><tr><td>Param4</td><td>Stringa</td><td>No</td><td>Un parametro di tracciamento generico.</td></tr><tr><td>PricingModel</td><td>Stringa</td><td>No</td><td>Il modello di prezzo impiegato.</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 del 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>Quantity</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 riferimento.</td></tr><tr><td>Region</td><td>Stringa</td><td>No</td><td>La regione in cui si trovava l'utente quando è stato visualizzato 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 tracciamento condiviso con l'inserzionista.</td></tr><tr><td>SubAccountId</td><td>Intero</td><td>No</td><td>L'ID del sub-affiliato o partner sulla piattaforma impact.com.</td></tr><tr><td>SubAccountName</td><td>Stringa</td><td>No</td><td>Il nome del sub-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 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 del search 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>

![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) Almeno una delle colonne contrassegnate come *Condizionale* obbligatorio deve essere inclusa nel tuo file.

</details>
{% endstep %}

{% step %}

### (Condizionale) Carica mappature personalizzate dei partner

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

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

1. Dal 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 mappature personalizzate dei partner selezionando **Modifica in blocco** nell'angolo in alto a destra. Scopri di più su [mappature personalizzate dei partner](https://help.impact.com/brand/it/cosa-vorresti-imparare/platform-features/tracking/set-up-tracking/assign-custom-tracking-values-to-partners).

<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%2Fgit-blob-90b0659aed7fa5e272b491f310474c39de8890d4%2Fcfeabebd2a7e0fcc725dc4e56426e4c11a3fff1daa51d96ed7a6a089ae0187ff.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Invia il file

1. Segui i passaggi in [Crea una connessione per il caricamento dei dati](https://help.impact.com/brand/it/cosa-vorresti-imparare/account-administration/account-settings/send-data-to-impactcom/create-a-data-upload-connection) per creare una connessione SFTP.
   * Il tipo di dati applicabile da selezionare durante la configurazione di una connessione per i dati storici sulle prestazioni è `aggregate_performance_data`.
   * Il fuso orario delle prestazioni aggregate selezionato durante il *Configurazione aggiuntiva* passaggio è irrilevante e deve essere ignorato.
2. Prima di caricare il file CSV, contatta [l'assistenza](https://app.impact.com/support/portal.ihtml) e collabora con un ingegnere di implementazione di impact.com per verificare il file.
   {% endstep %}
   {% endstepper %}
