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.

Impostazione dei file di importazione

Ultimo aggiornamento: dicembre 3, 2024

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

Tutti i prodotti e i piani

Prima di importare i dati in HubSpot, è bene verificare i limiti e i requisiti indicati di seguito. È inoltre possibile accedere a file di esempio o generare file di esempio per iniziare.

Per saperne di più sullo strumento di importazione, consultare questo articolo. Se il vostro file è pronto, imparate a importare.

Requisiti e limiti tecnici

Tutti i file importati in HubSpot devono:
  • Essere un file .csv, .xlsx o .xls.
  • Avere un solo foglio.
  • 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ù sui requisiti delle proprietà.

column-headers

Lo strumento di importazione presenta ulteriori limiti tecnici a seconda del vostro abbonamento a HubSpot. Tali limiti comprendono le dimensioni e le righe di un file di importazione, nonché il numero di file e righe che è possibile importare al giorno.

  • Se si utilizzano gli strumenti gratuiti di HubSpot, è possibile:
    • Importare file fino a 20 MB.
    • Completare fino a 50 importazioni al giorno.
    • Importare fino a 500.000 righe al giorno. Se importate un file contenente più di 500.000 righe, il completamento richiederà più giorni.
  • Se il vostro account ha un abbonamento Starter, Professional o Enterprise, potete:
    • Importare file fino a 512 MB.
    • Completare fino a 500 importazioni al giorno.
    • Importare fino a 10.000.000 di righe al giorno, con un limite di 1.048.576 righe per file. Se si importa tramite l'API delle importazioni, è possibile importare fino a 80.000.000 di righe al giorno.

Questi limiti si applicano a un periodo mobile di 24 ore e non si azzerano a un'ora specifica del giorno. Per saperne di più sull'abbonamento a HubSpot e sulle sue limitazioni.

Formattazione dei valori

Per ogni riga del file di importazione, è possibile aggiungere valori per le colonne delle proprietà. La formattazione di un valore dipende dal tipo di campo proprietà e dall'obiettivo dell'importazione.

Formattazione dei valori in base al tipo di campo della proprietà

A seconda del tipo di campo della proprietà, esistono requisiti specifici di formattazione:

Tipo di campo Requisiti

Selezionatore di data

Selezionatore di data e ora

I mesi possono essere un numero, tre lettere o un nome completo (10, OCT, Oct, OCTOBER, October), gli anni possono essere di due o quattro cifre (2023, 23) e i separatori possono essere una barra in avanti, un trattino o un punto (10/28/2023, 10-28-2023, 10.28.2023).

I formati di data validi sono giorno mese anno (ad esempio, 28/10/2023), mese giorno anno (ad esempio, 10-28-23) o anno mese giorno (ad esempio, 2023.OCT.28).

Se sono state impostate delle regole di convalida, i valori importati devono seguire tali regole, altrimenti non verranno importati.

Selezionatore di data e ora

I timestamp possono essere aggiunti come hh:mm (28/10/2020 14:30) in tutti i tipi di file o come timestamp UNIX in millisecondi nei file CSV o in un file Excel con celle nel formato Numero di testo. Se non si include un timestamp, l'ora è impostata a mezzanotte per impostazione predefinita.

Durata

Per le proprietà che contengono una durata, come la proprietà Chiamata, i valori devono essere formattati come timestamp UNIX in millisecondi. Per saperne di più su come formattare i valori timestamp e su come convertire una data in formato UNIX.

Enumerazione

I valori del file di importazione devono corrispondere all'etichetta o al valore interno delle opzioni definite della proprietà. Per le proprietà di enumerazione predefinite di HubSpot (ad esempio, Fase del ciclo di vita, Proprietà), i valori devono corrispondere al valore interno o all'etichetta in inglese.

File

Per aggiungere file esistenti a una proprietà, includere l'ID del file come valore. L'ID di un file si trova nella sezione Generale dei dettagli di un file.

Caselle di controllo multiple

Per importare più valori, aggiungere un punto e virgola tra ogni valore senza spazi (valore 1; valore 2). Queste opzioni di proprietà devono essere create prima dell'importazione.

