# Importa dati aggregati sulle prestazioni da altre reti

Quando ti integri con impact.com, potresti avere dati di performance aggregati su un'altra rete o piattaforma che desideri importare. I dati di performance ti consentono di monitorare e confrontare le performance del tuo programma nel tempo. impact.com offre una soluzione flessibile per importare dati di performance aggregati 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. Copriremo questi passaggi di seguito.

#### Best practice

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

{% 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 avere 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 dei dati della 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 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>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 (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 formato seguente: yyyyMMddd hh:mm:ss z (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 usi MediaValue1, il valore deve essere mappato. Consulta <a href="#conditional-upload-custom-partner-mappings"><em>mappature personalizzate dei partner</em></a> di seguito per maggiori informazioni.</td></tr><tr><td>AvgViewsPerUniqueViewer</td><td>Intero</td><td>Condizionale</td><td>Media delle visualizzazioni per singolo spettatore.</td></tr><tr><td>Rimbalzi</td><td>Intero</td><td>Condizionale</td><td>Il numero di iscritti che hanno subito rimbalzi delle email, come tracciato dalla piattaforma di terze parti.</td></tr><tr><td>Chiamate</td><td>Intero</td><td>Condizionale</td><td>Numero di chiamate.</td></tr><tr><td>Clic</td><td>Intero</td><td>Condizionale</td><td>Il numero di clic sull'annuncio pubblicato.</td></tr><tr><td>Conversioni</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 convalida.</td></tr><tr><td>Costo</td><td>Decimale</td><td>Condizionale</td><td>Il valore del costo.</td></tr><tr><td>Consegne</td><td>Intero</td><td>Condizionale</td><td>Il numero di email o di 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>Condizionale</td><td>Il valore dello sconto.</td></tr><tr><td>Impression</td><td>Intero</td><td>Condizionale</td><td>Numero di impression dell'annuncio pubblicato.</td></tr><tr><td>Margine</td><td>Decimale</td><td>Condizionale</td><td>Un campo importo per azioni predefinite o approvate, calcolato come Importo vendita - Costo beni.</td></tr><tr><td>OfferClicks</td><td>Intero</td><td>Condizionale</td><td>Il numero di clic sull'offerta.</td></tr><tr><td>Aperture</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>Ricavi</td><td>Decimale</td><td>Condizionale</td><td>Il valore del ricavo.</td></tr><tr><td>Invii</td><td>Intero</td><td>Condizionale</td><td>Il numero di email o di 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 spettatori social.</td></tr><tr><td>Spot</td><td>Intero</td><td>Condizionale</td><td>Gli spot di terze parti.</td></tr><tr><td>Disiscrizioni</td><td>Intero</td><td>Condizionale</td><td>Il numero di iscritti che si sono disiscritti dalla 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 view-through.</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 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 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'annuncio 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 in 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 ha generato 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 agli 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 normalmente rispetto ad altri annunci. Questo posizionamento 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 è 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>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 a cui è stato mostrato 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>Keyword</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 da vicino 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 da vicino 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 usa 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 in genere ben organizzate e contengono testo correlato ai termini di ricerca della 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>o <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 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 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 prezzo 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 del 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 riferimento.</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 tracciamento condiviso con l'inserzionista.</td></tr><tr><td>SubAccountId</td><td>Intero</td><td>No</td><td>L'Id dell'utente affiliato o partner secondario sulla piattaforma impact.com.</td></tr><tr><td>SubAccountName</td><td>Stringa</td><td>No</td><td>Il nome dell'affiliato o partner secondario.</td></tr><tr><td>SubId1</td><td>Stringa</td><td>No</td><td>Un valore di tracciamento incluso nei report del data warehouse.</td></tr><tr><td>SubId2</td><td>Stringa</td><td>No</td><td>Un valore di tracciamento incluso nei report del data warehouse.</td></tr><tr><td>SubId3</td><td>Stringa</td><td>No</td><td>Un valore di tracciamento incluso nei report 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>Text1</td><td>Stringa</td><td>No</td><td>Un parametro testuale vario.</td></tr><tr><td>Text2</td><td>Stringa</td><td>No</td><td>Un parametro testuale vario.</td></tr><tr><td>Text3</td><td>Stringa</td><td>No</td><td>Un parametro testuale vario.</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, usato 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 effettuano conversioni.</td></tr><tr><td>UniqueViewers</td><td>Intero</td><td>No</td><td>Il numero univoco di spettatori.</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 *Condizionale* obbligatoria 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. Aggiornare le mappature dopo il caricamento dei dati non avrà alcun effetto.
{% endhint %}

Le mappature personalizzate dei partner 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 personalizzate dei partner selezionando **Modifica in blocco** nell'angolo in alto a destra. Scopri di più su [mappature personalizzate dei partner](/brand/it/che-cosa-vorresti-imparare/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/che-cosa-vorresti-imparare/account-administration/account-settings/send-data-to-impactcom/create-a-data-upload-connection.md) per creare una connessione SFTP.
   * Il tipo di dati applicabile da selezionare quando si configura una connessione per i dati storici di performance è `aggregate_performance_data`.
   * Il fuso orario delle performance aggregate selezionato durante il *Configurazione aggiuntiva* passaggio è irrilevante e deve essere ignorato.
2. Prima di caricare il file CSV, contatta [il 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: 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:

```
GET https://help.impact.com/brand/it/che-cosa-vorresti-imparare/account-administration/account-settings/send-data-to-impactcom/import-aggregate-performance-data-from-other-networks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
