- Knowledge base
- CRM
- Importazione ed esportazione
- Comprendere lo strumento di importazione
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).
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à.
- Importazioni di fogli di calcolo di opt-out
- Importazioni di eventi personalizzati
- Importazioni di set di dati
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.

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.

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

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:- Per i contatti e le aziende, puoi attivare l'impostazione per creare e associare automaticamente le aziende ai contatti in base al dominio e-mail del contatto. Se hai contatti con domini e-mail diversi dai domini delle loro aziende o se stai importando altri oggetti, segui le istruzioni per associare i tuoi record tramite importazione.
- Se hai dati in un altro sistema e desideri impostare una sincronizzazione bidirezionale, scopri come connetterti e utilizzare la sincronizzazione dei dati HubSpot.