Per aggiungere o aggiungere valori, aggiungere un punto e virgola prima del primo valore (;valore 3;valore 4). In questo modo il valore verrà aggiunto invece di sovrascrivere il valore della proprietà esistente.

Numero

Formatta il valore in base al tipo di proprietà numerica creata:

  • Valuta: per le proprietà contenenti un importo in valuta o 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 l'USD, i dati relativi alla valuta devono essere formattati utilizzando i decimali (ad esempio, 123,45)
  • Percentuale: formattare i valori con il segno % o come decimale. Ad esempio, per importare 25%, la cella deve contenere 25% o .25.
  • Numero di telefono: 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 è presente un'estensione, aggiungere ext[numero]. Ad esempio, un numero di telefono con il prefisso degli Stati Uniti sarà +11234567890 ext123.
Se sono state impostate delle regole di convalida, i valori importati devono seguire tali regole, altrimenti non saranno importati.

Casella di controllo singola

Creare una colonna per il campo casella di controllo singola e impostare il valore di ogni riga su Vero o per visualizzarlo come Sì o spuntato in HubSpot o Falso o No per visualizzarlo come No o non spuntato in HubSpot.

Testo

Se sono state impostate delle regole di convalida, i valori importati devono seguire tali regole, altrimenti non verranno importati.

Proprietario (User)

Per assegnare un proprietario a un record o a un'attività durante l'importazione:
  • Per gli oggetti, includere un'intestazione Proprietario [Oggetto]. Per le attività, includere un'intestazione Attività assegnata a.
  • Aggiungere il nome dell'utente, l'indirizzo e-mail o il valore interno della proprietà Proprietario a ogni riga della colonna. Se nell'account sono presenti più utenti con lo stesso nome, si consiglia di utilizzare l'indirizzo e-mail o il valore interno della proprietà Proprietario.
I proprietari assegnati tramite importazione non riceveranno una notifica di assegnazione di un nuovo record/attività.

Ulteriori domini e-mail o aziendali di contatto

Se si importano contatti con più di un indirizzo e-mail, includere una colonna Indirizzi e-mail aggiuntivi con i loro indirizzi e-mail secondari. Se si importano aziende con più di un nome di dominio, includere una colonnaDomini aggiuntivi con i loro domini secondari. Per includere più domini e-mail o domini in una cella, separare i valori con un punto e virgola (ad esempio, email@email.com; emailtwo@email.com).

Se si importa per creare contatti o aziende, non è possibile impostare il Dominio e-mail di un nuovo contatto o il nome di dominio dell'Azienda di una nuova azienda su un'e-mail o un dominio aggiuntivo esistente per un altro record.

Celle vuote

Lo strumento di importazione ignora le celle vuote in un foglio di calcolo, quindi quando si importano i dati di una nuova proprietà, lasciare le celle vuote per i record senza un valore per la proprietà. Se un record esistente ha già un valore per la proprietà all'interno di HubSpot, le celle vuote saranno non cancella il valore della proprietà esistente. Per cancellare in blocco i valori delle proprietà esistenti, è possibile modificare manualmente i valori o utilizzare la funzione Azione del flusso di lavoro perla cancellazione del valore della proprietà .

Collaboratori della Trattativa

Se si aggiungono collaboratori a una trattativa tramite l'importazione, si deve includere un'opzione Collaboratore della Trattativa intestazione. Per ogni cella, è necessario includere due o più utenti, separati da un punto e virgola (ad esempio, user1@example.com;user2@example.com).

Durata del prodotto e frequenza di fatturazione

Se si importa il valore di una proprietà Termine, è possibile formattare il valore nella colonna Termine come un numero in mesi (ad esempio, 10 per 10 mesi), 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 importa 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.

Proprietà richieste

