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

Impostare i file di importazione

Ultimo aggiornamento: settembre 20, 2022

Si applica a:

Tutti i prodotti e i piani

Che HubSpot sia il vostro primo CRM o che vi stiate trasferendo da un altro sistema, l'importazione vi aiuta a creare record e ad aggiornare il vostro database. I file di importazione sono fogli di calcolo di dati utilizzati per organizzare le relazioni e i processi aziendali. Prima di iniziare l'importazione

, è necessario esaminare i termini e i requisiti di HubSpot per i file di importazione.

Nota bene: gli impegni (e-mail, chiamate, attività o riunioni) associati ai vostri record non possono essere importati in HubSpot tramite un file. Per saperne di più sull'aggiunta di impegni tramite l'API.

Glossario

  • Oggetto CRM: un tipo di relazione o processo della vostra azienda, come contatti, aziende, offerte e biglietti. Quando si importa, un oggetto è il tipo di set di dati che si sta importando in HubSpot.

  • Record: un'istanza individuale di un oggetto (ad esempio, "Tom Smith" è un record di contatto). In un file di importazione di un singolo oggetto, ogni riga del file rappresenta un record dell'oggetto. Se si importano più oggetti in un unico file, ogni riga rappresenterà i record associati tra loro.

  • Proprietà: campo creato per memorizzare informazioni sui record. In un'importazione, le proprietà corrispondono alle intestazioni delle colonne del file.


    contact-import-exampleEsempio di file

In questo esempio, l'oggetto importato sono i contatti. Ogni riga rappresenta un record di contatto e ogni colonna di informazioni rappresenta una proprietà del contatto

(Nome, Cognome, Indirizzo e-mail).
  • 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 associare due record diversi (ad esempio, importare "Tom Smith" e associarlo alla sua azienda "Smith Inc.") o per evitare di creare record duplicati (ad esempio, due record per "Tom Smith"). Gli identificatori unici utilizzati per l'importazione in HubSpot sono:
    • Email: l'indirizzo email di un contatto. È necessario quando si importano i contatti per evitare duplicati o per associare i contatti a un altro oggetto. Se non si dispone di indirizzi e-mail 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 quando si importano le aziende per evitare duplicati o per associare le aziende a un altro oggetto. Se non si dispone di nomi di dominio aziendali, 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 si esportare i record esistenti da HubSpot, ogni record avrà un ID record. Si tratta di una colonna obbligatoria quando si importano e si associano offerte o biglietti esistenti a un altro tipo di oggetto, ma può anche essere utilizzata come identificatore univoco per i contatti e le aziende se non si dispone di e-mail o nomi di dominio aziendali.
  • Etichetta di associazione ( solo perProfessional ed Enterprise ): un valore che specifica la relazione tra i record. Una volta create le etichette di associazione, è possibile importarle con i record.
  • Mappatura delle colonne: fase del processo di importazione in cui viene richiesto di far corrispondere le intestazioni delle colonne del file alle proprietà di HubSpot.

