Formato dei file di importazione

Prima di importare i dati in HubSpot, verifica che i tuoi file rispettino il formato richiesto e i limiti tecnici. Alcuni limiti dipendono dal tipo di abbonamento. Informati su quali tipi di file sono supportati,

su

come strutturare e formattare i valori delle proprietà e su quanti record e file puoi importare in un determinato periodo.

Prima di procedere all’importazione, consulta l’articolo “Guida introduttiva alle importazioni”.

Requisiti tecnici e limiti

• Essere file in formato .csv, .xlsx o .xls.
• Contenere un solo foglio.
• Includere una riga di intestazione in cui ogni intestazione di colonna corrisponda a una proprietà in HubSpot. Le intestazioni delle colonne possono essere organizzate in qualsiasi ordine senza influire sull’importazione. È possibile verificare se esiste già una proprietà predefinita corrispondente all ’intestazione oppure creare una proprietà personalizzata prima dell’importazione. Scopri di più sui requisiti delle proprietà.

• Contenere meno di 1.000 colonne.
• Il file deve essere codificato in UTF-8 se contiene caratteri di lingue straniere.
• Se stai importando un file Excel:
  • I dati devono rientrare nei limiti massimi previsti da Excel per i fogli di lavoro e le cartelle di lavoro.
  • Contenere celle in formato Numerico quando si importano le proprietà del selettore di data e ora.

A seconda del tuo abbonamento HubSpot, allo strumento di importazione si applicano ulteriori limiti tecnici. Questi limiti includono le dimensioni e il numero massimo di righe di un file di importazione, nonché il numero di file e righe che puoi importare al giorno.

• Se utilizzi gli strumenti gratuiti di HubSpot, puoi:
  • Importare file fino a 20 MB.
  • Eseguire fino a 50 importazioni al giorno.
  • Importare fino a 500.000 righe al giorno. I file contenenti più di 500.000 righe richiederanno diversi giorni per essere completati.
  • Avviare fino a 3 importazioni contemporaneamente. Fino a 2 di queste importazioni possono superare le 10.000 righe. Se avvii 4 o più importazioni simultanee, queste verranno messe in coda. 

• Se il tuo account dispone di Smart CRM o di un abbonamento Starter, Professional o Enterprise, puoi:
  • 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 esegue l’importazione tramite l’API di importazione, è possibile importare fino a 80.000.000 di righe al giorno.
  • Avviare fino a 3 importazioni contemporaneamente. Fino a 2 di queste importazioni possono superare le 10.000 righe. Se si avviano 4 o più importazioni simultanee, queste verranno messe in coda.

Questi limiti si applicano a un periodo di 24 ore consecutive e non vengono azzerati a un’ora specifica del giorno. Scopri di più sul tuoabbonamento HubSpot e sulle relative limitazioni.

Formattazione dei valori delle proprietà

Per ogni riga del file di importazione, puoi aggiungere valori alle colonne delle proprietà. La formattazione di un valore dipende dal tipo di campo della 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 di formattazione specifici:

Indirizzi e-mail di contatto aggiuntivi o domini aziendali

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

Se stai effettuando l’importazione per creare contatti o aziende, non puoi impostare l’indirizzo e-mail di un nuovo contatto o il nome di dominio aziendale di una nuova azienda su un indirizzo e-mail o un dominio che sia già un indirizzo e-mail o un dominio aggiuntivo esistente per un altro record.

Celle vuote

Collaboratori dell’opportunità

Durata del prodotto e frequenza di fatturazione