A seconda degli oggetti o delle attività che si stanno importando, le seguenti proprietà sono necessarie per creare i record e devono essere incluse come intestazioni delle colonne nei file. Se si aggiornano i record, è necessario includere un identificatore univoco (ad esempio, ID record, Dominio e-mail, Nome dominio dell'azienda).

Anche senon è obbligatorio, è possibile importare proprietà aggiuntive per ogni oggetto, comprese quelle personalizzate e predefinite. Si vedano le proprietà predefinite per contatti, aziende, trattative, ticket, chiamate, e-mail, riunioni, note e attività. È inoltre possibile visualizzare tutte le proprietà e i relativi valori nelle impostazioni delle proprietà.

  • Contatti: almeno uno tra Nome, Cognome o Email.
  • Aziende: almeno una delle seguenti opzioni Nome o Nome di dominio dell'azienda.
  • Trattative: se si creano nuove trattative, Nome della trattativa, Pipeline e Fase della trattativa.
  • Ticket: se si creano nuovi ticket, nome del ticket, pipeline e stato del ticket.
  • Appuntamenti: Inizio appuntamento. L'inizio dell'appuntamento deve essere formattato come proprietà data-ora.
  • Corsi: Nome del corso.
  • Inserzioni: Nome.
  • Servizi: Nome, Pipeline e Fase della pipeline.
  • Prodotti: se state creando dei prodotti, Prezzo unitario e Nome.
  • Voci: Nome, Quantità, Prezzo e ID record della trattativa o nome della trattativa associata. Includere l' ID prodotto del prodotto se si sta associando la voce a un prodotto, che verrà mappato come proprietà del prodotto durante l'importazione.

Nota bene: quando si importano voci con trattative, l'importazione non aggiorna l'importo della trattativa. Per aggiornare l'importo della trattativa associata, è possibile modificare manualmente le voci o associare le voci a una trattativa in HubSpot.


  • Chiamate: Note sulle chiamate. Quando si importano nuove chiamate, si consiglia di includere anche la data dell'attività.
  • Email: Corpo dell'e-mail e direzione dell'e-mail.
  • Riunioni: Descrizione delle riunioni, ora di inizio della riunione e ora di fine della riunione. Quando si importano nuove Riunioni, si consiglia di includere anche la data dell'attività. I valori dell'ora di inizio, dell'ora di fine e della data dell'attività devono essere formattati come proprietà data-ora.
  • Note: Corpo della nota.
  • Attività: Titolo dell'attività e Data di scadenza. La data di scadenza deve essere formattata come proprietà data-ora.

Nota bene: anche se non è obbligatorio, si consiglia di includere la data dell'attività quando si importano nuove attività, per specificare la data e l'ora in cui un'attività si è verificata. Se non si include questa proprietà, i valori della data dell'attività vengono impostati automaticamente alla data e all'ora dell'importazione.


Requisiti per aggiornare i record esistenti o evitare i duplicati

Per aggiornare i record esistenti ed evitare i 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' ID record come identificatore univoco, oppure utilizzare un oggetto personalizzato che richiede valori univoci. Per i contatti, è possibile utilizzare anche Email. Per le aziende, è possibile utilizzare anche il nome di dominio dell'Azienda.

Se si importano più oggetti e si includono gli ID dei record, si consiglia di differenziare le intestazioni delle colonne del file per far corrispondere l'ID all'oggetto corretto (ad esempio, una colonna chiamata ID del record - Contatti e un'altra chiamata ID del record - Aziende).

Nota: il seguente comportamento si applica se il dominio e-mail o il nome del dominio dell'azienda sono inclusi nel file:

  • Se si utilizza una proprietà valore univoco personalizzata per deduplicare i contatti, la proprietà Email continuerà a richiedere valori univoci.
  • Se si utilizza una proprietà personalizzata a valore univoco per deduplicare le aziende, la proprietà Nome dominio dell'azienda non richiederà valori univoci. Ciò significa che è possibile importare domini di aziende duplicati. Se non si vogliono più aziende con lo stesso dominio, è necessario rimuovere i domini duplicati dal file prima dell'importazione, oppure utilizzare il nome del dominio dell'Azienda come identificatore univoco.
  • È 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 Record ID 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.

Requisiti per l'associazione dei record

Importazione di associazioni in un unico file

In un file è possibile associare due o più record per riga. Includere le informazioni sui record e/o sulle attività associate nella stessa riga e includere un identificatore unico per ogni oggetto. Per associare un record a più attività o record di un altro oggetto, includere l'identificatore univoco del record in più righe per ogni record da associare.

Ad esempio, Luke Danes è un manager del Luke's Diner, ma un appaltatore del Dragonfly Inn. Per associarlo a entrambe le aziende, è necessario includere due righe per Luke Danes con le colonne Dominio e-mail (o ID record) e Nome dominio dell'azienda (o ID record) per ciascuna azienda.

Attenzione: se non si includono identificatori univoci (ad esempio, Dominio e-mail, nome di dominio dell'azienda, ID Record), l'importazione creerà record duplicati invece di associarli allo stesso record.

flex-associations-import-example

Se si importano associazioni di oggetti uguali, ci sono ulteriori requisiti.

Importare le associazioni in due file

Per associare i record di due oggetti 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.

Stesse associazioni di oggetti

È possibile importare un file per associare in blocco record dello stesso oggetto. Durante il processo di importazione, è necessario selezionare una casella di controllo per includere le associazioni dello stesso oggetto.

Quando si imposta il file, includere le informazioni sui record associati nella stessa riga e includere un identificatore unico per ogni record. I seguenti requisiti aggiuntivi sono specifici per le importazioni dello stesso oggetto:

  • Almeno un record di una coppia di record deve essere già presente in HubSpot prima dell'importazione. Ad esempio, è possibile importare un nuovo contatto e associarlo a un contatto esistente, ma non è possibile importare per creare e associare due nuovi contatti.
  • Quando si associano contatti/aziende esistenti, è possibile utilizzare solo ildominio e-mail o aziendale primario come identificatore univoco. I domini e-mail o i domini secondari non sono supportati.
  • Se si associano più record a un record, separare i valori degli identificatori unici dei record con un punto e virgola nella stessa cella (ad esempio, luke@lukesdiner.com; rory@yale.edu; sookie@dragonfly.com).

Nel file di esempio qui sotto, Rory e Jackson sono nuovi contatti che vengono associati con etichette uniche a contatti esistenti, utilizzando i loro valori di e-mail come identificatore unico. Sookie è un contatto esistente che viene associato a due contatti esistenti con la stessa etichetta. Nella prima riga, l'etichetta di associazione fa parte di una coppia di etichette, il che significa che una volta completata l'importazione, il record associato avrà l'etichetta Genitore e Rory avrà l'etichetta abbinata, Figlio.

associate-contacts-file

Associazioni genitori/figli

Per creare associazioni tra società controllate e società madri tramite l'importazione, si veda la sezione Importazione di società controllate.

Etichette di associazione personalizzate( soloProfessional ed Enterprise )

Per importare le etichette di associazione, includere una colonna Etichetta di associazione . Le etichette di associazione devono essere create in HubSpot prima di essere importate.

  • Per impostare l'associazione di un'azienda come primaria, includere il valore Primaria nella colonna Etichetta associazione per quella riga.
  • 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 per la fatturazione).
  • Se si importano le etichette di associazione in un' importazione di più file, è necessario includere la colonna Etichetta di associazione e un identificatore unico per l'oggetto che si sta associando nello stesso file.
  • Se si importano etichette di associazione:
    • Per le associazioni tra più oggetti, includere solo una delle etichette nella colonna Etichetta associazione. Le etichette saranno assegnate all'oggetto corretto durante il processo di importazione.
    • Per le associazioni dello stesso oggetto, il record nella colonna Associated [unique identifier] riceverà l'etichetta aggiunta nel processo di importazione o inclusa nella colonna label del file. L'altro record della riga riceverà l'altra etichetta della coppia.

File di esempio

All'inizio del processo di importazione, è possibile generare un file di esempio con le proprietà richieste per gli oggetti e le attività selezionate. Se si desidera esaminare altri esempi con proprietà aggiuntive, consultare questo articolo con i file di esempio.

How to Import Your Contacts into HubSpot CRM
L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.