Salta al contenuto
Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

Comprendere lo strumento di importazione

Ultimo aggiornamento: 11 dicembre 2025

Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:

Importa per aggiungere oggetti, come contatti, aziende, trattative, servizi e attività, a HubSpot. Caricando un foglio di calcolo e mappando le sue colonne alle proprietà HubSpot, puoi creare nuovi record, aggiornare quelli esistenti e definire le relazioni tra loro. Esamina il processo di importazione e la terminologia riportati di seguito per assicurarti che i tuoi dati siano formattati correttamente prima di caricare il file.

Se sei nuovo su HubSpot e desideri migrare i tuoi dati CRM esistenti al CRM di HubSpot, puoi richiedere una migrazione dei dati al team Replatforming di HubSpot.

Glossario

  • Oggetto CRM: informazioni sui tuoi clienti e sui processi aziendali, come contatti, aziende, trattative e ticket. Durante l'importazione, un oggetto è il tipo di set di dati che stai importando in HubSpot.

  • Record: singola istanza di un oggetto (ad esempio, "Neal Caffrey" è un record di contatto). In un singolo file di importazione di oggetti, ogni riga del file rappresenta un record di oggetto. Se stai importando più oggetti in un unico file, ogni riga rappresenterà i record associati tra loro.

  • Attività: un'interazione che può essere associata ai record, come un'e-mail inviata a un contatto o una nota registrata su un record di ticket. Per lo strumento di importazione, le attività supportate includono chiamate, e-mail, riunioni, note e attività.
  • Proprietà: un campo creato per memorizzare informazioni sui record e sulle attività. In un'importazione, le proprietà corrispondono alle intestazioni delle colonne del file.

Nell'esempio seguente, l'oggetto importato sono i contatti. Ogni riga rappresenta un record di contatto e ogni colonna di informazioni rappresenta una proprietà di contatto (nome, cognome, indirizzo e-mail).

contact-import-example-1

Oggetti e attività supportati

Di seguito sono riportati i tipi di importazione che è possibile completare e gli oggetti e le attività supportati per ciascuno di essi.

Importazione di un singolo oggetto o attività

È possibile importare per creare e/o aggiornare un oggetto o un'attività alla volta. In un'importazione di un singolo oggetto:

  • È possibile creare e/o aggiornare contatti, aziende, trattative, ticket, appuntamenti, corsi, elenchi, servizi, chiamate, prodotti, progetti, ordini, carrelli, abbonamenti e record di oggetti personalizzati.
  • È possibile creare, ma non aggiornare, attività.

Importazione di più oggetti e attività

È possibile importare per creare, aggiornare e/o associare più oggetti e attività contemporaneamente. È possibile importare più oggetti e attività in un unico file, oppure due oggetti/un oggetto e un'attività in due file separati. Quando si utilizzano due file separati, i file devono contenere una colonna condivisa.

In un'importazione di più oggetti:

  • È possibile creare e/o aggiornare contatti, aziende, trattative, ticket, appuntamenti, corsi, inserzioni, servizi, chiamate, ordini, progetti, carrelli e record di oggetti personalizzati.
  • È possibile creare e/o aggiornare voci di riga, ma queste devono essere associate a transazioni.
  • È possibile creare, ma non aggiornare, e-mail, riunioni, note e attività. Le e-mail, le riunioni e le note devono essere associate a un oggetto.

Esempio: utilizzare due file per importare due oggetti

Si dispone di due file provenienti da un database diverso da importare in HubSpot, uno contenente contatti e l'altro contenente transazioni. Entrambi condividono una colonnaNome transazione, che corrisponde al contatto associato nel file dei contatti. Durante l'importazione, utilizzaNome deal come colonna comune e chiave univoca per il file dei contatti. Ciò consente alla colonna di popolare la proprietà Nome deal associando le trattative ai contatti in HubSpot.

Altri tipi di importazioni

È anche possibile accedere al processo di importazione per altri strumenti dalla pagina di importazione, tuttavia questi seguono passaggi diversi rispetto alle importazioni di oggetti o attività.

Configurazione dei file di importazione

Prima di caricare un file nello strumento di importazione, è importante configurare correttamente i file per assicurarsi che i dati vengano aggiunti correttamente al tuo account. Le sezioni seguenti includono concetti e requisiti importanti per configurare correttamente i tuoi file.

Per i file di esempio predefiniti, consulta questo articolo.

Requisiti

Consulta l'articolo Configurazione dei file di importazione per i limiti tecnici e i requisiti generali.

Identificatori univoci