Ad esempio, si desidera importare e associare contatti e aziende in un unico file. Gli oggetti da importare e associare sono contatti e aziende. Ogni riga rappresenta un record di contatto e un record di azienda associato. Ogni intestazione di colonna rappresenta le proprietà che verranno mappate durante l'importazione. Il file mostrato di seguito include le proprietà del contatto (Nome, Cognome, Indirizzo e-mail, Numero di telefono, Cibo preferito) e le proprietà dell'azienda (Nome, Nome dominio dell'azienda). C'è anche un identificatore unico per ogni oggetto che collegherà i due record unici in HubSpot (indirizzo e-mail per i contatti e nome del dominio aziendale per le aziende). Durante il processo di importazione, si mapperanno le colonne alle proprietà di HubSpot (la colonnaNome alla proprietà Nome

di HubSpot).

import-contacts-and-companies-exampleEsempio di file

import-mapping-examplesMappatura delle colonne alle proprietà

Requisiti per l'importazione

Requisiti dei file

Tutti i file importati in HubSpot devono:
  • Essere un file .csv, .xlsx o .xls.
  • Avere un solo foglio.
  • Contenere meno di 1.048.576 righe e 1.000 colonne.
  • Essere più piccolo di 512 MB.
  • Includere una riga di intestazione in cui ogni intestazione di colonna corrisponde a una proprietà di HubSpot. Le intestazioni delle colonne possono essere organizzate in qualsiasi ordine senza influenzare l'importazione. È possibile verificare se esiste già una proprietà predefinita che corrisponde all'intestazione o creare una proprietà personalizzata prima dell'importazione. Per saperne di più sulle proprietà predefinite di HubSpot per contatti, aziende, offerte e biglietti.
  • Essere codificati UTF-8 se sono inclusi caratteri di lingue straniere.
  • Contenere celle in formato numero se si importano proprietà di data e ora in un file Excel.
  • Contengono solo dati di valuta formattati in USD con decimali (ad es. 123,45).

Requisiti delle proprietà

  • A seconda dell'oggetto o degli oggetti da importare, il file deve includere le seguenti colonne:
    • Contatti: almeno uno tra Nome, Cognome, Email o ID record.
    • Aziende: almeno uno tra Nome, Nome dominio dell'azienda o ID record.
    • Offerte: Nome dell'affare o ID record e, se si stanno creando nuovi affari, Pipeline e Fase dell'affare.
    • Biglietti: Nome del biglietto o ID record e, se si stanno creando nuovi biglietti, Pipeline e Stato del biglietto.
    • Prodotti: Nome o ID record e Prezzo unitario.
    • Note: Data dell'attività e Corpo della nota.
    • Voci di linea: Nome, Quantità, Prezzo e ID record o nome dell'affare associato. Includere l' ID prodotto del prodottose si sta associando la voce a un prodotto, che verrà mappato come proprietà della voce durante l'importazione.

Nota bene: è possibile importare per creare nuove voci, ma non è possibile aggiornare le voci esistenti tramite l'importazione. Quando si importano voci di riga associate a transazioni, l'importazione non aggiorna l'importo della transazione associata. Se si desidera aggiornare le voci esistenti o l'importo del deal associato, è possibile modificare manualmente le voci o associare le voci a un deal in HubSpot.

  • Per aggiornare i record esistenti ed evitare i record duplicati, i file devono includere una proprietà di identificazione univoca per ogni oggetto. Per tutti gli oggetti, è possibile esportare i record esistenti e utilizzare l' IDrecord come identificatore univoco. Per i contatti, è possibile utilizzare anche l'e-mail. Per le aziende, è possibile utilizzare anche ilnome di dominio dell'azienda.
    • Se si importano più oggetti e si includono gli ID record, si consiglia di differenziare le intestazioni delle colonne del file per far corrispondere l'ID all'oggetto corretto (ad esempio, una colonna denominata ID record - Contatti e un'altra denominata ID record - Aziende).
    • È possibile utilizzare un'e-mail secondaria come identificatore univoco per i contatti esistenti che hanno un indirizzo e-mail secondario elencato in HubSpot. Se si utilizza un'e-mail secondaria e non si include la colonna ID record nel file, l'e-mail secondaria non sostituirà l'e-mail primaria. Tuttavia, se si includono sia l'email secondaria che l' ID record come colonne nel file, l'email secondaria sostituirà l'email primaria.
  • Per le proprietà del contatto Numero di telefono e Numero di cellulare, per importare e formattare automaticamente il numero di telefono in base al codice paese, formattare come +[codice paese][numero]. Se c'è un'estensione, aggiungere ext[numero]. Ad esempio, un numero di telefono con il prefisso degli Stati Uniti sarà +11234567890 ext123.
  • Per le proprietà contenenti un prezzo, è necessario utilizzare una delle valute accettate da HubSpot. L'elenco delle valute accettate e dei relativi codici valuta si trova nella schedaValuta delle impostazioni predefinite dell'account.
  • Per le proprietà contenenti una data, i valori della data devono essere formattati come uno dei seguenti:
    • mm/gg/aaaa (ad esempio, 28/10/2020)
    • gg/mm/aaaa (ad esempio, 28/10/2020) o
    • aaaa-mm-gg (ad esempio, 2020-10-28).

Nota bene: se si importa una proprietà data predefinita di HubSpot (ad esempio, la data di chiusura), i valori devono essere formattati come timestamp UNIX in millisecondi. Le celle della proprietà data-ora devono essere in formato Numero se si importa un file Excel. Per saperne di più su come formattare i valori dei timestamp e su come convertire una data in formato UNIX.

  • Per assegnare un proprietario ai contatti, alle aziende, alle offerte o ai biglietti durante l'importazione, includere un'intestazione [Oggetto] proprietario e aggiungere il nome o l'indirizzo e-mail dell'utente a ogni riga della colonna. Gli utenti a cui viene assegnato un record tramite l'importazione non riceveranno una notifica di assegnazione di un nuovo record.
  • A seconda del tipo di campo della proprietà, esistono requisiti di formattazione specifici:
  • Quando si importano prodotti( soloProfessional ed Enterprise ):
    • Se si desidera importare il valore di una proprietà Termine, formattare il valore nella colonna Termine come PXM, dove X è il numero di mesi (ad esempio, P6M, per un termine di 6 mesi) o PXY, dove X è il numero di anni (ad esempio, P1Y, per un termine di 1 anno).
    • Se si desidera importare un valore della proprietà Frequenza di fatturazione, utilizzare mensile, annuale o trimestrale se il prodotto ha un tipo di prezzo ricorrente. Lasciare la cella vuota se il prodotto ha un prezzo unico.

Requisiti dell'associazione

  • Per importare e associare più oggetti in un unico file, includere le informazioni sui record associati nella stessa riga. In due file, utilizzare una colonna comune per collegare i record in ciascun file. Per ulteriori informazioni sull'importazione e l'associazione dei record, consultare i file di esempio .
  • Per associare un record a più record di un altro oggetto, includere l' identificatore univoco del record in più righe per ogni record che si desidera associare. Ad esempio, Luke Danes è un manager di Luke's Diner, ma un appaltatore di The Dragonfly Inn. Per associarlo a entrambe le aziende, è necessario includere due righe per Luke Danes con le colonne Email (o ID record) e Nome dominio azienda (o ID record) per ciascuna azienda.

Nota bene: senon si includono identificatori univoci (ad esempio, e-mail, nome di dominio della società, ID record ), l'importazione creerà record duplicati invece di associarli allo stesso record. Per saperne di più su come importare e associare più oggetti.


flex-associations-import-example

  • Per importare le etichette di associazione(solo Professional ed Enterprise ), includere una colonna Etichetta di associazione. È necessario creare le etichette di associazione in HubSpot prima dell'importazione.
    • Per impostare più etichette per descrivere la relazione tra due record, è possibile includere più valori di etichetta di associazione in una cella, separati da un punto e virgola (ad esempio, Manager; Contatto di fatturazione).
    • Se si importano le etichette di associazione in un' importazione di più file, è necessario includere la colonna Etichetta di associazione e un identificatore univoco per l'oggetto che si sta associando nello stesso file.
  • Per creare associazioni tra aziende figlio e genitore tramite l'importazione, includere una colonna Azienda genitore nel file di importazione con i valori dell' ID record delle aziende genitore. Per saperne di più sull' importazione di aziende figlie.

File di importazione di esempio

I file seguenti includono le intestazioni di colonna necessarie per ogni tipo di oggetto, oltre a possibili intestazioni aggiuntive. È possibile aggiungere intestazioni di colonna personalizzate per aggiornare o creare proprietà aggiuntive importanti per la gestione del database HubSpot dell'organizzazione.

Un oggetto

  • Foglio di calcolo di esempio dei contatti: XLSX o CSV
  • Foglio di calcolo di esempio delle aziende: XLSX o CSV
  • Foglio di calcolo di esempio delle trattative: XLSX o CSV
  • Foglio di calcolo di esempio per i biglietti: XLSX o CSV
  • Foglio di calcolo di esempio dei prodotti: XLSX o CSV

Una volta che il vostro file è pronto, imparate come importare un oggetto

in HubSpot.

Nota bene: i prodotti possono essere importati solo in un'importazione di un singolo oggetto. È possibile associare un prodotto esistente a una voce di linea o associare manualmente un prodotto a un accordo o a un preventivo

.

Oggetti multipli con associazioni

È possibile importare e associare gli oggetti

in un unico file o in due file separati, dove ogni file rappresenta un oggetto.

Importare più oggetti in un unico file

Per importare e associare più oggetti in un unico file, includere i record che si desidera associare nella stessa riga del file. Questi file di esempio rappresentano casi d'uso comuni, ma è possibile combinare gli oggetti sostituendo le intestazioni delle colonne con le proprietà di un altro oggetto.

  • Foglio di calcolo di esempio Contatti e aziende: XLSX o CSV.
  • Foglio di calcolo di esempio per contattie aziende con etichette di associazione: XLXS o CSV.
  • Foglio di calcolo di esempio per contatti e biglietti: XLSX o CSV.
  • Foglio di calcolo di esempio per aziende e offerte: XLSX o CSV.
  • Foglio di calcolo di esempio per aziende e note: XLSX o CSV.
  • Foglio di calcolo di esempio per aziende, transazioni e note: XLSX o CSV.
  • Foglio di calcolo di esempio delletransazioni e delle nuove voci di linea (con i prodotti associati) : XLSX o CSV. Quando si importa in un file, è possibile importare solo una voce per ogni transazione.

Importazione di più oggetti in due file

Quando si importa e si associa in due file, ogni file rappresenta un oggetto.Per identificare i record da associare nei due file, includere una colonna comune in entrambi. Uno dei due file deve avere un valore unico per ogni riga di questa colonna. Nell'altro file, utilizzare questi valori per indicare a quale record deve essere associata ogni riga.

Ad esempio, un caso d'uso comune è quello di importare e associare contatti e aziende. Nei seguenti file di esempio, il nome della società è la colonna comune:

  • Foglio di calcolo di esempio Aziende: XLSX o CSV.

  • Foglio di calcolo di esempio Contatti: XLSX o CSV.

Nel file delle aziende, per ogni riga della colonna Nome azienda c'è un valore univoco. In ogni riga del file dei contatti, i valori della colonna Nome società corrispondono alla società a cui il contatto sarà associato. È possibile utilizzare questi file per l'importazione di contatti e aziende, oppure combinare altri oggetti, purché si includa una colonna comune.

  • Le aziende con etichette di associazione in due file:in questi file di esempio, il nome dell'azienda è la chiave univoca per l'oggetto Azienda.
    • Foglio di calcolo di esempio: XLSX o CSV.
    • Foglio di calcolo di esempio delle aziende: XLSX o CSV.
  • Trattative e nuove voci di riga in due file: in questi file di esempio, il nome della trattativa è la chiave univoca dell'oggetto Trattativa. Quando si importa in due file, è possibile importare più voci per ogni transazione.
    • Foglio di calcolo di esempio delletransazioni: XLSX o CSV.
    • Foglio di calcolo di esempio dellevoci di linea (con i prodotti associati): XLSX o CSV.

Una volta che i file sono pronti, imparate come importare e associare più oggetti

in HubSpot.
How to Import Your Contacts into HubSpot CRM
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.