> 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 esegui l'onboarding 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 nel tempo le prestazioni del tuo programma. 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. Questi passaggi sono illustrati di seguito.

## Pratiche consigliate

* Devi aggiungere i dati nel formato corretto.
* Dopo una revisione tecnica dei dati storici mappati, è necessario caricare per primo 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 *delete* cartella 'as is', senza modifiche.
* Assicurati che le dimensioni del file di dati finale siano pari o inferiori a 1 GB.

{% stepper %}
{% step %}

### Mappa i dati della tabella

Crea un nuovo file .csv e aggiungi intestazioni che corrispondano alle colonne nei 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 dei dati della tua piattaforma o rete nelle colonne corrispondenti del CSV. Consulta il *Riferimento alle colonne* qui sotto per ulteriori informazioni sulle intestazioni di colonna supportate.

<details>

<summary>Riferimento alle 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 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>In modo 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>In modo 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>le mappature personalizzate dei partner</em></a> qui sotto per maggiori informazioni.</td></tr><tr><td>AvgViewsPerUniqueViewer</td><td>Intero</td><td>In modo condizionale</td><td>Visualizzazioni medie per visualizzatore univoco.</td></tr><tr><td>Rimbalzi</td><td>Intero</td><td>In modo condizionale</td><td>Il numero di iscritti che subiscono rimbalzi delle email, come tracciato dalla piattaforma di terze parti.</td></tr><tr><td>Chiamate</td><td>Intero</td><td>In modo condizionale</td><td>Numero di chiamate.</td></tr><tr><td>Clic</td><td>Intero</td><td>In modo condizionale</td><td>Il numero di clic sull'annuncio pubblicato.</td></tr><tr><td>Conversioni</td><td>Intero</td><td>In modo condizionale</td><td>Il numero di conversioni generate dall'annuncio.</td></tr><tr><td>ConversionsRejected</td><td>Intero</td><td>In modo condizionale</td><td>Il numero di conversioni respinte dopo la convalida.</td></tr><tr><td>Costo</td><td>Decimale</td><td>In modo condizionale</td><td>Il valore del costo.</td></tr><tr><td>Consegne</td><td>Intero</td><td>In modo condizionale</td><td>Il numero di email o direct mail consegnate ai consumatori tramite la piattaforma di terze parti durante la campagna pubblicitaria.</td></tr><tr><td>Sconto</td><td>Decimale</td><td>In modo condizionale</td><td>Il valore dello sconto.</td></tr><tr><td>Impression</td><td>Intero</td><td>In modo condizionale</td><td>Numero di impression dell'annuncio pubblicato.</td></tr><tr><td>Margine</td><td>Decimale</td><td>In modo condizionale</td><td>Un campo importo per le azioni predefinite o approvate, calcolato come Importo della vendita - Costo della merce.</td></tr><tr><td>OfferClicks</td><td>Intero</td><td>In modo condizionale</td><td>Il numero di clic sulle offerte.</td></tr><tr><td>Aperture</td><td>Intero</td><td>In modo condizionale</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>In modo condizionale</td><td>Il numero di mi piace della pagina.</td></tr><tr><td>Ricavi</td><td>Decimale</td><td>In modo condizionale</td><td>Il valore dei ricavi.</td></tr><tr><td>Invii</td><td>Intero</td><td>In modo condizionale</td><td>Il numero di email o direct mail inviate ai consumatori tramite la piattaforma di terze parti durante la campagna pubblicitaria.</td></tr><tr><td>Visualizzatori social univoci</td><td>Intero</td><td>In modo condizionale</td><td>Il numero di visualizzatori social.</td></tr><tr><td>Spazi</td><td>Intero</td><td>In modo condizionale</td><td>Gli spazi di terze parti.</td></tr><tr><td>Disiscrizioni</td><td>Intero</td><td>In modo condizionale</td><td>Il numero di iscritti che si sono disiscritti dalla ricezione di email promozionali o direct mail, come tracciato dalla piattaforma di terze parti.</td></tr><tr><td>ViewThroughConversions</td><td>Intero</td><td>In modo condizionale</td><td>Il numero di conversioni post visualizzazione.</td></tr><tr><td>WebsiteClicks</td><td>Intero</td><td>In modo 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 (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 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 su cui è stato inserito 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 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>Statistiche che descrivono il posizionamento tipico del tuo annuncio rispetto ad altri annunci. Questa posizione determina l'ordine in cui gli annunci compaiono 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 mostrato.</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 mostrato.</td></tr><tr><td>Email del cliente</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 è 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>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>Rilevanza della parola chiave</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>Rilevanza della landing page</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>Esperienza utente della landing page</td><td>Stringa</td><td>No</td><td>Una misura che AdWords usa 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 di solito 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>CPC massimo</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 utilizzato 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>Denaro1</td><td>Decimale</td><td>No</td><td>Un parametro monetario generico.</td></tr><tr><td>Denaro2</td><td>Decimale</td><td>No</td><td>Un parametro monetario generico.</td></tr><tr><td>Denaro3</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 mostrato l'annuncio.</td></tr><tr><td>Numerico1</td><td>Intero</td><td>No</td><td>Un parametro numerico generico.</td></tr><tr><td>Numerico2</td><td>Intero</td><td>No</td><td>Un parametro numerico generico.</td></tr><tr><td>Numerico3</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 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 l'annuncio è stato mostrato.</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 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>Testo1</td><td>Stringa</td><td>No</td><td>Un parametro di testo generico.</td></tr><tr><td>Testo2</td><td>Stringa</td><td>No</td><td>Un parametro di testo generico.</td></tr><tr><td>Testo3</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, usata in CPC/CPL/CPA.</td></tr><tr><td>UniqueClicks</td><td>Intero</td><td>No</td><td>Il numero di clic univoci.</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 visualizzatori.</td></tr><tr><td>UserAgent</td><td>Stringa</td><td>No</td><td>La stringa user agent che tiene traccia del browser dell'utente.</td></tr></tbody></table>

**\***&#x41;lmeno una delle colonne contrassegnate come *In modo condizionale* obbligatorie deve essere inclusa nel file.

</details>
{% endstep %}

{% step %}

### (Condizionale) Carica le 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 necessarie 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] → Partners → Partners**.
2. Carica le mappature personalizzate dei partner selezionando **Modifica massiva** nell'angolo in alto a destra. Leggi di più su [le mappature personalizzate dei partner](/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 %}

### Invia il file

1. Segui i passaggi in [Crea una connessione per il caricamento dei 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 applicabile da selezionare quando si configura una connessione per dati storici di performance è `aggregate_performance_data`.
   * Il fuso orario delle performance aggregate selezionato durante il *Configurazione aggiuntiva* passaggio non è rilevante e deve essere ignorato.
2. Prima di caricare il 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 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.