Un identificatore univoco è un valore di proprietà che HubSpot utilizza per riconoscere ogni record come unico nel suo genere. In un'importazione, è necessario un identificatore univoco per aggiornare i record, evitare la creazione di record duplicati (ad esempio, due record per "Tom Smith") e associare i record tra loro (ad esempio, importare "Tom Smith" e associarlo alla sua azienda "Smith Inc."). Per i contatti e le aziende, si consiglia di utilizzare i rispettivi identificatori univoci durante l'importazione (e-mail,nome di dominio dell'azienda).

Gli identificatori univoci disponibili per l'uso durante l'importazione sono:

  • Email: l'indirizzo email di un contatto. È necessario durante l'importazione dei contatti per evitare duplicati o per associare i contatti a un altro oggetto. Se non si dispone degli indirizzi email dei contatti, utilizzare l' ID record per aggiornare e associare i record dei contatti esistenti.
  • Nome di dominio dell'azienda: il dominio del sito web di un'azienda (ad esempio, example.com). È necessario durante l'importazione delle aziende per evitare duplicati o per associare le aziende a un altro oggetto. Se non si dispone dei nomi di dominio delle aziende, utilizzare l' ID record per aggiornare e associare i record aziendali esistenti.
  • ID record: un valore di proprietà univoco assegnato a ciascun record da HubSpot. Se esporti record esistenti da HubSpot, ogni record avrà un ID record. Si tratta dell'identificatore univoco predefinito per deal, ticket, appuntamenti, corsi, inserzioni, servizi, attività e oggetti personalizzati, ma può anche essere utilizzato come identificatore univoco per contatti e aziende se non disponi di indirizzi e-mail o nomi di dominio aziendali. Se l'ID record è incluso nell'importazione, sostituirà qualsiasi altro identificatore univoco.
  • Proprietà personalizzata che richiede valori univoci: se hai creato una proprietà che richiede valori univoci, puoi utilizzare la proprietà come identificatore univoco nei tuoi file di importazione. Questo è supportato per contatti, aziende, transazioni, ticket, appuntamenti, corsi, elenchi, servizi e oggetti personalizzati.

Per i contatti e le aziende, si consiglia di utilizzare i rispettivi identificatori univoci durante l'importazione (e-mail,nome di dominio aziendale). Ciò consente di mantenere la qualità dei dati.

Esempio: utilizzarel'ID record per aggiornare le trattative esistenti

Si desidera aggiornare diverse proprietà per tutte le trattative esistenti nella pipeline. Esportare tali trattative e includere solo le proprietà che si desidera modificare più l'ID record. Apportare gli aggiornamenti desiderati nel foglio di calcolo, lasciando invariata la colonnaID record. Eseguire un'importazione delle trattative e utilizzarel'ID record come identificatore univoco nella parte del processo relativa alle colonne di mappatura.

Associazioni

Abbonamento richiesto Per aggiungere etichette di associazione è necessario un abbonamento Professional o Enterprise.

Puoi anche importare per associare i record tra loro e aggiungere etichette di associazione per specificare la relazione tra i record. Ciò include associazioni tra oggetti diversi, come un affare e un contatto, o associazioni tra oggetti uguali, come un contatto e un altro contatto.

Scopri di più su come includere correttamente le associazioni nei tuoi file di importazione.

Esempio: importare un'associazione tra oggetti uguali di un contatto

La tua azienda tiene traccia delle relazioni tra manager e singoli collaboratori (IC) utilizzando l'oggetto contatto. I manager esistono già in HubSpot. Configura un unico file di importazione in modo che contenga l'e-mail principale di entrambi i contatti in colonne separate (ad esempio,E-mail manager, E-mail IC). Il valore della proprietà e-mail del manager deve corrispondere a quello già presente in HubSpot. Avvia l'importazione dei contatti, seleziona l'opzione per creare associazioni dello stesso oggetto, configura il resto dei dettagli e completa l'importazione. Puoi anche utilizzare etichette di associazione personalizzate per etichettare la relazione.

Two-column spreadsheet with headers ‘Manager email’ and ‘IC email,’ each containing one email address.

Mappa le colonne alle proprietà

Dopo aver caricato il file nello strumento di importazione, durante il processo di importazione ti verrà richiesto di abbinare le intestazioni delle colonne del file alle proprietà di HubSpot. Una mappatura corretta garantisce che i dati vengano inseriti nel posto giusto (ovvero nell'oggetto e nella proprietà corretti) quando vengono aggiunti a HubSpot.

Ad esempio, per un file di contatti, dovresti mappare la colonna Nomealla proprietà di contatto Nome.

A HubSpot import mapping screen showing the Email column header from the file (highlighted) mapped to the Email HubSpot Property (highlighted) under Contact properties.

Per un file che associa più oggetti, selezioneresti l'oggetto e la proprietà corrispondenti per ogni colonna.

A HubSpot import mapping screen showing two columns mapped. The Email column is mapped to Contact properties, and the Domain name column is mapped to Company properties.

Errori di importazione

Se l'importazione contiene errori durante il processo di mappatura, puoi gestire determinati errori per correggere i dati prima che vengano aggiunti al tuo account. Se dopo l'importazione sono presenti errori, puoi esaminarli e risolverli per aggiungere o aggiornare i dati interessati.

Altri modi per aggiornare i dati in HubSpot

Invece di importare, ci sono altri modi per creare, sincronizzare o associare record in blocco che puoi prendere in considerazione:
L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.