Formato CSV per l'importazione di oggetti
Questo articolo ti aiuta a formattare correttamente il file CSV prima di importarlo in HITLEAD. Seguendo questa guida eviterai errori di importazione comuni, risparmierai tempo e garantirai che i tuoi dati fluiscano correttamente nel CRM.
INDICE
- Vantaggi principali della preparazione del file CSV
- Cos'è il formato CSV?
- Strutturare il file
- Paesi supportati nelle importazioni CSV
- Fusi orari supportati
- Domande frequenti
- Articoli correlati
Vantaggi principali della preparazione del file CSV
Dedicare del tempo a formattare correttamente il file CSV prima di importarlo garantisce che i dati dei tuoi Contatti siano puliti, completi e mappati con precisione.
- Riduce il rischio di errori di importazione o di caricamento fallito
- Aiuta HITLEAD a mappare automaticamente i campi durante l'importazione
- Abilita la deduplicazione dei Contatti e aggiornamenti accurati
- Supporta campi personalizzati e segmentazione avanzata
- Risparmia tempo evitando la pulizia post-importazione
- Aumenta il successo con caricamenti massivi di contatti/opportunità
Cos'è il formato CSV?
CSV sta per "Comma-Separated Values" (valori separati da virgola). È un semplice formato di file usato per archiviare dati tabulari come fogli di calcolo o database. Ogni riga in un file CSV rappresenta un singolo record, e i campi al suo interno sono separati da virgole. È uno dei formati più diffusi per importare ed esportare dati tra sistemi diversi.
- I file CSV hanno tipicamente estensione
.csv. - Puoi crearli o modificarli con strumenti come Excel, Google Sheets o Notepad.
- Assicurati che il file contenga un solo foglio per evitare problemi di importazione.
Esempio:
| First Name | Last Name | Phone | |
|---|---|---|---|
| Jane | Doe | jane@example.com | +11234567890 |
| John | Smith | john@example.com | +10987654321 |
Strutturare il file
Per garantire una mappatura accurata dei dati, struttura il file CSV con intestazioni di colonna corrispondenti ai campi standard o personalizzati in HITLEAD.
1. Formato CSV di esempio
| First Name | Last Name | Phone | Company | Tags | Status | Created Date | Additional Phone | |
|---|---|---|---|---|---|---|---|---|
| John | Doe | john@example.com | +11234567890 | ABC Corp | VIP, Lead | New | 01/01/2024 | +17877123462 |
| Jane | Smith | jane@example.com | +15556667777 | XYZ Ltd | Customer | Active | 02/02/2024 | +17877123464 |
- Ogni riga rappresenta un singolo contatto o un'opportunità.
- Ogni colonna rappresenta una proprietà distinta.
- La riga di intestazione è necessaria per mappare correttamente i campi.
2. Campi obbligatori
Almeno uno dei seguenti è richiesto per creare o aggiornare un contatto:
- First Name
- Email Address
- Phone Number
Nota: per aggiornare i Contatti, è richiesto un identificatore univoco (Contact ID, Email o Phone) in base alle impostazioni di deduplicazione. Per le Opportunità, includi l'Opportunity ID se stai eseguendo un aggiornamento. Senza di esso, ne verrà creata una nuova.
3. Formattazione dei campi
Segui queste regole di formattazione specifiche per evitare errori di importazione:
| Tipo di campo | Formati accettati / Note |
|---|---|
| Date Picker (campi data) | MM/DD/YYYY, YYYY/MM/DD, MM-DD-YYYY, YYYY-MM-DD |
| Multi-Select / Checkbox | Virgole: VIP, Lead, Punto e virgola: Gold; Silver, Punti: Yes. No ❌ Barre = Non valido |
| Single Option (Dropdown) | Un solo valore. Esempio: Blue |
| Contact Owner | FirstName LastName — es. Logan Paul |
| Tags | Virgole, punto e virgola o punti. es. Blue, Yellow, Blue; Yellow |
| Phone Number | E.164: +11234567890 (consigliato); anche 123-456-7890, (123) 456-7890 (solo USA) |
| Formati telefono non validi | 1234567, abc1234567 |
| Campi numerici | 1.23, 1234, .123 |
| Campi monetari | 1234, 1,234,234.33 |
| Contact Followers | FirstName LastName, FirstName2 LastName2 — es. Adam Smith, David Lee |
| Email aggiuntive | abc@email.com, abc1@email.com |
| Numeri di telefono aggiuntivi | +1 7877123460, +1 7877123461 |
4. Tipo e dimensione del file supportati
Il file deve soddisfare alcuni requisiti di base per un caricamento corretto.
| Requisito | Dettagli |
|---|---|
| Formato file | Solo .csv |
| Fogli consentiti | Un foglio per file |
| Dimensione massima | 30 MB |
5. Campi richiesti e opzionali per l'importazione
Includere i campi giusti aiuta HITLEAD a identificare ed elaborare i record correttamente.
| Azione di importazione | Campi richiesti/opzionali | Note |
|---|---|---|
| Nuovo contatto | Name o Email, o Phone | Almeno uno è obbligatorio |
| Aggiorna contatto esistente | Contact ID o Name/Email/Phone | Dipende dalle impostazioni sui duplicati |
| Riga di intestazione | Obbligatoria | Le intestazioni devono corrispondere ai campi esistenti o personalizzati in HITLEAD |
6. Linee guida di formattazione per tipo di campo
Per evitare errori di importazione, segui queste regole di formattazione per ogni tipo di dato nel CSV.
| Tipo di campo | Formato | Esempio | Note |
|---|---|---|---|
| Phone Number | E.164 o formati USA standard | +1 1234567890123-456-7890 | Formattazione pulita e coerente |
| Email Address | Formato standard | name@example.com | Deve includere @ e dominio |
| Date | Più formati accettati | 04/16/2025, 2025-04-16 | Scegli un formato e mantienilo |
| Multi-Select Fields | Separa con ,, ; o . | Blue, Yellow, Green | Deve corrispondere alle opzioni del campo nel CRM |
| Additional Emails | Separati da virgola | email1@example.com, email2@example.com | Aggiungi in una colonna separata |
| Additional Phones | Separati da virgola | 1234567890, 9876543210 | Aggiungi in una colonna separata |
Suggerimento: prima di importare il CSV, assicurati che i campi personalizzati siano già stati creati nel tuo account HITLEAD usando le stesse etichette e tipi di dato. Per assistenza nella creazione di campi personalizzati, consulta Panoramica dei Merge Field e delle Variabili Personalizzate.
Paesi supportati nelle importazioni CSV
Questa sezione contiene una tabella dei nomi di paese accettati durante le importazioni CSV in HITLEAD. Questi sono i valori ufficiali da usare nel file CSV quando mappi un campo paese, standard o personalizzato. Usa esattamente i nomi o i codici brevi elencati di seguito nel tuo file CSV.
- Scopo: HITLEAD valida i nomi dei paesi durante l'importazione. Se il CSV include un campo
Country, ogni riga deve corrispondere a uno dei nomi esatti in questo elenco. - Formato: Deve corrispondere esattamente — sensibile alle maiuscole e all'ortografia. Ad esempio,
United Statesè accettato, maUSAoU.S.causeranno un errore. - Uso con campi personalizzati: Se utilizzi un campo paese personalizzato, è comunque consigliato attenerti a questo elenco per mantenere la compatibilità.
| Nome paese (Codice) | Nome paese (Codice) | Nome paese (Codice) |
|---|---|---|
| Afghanistan (AF) | Albania (AL) | Algeria (DZ) |
| Andorra (AD) | Angola (AO) | Antigua and Barbuda (AG) |
| Argentina (AR) | Armenia (AM) | Australia (AU) |
| Austria (AT) | Azerbaijan (AZ) | Bahamas (BS) |
| Bahrain (BH) | Bangladesh (BD) | Barbados (BB) |
| Belarus (BY) | Belgium (BE) | Belize (BZ) |
| Benin (BJ) | Bhutan (BT) | Bolivia (BO) |
| Bosnia and Herzegovina (BA) | Botswana (BW) | Brazil (BR) |
| Brunei (BN) | Bulgaria (BG) | Burkina Faso (BF) |
| Burundi (BI) | Cabo Verde (CV) | Cambodia (KH) |
| Cameroon (CM) | Canada (CA) | Central African Republic (CF) |
| Chad (TD) | Chile (CL) | China (CN) |
| Colombia (CO) | Comoros (KM) | Congo (CG) |
| Congo (Kinshasa) (CD) | Costa Rica (CR) | Croatia (HR) |
| Cuba (CU) | Cyprus (CY) | Czech Republic (CZ) |
| Denmark (DK) | Djibouti (DJ) | Dominica (DM) |
| Dominican Republic (DO) | East Timor (TL) | Ecuador (EC) |
| Egypt (EG) | El Salvador (SV) | Equatorial Guinea (GQ) |
| Eritrea (ER) | Estonia (EE) | Eswatini (SZ) |
| Ethiopia (ET) | Fiji (FJ) | Finland (FI) |
| France (FR) | Gabon (GA) | Gambia (GM) |
| Georgia (GE) | Germany (DE) | Ghana (GH) |
| Greece (GR) | Grenada (GD) | Guatemala (GT) |
| Guinea (GN) | Guinea-Bissau (GW) | Guyana (GY) |
| Haiti (HT) | Honduras (HN) | Hungary (HU) |
| Iceland (IS) | India (IN) | Indonesia (ID) |
| Iran (IR) | Iraq (IQ) | Ireland (IE) |
| Israel (IL) | Italy (IT) | Jamaica (JM) |
| Japan (JP) | Jordan (JO) | Kazakhstan (KZ) |
| Kenya (KE) | Kiribati (KI) | Korea, North (KP) |
| Korea, South (KR) | Kosovo (XK) | Kuwait (KW) |
| Kyrgyzstan (KG) | Laos (LA) | Latvia (LV) |
| Lebanon (LB) | Lesotho (LS) | Liberia (LR) |
| Libya (LY) | Liechtenstein (LI) | Lithuania (LT) |
| Luxembourg (LU) | Madagascar (MG) | Malawi (MW) |
| Malaysia (MY) | Maldives (MV) | Mali (ML) |
| Malta (MT) | Marshall Islands (MH) | Mauritania (MR) |
| Mauritius (MU) | Mexico (MX) | Micronesia (FM) |
| Moldova (MD) | Monaco (MC) | Mongolia (MN) |
| Montenegro (ME) | Morocco (MA) | Mozambique (MZ) |
| Myanmar (MM) | Namibia (NA) | Nauru (NR) |
| Nepal (NP) | Netherlands (NL) | New Zealand (NZ) |
| Nicaragua (NI) | Niger (NE) | Nigeria (NG) |
| North Macedonia (MK) | Norway (NO) | Oman (OM) |
| Pakistan (PK) | Palau (PW) | Panama (PA) |
| Papua New Guinea (PG) | Paraguay (PY) | Peru (PE) |
| Philippines (PH) | Poland (PL) | Portugal (PT) |
| Qatar (QA) | Romania (RO) | Russia (RU) |
| Rwanda (RW) | Saint Kitts and Nevis (KN) | Saint Lucia (LC) |
| Saint Vincent and the Grenadines (VC) | Samoa (WS) | San Marino (SM) |
| Sao Tome and Principe (ST) | Saudi Arabia (SA) | Senegal (SN) |
| Serbia (RS) | Seychelles (SC) | Sierra Leone (SL) |
| Singapore (SG) | Slovakia (SK) | Slovenia (SI) |
| Solomon Islands (SB) | Somalia (SO) | South Africa (ZA) |
| South Sudan (SS) | Spain (ES) | Sri Lanka (LK) |
| Sudan (SD) | Suriname (SR) | Sweden (SE) |
| Switzerland (CH) | Syria (SY) | Taiwan (TW) |
| Tajikistan (TJ) | Tanzania (TZ) | Thailand (TH) |
| Togo (TG) | Tonga (TO) | Trinidad and Tobago (TT) |
| Tunisia (TN) | Turkey (TR) | Turkmenistan (TM) |
| Tuvalu (TV) | Uganda (UG) | Ukraine (UA) |
| United Arab Emirates (AE) | United Kingdom (GB) | United States (US) |
| Uruguay (UY) | Uzbekistan (UZ) | Vanuatu (VU) |
| Vatican City (VA) | Venezuela (VE) | Vietnam (VN) |
| Yemen (YE) | Zambia (ZM) | Zimbabwe (ZW) |
Fusi orari supportati
Usa uno dei seguenti formati di fuso orario nel tuo CSV. Sono sensibili alle maiuscole e devono corrispondere esattamente.
| Fuso orario | Fuso orario | Fuso orario |
|---|---|---|
| Etc/GMT+12 | Pacific/Midway | Pacific/Honolulu |
| America/Juneau | US/Alaska | America/Dawson |
| America/Los_Angeles | America/Phoenix | America/Tijuana |
| US/Arizona | America/Belize | America/Boise |
| America/Chihuahua | America/Denver | America/Edmonton |
| America/Guatemala | America/Managua | America/Regina |
| Canada/Saskatchewan | US/Mountain | America/Bahia_Banderas |
| America/Bogota | America/Cancun | America/Chicago |
| America/Mexico City | US/Central | America/Caracas |
| America/Detroit | America/Indiana/Indianapolis | America/Louisville |
| America/Manaus | America/New_York | America/Santiago |
| America/Santo_Domingo | America/Toronto | US/East-Indiana |
| US/Eastern | America/Argentina/Buenos_Aires | America/Glace_Bay |
| America/Montevideo | America/Sao_Paulo | Canada/Atlantic |
| America/St_Johns | Canada/Newfoundland | America/Godthab |
| America/Noronha | Etc/GMT+2 | Atlantic/Cape_Verde |
| Atlantic/Azores | UTC | Africa/Algiers |
| Africa/Casablanca | Africa/Lagos | Atlantic/Canary |
| Europe/London | Africa/Cairo | Africa/Harare |
| Europe/Amsterdam | Europe/Belgrade | Europe/Brussels |
| Europe/Madrid | Europe/Oslo | Europe/Sarajevo |
| Africa/Nairobi | Asia/Amman | Asia/Baghdad |
| Asia/Jerusalem | Asia/Kuwait | Asia/Qatar |
| Europe/Athens | Europe/Bucharest | Europe/Helsinki |
| Europe/Moscow | Asia/Baku | Asia/Dubai |
| Asia/Kabul | Asia/Tehran | Asia/Karachi |
| Asia/Yekaterinburg | Asia/Colombo | Asia/Kolkata |
| Asia/Calcutta | Asia/Kathmandu | Asia/Almaty |
| Asia/Dhaka | Asia/Rangoon | Asia/Bangkok |
| Asia/Krasnoyarsk | Asia/Irkutsk | Asia/Kuala_Lumpur |
| Asia/Shanghai | Asia/Taipei | Australia/Perth |
| Asia/Seoul | Asia/Tokyo | Asia/Yakutsk |
| Australia/Adelaide | Australia/Darwin | Asia/Vladivostok |
| Australia/Brisbane | Australia/Canberra | Australia/Hobart |
| Australia/Sydney | Pacific/Guam | Asia/Magadan |
| Pacific/Auckland | Pacific/Fiji | Pacific/Tongatapu |
Domande frequenti
D: Posso importare Contatti con più di un numero di telefono o email?
Sì! Usa colonne separate come Additional phone numbers e Additional email addresses, e separa le voci con virgole.
D: Cosa succede se includo nel CSV un campo che non esiste in HITLEAD?
Quel campo verrà ignorato, a meno che tu non lo mappi su un campo standard o personalizzato esistente durante il processo di importazione.
D: HITLEAD rileva automaticamente i duplicati?
Sì, in base alle tue impostazioni di rilevamento duplicati, può fare corrispondenza per Contact ID, telefono o email e unire o ignorare i duplicati.
D: Posso aggiornare i Contatti con un'importazione CSV?
Assolutamente. Assicurati solo di includere un campo usato nella corrispondenza dei duplicati (come Contact ID, email o telefono).
D: Devo eliminare le righe e le colonne vuote?
Sì. È consigliabile rimuovere tutti i dati non necessari per evitare comportamenti imprevisti durante l'importazione.
Articoli correlati
- Importazione di Opportunità tramite file CSV
- Risoluzione dei problemi con le importazioni massive tramite CSV
- Importazione di Contatti tramite file CSV
Questo articolo è stato utile?