> 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 ti attivi su 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. Di seguito vedremo questi passaggi.

## Best practice

* Devi aggiungere i dati nel formato corretto.
* Dopo una revisione tecnica dei dati storici mappati, per prima cosa dovrebbe essere caricato un campione iniziale di poche dozzine 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 annullare le modifiche, il file originale deve essere caricato nella *elimina* cartella ‘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 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 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 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>In modo condizionale, se MediaValue1 non è fornito</td><td>L'ID univoco del partner 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> di seguito per ulteriori 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 ricevono 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 rifiutate 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 conteggio delle email o delle comunicazioni dirette 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 conteggio delle email aperte dai consumatori tramite la piattaforma di terze parti per la campagna.</td></tr><tr><td>PageLikes</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 comunicazioni dirette inviate ai consumatori tramite la piattaforma di terze parti durante la campagna pubblicitaria.</td></tr><tr><td>SocialUniqueViewers</td><td>Intero</td><td>In modo condizionale</td><td>Il numero di visualizzatori social.</td></tr><tr><td>Spots</td><td>Intero</td><td>In modo condizionale</td><td>Gli spazi della terza parte.</td></tr><tr><td>Annullamenti iscrizione</td><td>Intero</td><td>In modo condizionale</td><td>Il numero di iscritti che hanno annullato l'iscrizione alle email promozionali o alle comunicazioni dirette, 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 view-through.</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 della campagna pubblicitaria di terze parti.</td></tr><tr><td>AdCampaignGroupName</td><td>Stringa</td><td>No</td><td>Il nome del gruppo della campagna pubblicitaria di terze parti. I gruppi di campagne pubblicitarie vengono usati per semplificare la gestione delle campagne raggruppandole insieme.</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 sulla quale è stato inserito l'annuncio.</td></tr><tr><td>AdPlacement</td><td>Stringa</td><td>No</td><td>L'inserzione pubblicitaria 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 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 la posizione tipica del tuo annuncio rispetto agli altri annunci. Questa posizione 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>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 pubblicato 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 strettamente gli elementi della tua campagna pubblicitaria corrispondono alle parole chiave della 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 della 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 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 di una persona.</td></tr><tr><td>MatchType</td><td>Stringa</td><td>No</td><td>Il tipo di corrispondenza ottenuta 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 particolare 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>Sostituiscano</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 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 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 del prodotto di terze parti.</td></tr><tr><td>ProductId</td><td>Stringa</td><td>No</td><td>L'ID del prodotto o lo 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 generato 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 tracciamento condiviso con l'inserzionista.</td></tr><tr><td>SubAccountId</td><td>Intero</td><td>No</td><td>L'ID del subaffiliato o partner sulla piattaforma impact.com.</td></tr><tr><td>SubAccountName</td><td>Stringa</td><td>No</td><td>Il nome del subaffiliato 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>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, 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 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>

**\***&#x41;lmeno una delle colonne contrassegnate come *In modo 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 necessarie se non puoi fornire a impact.com gli ID dei 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 le mappature personalizzate dei partner selezionando **Modifica in blocco** 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 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 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 la *Configurazione aggiuntiva* fase è irrilevante e deve essere ignorato.
2. Prima di caricare il tuo 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 %}


---

# 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.