Se si importa un valore della proprietà “Durata”, è possibile formattare il valore nella colonna “Durata” come numero di mesi (ad es., 10 per 10 mesi), come PXM dove X è il numero di mesi (ad es., P6M, per una durata di 6 mesi) o come PXYdove X è il numero di anni (ad es., P1Y, per una durata 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 una tantum.

Includere le proprietà obbligatorie

A seconda degli oggetti o delle attività che si stanno importando, le seguenti proprietà sono obbligatorie per creare record e devono essere incluse come intestazioni di colonna nei file. Se si aggiornano i record, è necessario includere un identificatore univoco (ad es. ID record, e-mail, nome di dominio dell’azienda).

Sebbenenon sia obbligatorio, è possibile importare proprietà aggiuntive per ciascun oggetto, comprese quelle personalizzate e predefinite. Fare riferimento alle proprietà predefinite per contatti, aziende, opportunità, ticket, chiamate, e-mail, riunioni, note e attività. È inoltre possibile visualizzare tutte le proprietà e i relativi valori nelle impostazioni delle proprietà.

• Contatti: e-mail. È inoltre possibile includere Nome e Cognome comeinformazioni identificative di base.
• Aziende: almeno uno tra " Nome " o " Nome di dominio dell’azienda".

Nota: la proprietà "Nome dominio aziendale

accetta solo valori fino al dominio di primo livello (ad es. .com, .edu). I valori con stringhe successive (ad es. .edu/home) verranno automaticamente rimossi durante l’importazione. 

• Opportunità: se si stanno creando nuove opportunità,"Nome dell’opportunità", "Pipeline" e "Fase dell’opportunità"."Pipeline" e"Fase dell’opportunità " devono corrispondere alle opzioni esistenti nel proprio account e la "Fase dell’opportunità " deve essere una fase valida in quella pipeline.
• Ticket: se stai creando nuovi ticket, " Nome del ticket", "Pipeline" e "Stato del ticket".
• Appuntamenti: Inizio dell’appuntamento. L’inizio dell’appuntamento deve essere formattato comeproprietà data-ora.
• Corsi: Nome del corso.
• Annunci: Nome.
• Servizi: Nome, Pipeline e Fase della pipeline.
• Prodotti: se stai aggiornando i prodotti, ID record o SKU.
  • Se si aggiornano prodotti in un account con una sola valuta,prezzo unitario e nome.
  • Se stai aggiornando i prodotti in un account con più valute,Prezzo [abbreviazione della valuta] (ad es. Prezzo USD) e Nome.

• Ordini: Nome, Pipeline e Fase della pipeline.
• Carrelli: Nome.

• Voci d’ordine: Nome, Quantità, Prezzo e l’ID record o il nome dell’affare associato. Includi l’ID prodotto se stai associando la voce d’ordine anche a un prodotto; tale ID verrà mappato come proprietà della voce d’ordine durante l’importazione.

Nota: quando si importano voci di ordine associate a trattative, l’importazione non aggiornerà l’importo della trattativa. Per aggiornare l’importo della trattativa associata, è possibile modificare manualmente le voci di ordine o associarle a una trattativa in HubSpot.

• Chiamate: note sulle chiamate. Quando si importano nuove chiamate, si consiglia inoltre di includere Data dell’attività.
• E-mail: corpo dell’e-maile destinatario dell’e-mail.
• Riunioni:Descrizione della riunione, Ora di inizio della riunione e Ora di fine della riunione. Quando si importano nuove riunioni, si consiglia inoltre di includere la Data dell'attività. I valori relativi all’ora di inizio, all’ora di fine e alla data dell’attività devono essere formattati come proprietà data-ora.
• Note: corpo della nota.
• Attività:titolo dell'attivitàedata di scadenza. La data di scadenza deve essere formattata come proprietà data-ora.

Nota: sebbene non sia obbligatorio, si consiglia di includere la "Data dell’attività" quando si importano nuove attività per specificare la data e l’ora in cui si è svolta l’attività. Se non si include questa proprietà, i valori della "Data dell’attività" vengono automaticamente impostati sulla data e l’ora dell’importazione.

Requisiti per aggiornare i record esistenti o

evitare

duplicati

Per aggiornare i record esistenti ed evitare duplicati, i file devono includere una proprietà identificativa univoca per ciascun oggetto. Per tutti gli oggetti, è possibile esportare i record esistenti e utilizzare l’ID record come identificatore univoco, oppure utilizzare una proprietà personalizzata che richieda valori univoci. Per i contatti, è possibile utilizzare anche l’indirizzo e-mail. Per le aziende, è possibile utilizzare anche il nome 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 in modo che l’ID corrisponda all’oggetto corretto (ad esempio, una colonna denominata “ID record - Contatti” e un’altra denominata “ID record - Aziende”).

Requisiti per associare i record

Importazione di associazioni in un

unico

file

In un unico file, puoi associare due o più record per riga. Includi le informazioni relative ai record e/o alle attività associate nella stessa riga e includi un identificatore univoco per ciascun oggetto. Per associare un record a più attività o a record di un altro oggetto, includi l’identificatore univoco del record in più righe per ciascun record che desideri associare.

Ad esempio, Luke Danes è un manager presso il "Luke's Diner", ma un collaboratore esterno presso il "The Dragonfly Inn". Per associarlo a entrambe le aziende, è necessario includere due righe per Luke Danes con le colonne "E-mail" (o "ID record") e "Nome di dominio dell'azienda " (o "ID record") per ciascuna azienda.

Nota: se non si includono gli identificatori univoci (ad es. Email, Nome dominio azienda, ID record), l’importazione creerà record duplicati invece di associarli tutti allo stesso record.

Se stai importando associazioni di oggetti identici, ci sono requisiti aggiuntivi.

Importazione di associazioni in due file

Per associare i record di due oggetti presenti in due file, utilizza una colonna comune per collegare i record in ciascun file. Puoi fare riferimento ai file di esempio per ulteriore assistenza nell’importazione e nell’associazione dei record.

Associazioni

dello

stesso oggetto

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

Durante la configurazione del file, includere le informazioni relative ai record associati nella stessa riga e inserire un identificatore univocoper ciascun record. I seguenti requisiti aggiuntivi sono specifici per le importazioni dello stesso oggetto:

• Almeno un record di una coppia di record deve già esistere in HubSpot prima dell’importazione. Ad esempio, è possibile importare un nuovo contatto e associarlo a un contatto esistente, manon è possibileimportare per creare e associare due nuovi contatti.
• Quando si associano contatti/aziende esistenti, è possibile utilizzare solo l’indirizzoe-mail principale oil dominio aziendale come identificatore univoco. Gli indirizzi e-mail o i domini secondari non sono supportati.
• Se si associano più record a un unico record, separare i valori degli identificatori univoci dei record con un punto e virgola nella stessa cella (ad es.,luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com).

Nel file di esempio riportato di seguito, Rory e Jackson sono nuovi contatti associati a etichette univoche relative a contatti esistenti, utilizzando i valoridelleloroe-mailcome identificatore univoco. Sookie è un contatto esistente 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“Parent” e Roryavrà l’etichetta abbinata,“Child”.

Associazioni genitore/figlio

Per creare associazioni tra società madri e figlie tramite importazione, scopri di più sull’importazione delle società figlie.

Etichette di associazione personalizzate

Per importare le etichette di associazione, includi una colonna "Etichetta di associazione". Questa colonna deve essere aggiunta solo se desideri aggiungere etichette per descrivere le associazioni. Se non hai bisogno di etichettare le associazioni, la colonna non è necessaria.

• È necessario creare le etichette di associazione in HubSpot prima dell'importazione.
• Per impostare un'associazione aziendale come primaria, includi il valore "Primaria" nella colonna "Etichetta di associazione" per quella riga.

• Per impostare più etichette che descrivano la relazione tra due record, è possibile includere più valori di etichetta di associazione in un'unica cella, separati da un punto e virgola (ad es., Responsabile; Contatto di fatturazione).

• Se stai importando etichette di associazione tramite un'importazione da più file, devi includere la colonna "Etichetta di associazione " e un identificatore univoco per l’oggetto che stai associando nello stesso file.
• Se si importanoetichette accoppiate:
  • Per le associazioni tra oggetti diversi, includere solo una delle etichette nella colonna "Etichetta di associazione ". Le etichette verranno assegnate all'oggetto corretto durante il processo di importazione.
  • Per le associazioni tra oggetti identici, il record nellacolonna "Associato [identificatore univoco] " riceverà l’etichetta aggiunta duranteil processo di importazione o inclusa nella colonna delle etichette del file. L’altro record nella 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à selezionati. Se si desidera esaminare altri esempi con proprietà aggiuntive, consultare questo articolo con i file di esempio.

Passaggi successivi

Ora che il file di importazione è completo, seguire le istruzioni di importazione appropriate:

• Importa solo i contatti.
• Importare i record relativi a un singolo oggetto.
• Importare più oggetti e utilizzare le impostazioni avanzate.