- Tietämyskanta
- CRM
- Tuo ja vie
- Tuontitiedostojen määrittäminen
Tuontitiedostojen määrittäminen
Päivitetty viimeksi: 10 joulukuuta 2025
Saatavilla minkä tahansa seuraavan Tilauksen kanssa, paitsi jos toisin mainitaan:
Ennen kuin tuot tietoja HubSpotiin, varmista, että tiedostosi täyttävät vaaditut formaatti- ja tekniset rajoitukset. Jotkin rajoitukset riippuvat tilauksesta. Tutustu tuettuihin tiedostotyyppeihin, ominaisuusarvojen rakenteeseen ja muotoiluun sekä siihen, kuinka monta riviä ja tiedostoa voit tuoda tietyn ajanjakson aikana.
Tutustu tuontityökalun toimintaan ja käytä esimerkkitiedostoja tai luotuja esimerkkitiedostoja tietojen valmisteluun. Kun tiedostosi on valmis, opi tuontimenetelmä.
Tekniset vaatimukset ja rajoitukset
Kaikkien HubSpotiin tuotavien tiedostojen on:- Olla .csv-, .xlsx- tai .xls-tiedostoja.
- Sisältää vain yhden taulukon.
- Sisältää otsikkorivin, jossa kunkin sarakkeen otsikko vastaa HubSpotin ominaisuutta. Sarakkeiden otsikot voidaan järjestää missä tahansa järjestyksessä ilman, että se vaikuttaa tuontiin. Voit tarkistaa, onko otsikkoasi vastaava oletusominaisuus jo olemassa , tai luoda mukautetun ominaisuuden ennen tuontia. Lisätietoja ominaisuusvaatimuksista.

- Sisällä alle 1000 saraketta.
- Käytä UTF-8-koodausta, jos tiedostossa on vieraskielisiä merkkejä.
- Jos tuot Excel-tiedoston:
- Sisältää tietoja, jotka eivät ylitä Excelin laskentataulukon ja työkirjan enimmäisrajoja.
- Sisältää numeroformaatin soluja, kun tuot päivämäärä- ja kellonaikavalitsimen ominaisuuksia.
Tuontityökalulle on lisätekniset rajoitukset HubSpot-tilauksesi mukaan. Nämä rajoitukset koskevat tuontitiedoston kokoa ja rivien määrää sekä sitä, kuinka monta tiedostoa ja riviä voit tuoda päivässä.
- Jos käytät HubSpotin ilmaisia työkaluja, voit:
- Tuoda enintään 20 Mt:n tiedostoja.
- Tehdä enintään 50 tuontia päivässä.
- Tuoda enintään 500 000 riviä päivässä. Jos tuot tiedoston, joka sisältää yli 500 000 riviä, tuonti kestää useita päiviä.
- Jos tililläsi on Smart CRM- tai Starter-, Professional- tai Enterprise- tilaus, voit:
- Tuoda tiedostoja, joiden koko on enintään 512 Mt.
- Suorittaa jopa 500 tuontia päivässä.
- Tuoda enintään 10 000 000 riviä päivässä, rajoituksena 1 048 576 riviä tiedostoa kohti. Jos tuot tuontirajapinnan kautta, voit tuoda enintään 80 000 000 riviä päivässä.
Nämä rajoitukset koskevat 24 tunnin jaksoa, eikä niitä nollata tiettynä kellonaikana. Lue lisääHubSpot-tilauksestasi ja sen rajoituksista
.
Arvojen muotoilu
Voit lisätä arvoja ominaisuuskolumneihin jokaiselle tuontitiedoston riville. Arvon muotoilu riippuu ominaisuuskentän tyypistä ja tuonnin tavoitteesta.
Arvojen muotoilu ominaisuuskentän tyypin mukaan
Ominaisuuskentän tyypistä riippuen on tiettyjä muotoiluvaatimuksia:
| Kentän tyyppi | Vaatimukset |
| Päivämäärän valinta Päivämäärä- ja kellonaikavalitsin |
Kuukaudet voivat olla numero, kolme kirjainta tai koko nimi (10, OCT, Oct, OCTOBER, October), vuodet voivat olla kaksi- tai nelinumeroisia (2023, 23) ja erottimina voidaan käyttää kauttaviivaa, tavuviivaa tai pistettä (10/28/2023, 10-28-2023, 10.28.2023). Kelvolliset päivämäärämuodot ovat päivä kuukausi vuosi (esim. 28/10/2023), kuukausi päivä vuosi (esim. 10-28-23) tai vuosi kuukausi päivä (esim. 2023.OCT.28). Jos olet määrittänyt vahvistussäännöt, tuodut arvot on oltava sääntöjen mukaisia, muuten niitä ei tuoda. |
| Päivämäärän ja kellonajan valinta |
Aikaleimat voidaan lisätä muodossa hh:mm (28/10/2020 14:30) kaikissa tiedostotyypeissä tai UNIX-aikaleimana millisekunteina CSV-tiedostoissa tai Excel-tiedostoissa, joiden solut ovat tekstilukumuodossa. Jos et lisää aikaleimaa, aika asetetaan oletusarvoisesti keskiyöhön. |
| Kesto |
Ominaisuuksissa, jotka sisältävät keston, kuten Puhelun kesto -ominaisuus, arvojen on oltava muotoiltu UNIX-aikaleimaksi millisekunteina. Lisätietoja aikaleimien muotoilusta ja päivämäärän muuntamisesta UNIX-muotoon. |
| Luettelointi |
Tuontitiedoston arvot on muotoiltava joko ominaisuuden määriteltyjen vaihtoehtojen nimikkeiden tai sisäisten arvojen mukaisesti. HubSpotin oletusluettelointien ominaisuuksien (esim. elinkaaren vaihe, toimiala) arvot on muotoiltava sisäisten arvojen tai englanninkielisten nimikkeiden mukaisesti. |
| Tiedosto |
Jos haluat lisätä olemassa olevia tiedostoja tiedosto-ominaisuuteen, lisää tiedoston tunnus arvoksi. Tiedoston tunnus löytyy tiedoston tietojen Yleiset-osiosta. |
| Useita valintaruutuja |
Jos haluat tuoda useita arvoja, lisää jokaisen arvon väliin puolipiste ilman välilyöntejä (arvo 1;arvo 2). Nämä ominaisuusvaihtoehdot on luotava ennen tuontia. Lisää tai liitä arvoja lisäämällä puolipisteensimmäisen arvon eteen (;arvo 3;arvo 4). Tämä liittää arvon olemassa olevan ominaisuusarvon päälle sen sijaan, että se korvaisi sen. Lisätietoja useiden valintaruutujen arvojen tuonnista. |
| Numero |
Muotoile arvo luodun numeron tyypin mukaan:
|
| Yksi valintaruutu |
Luo sarake yksittäiselle valintaruudulle ja aseta jokaisen rivin arvoksi TruetaiYes, jotta se näkyy HubSpotissa Yes tai valittuna, taiFalsetaiNo,jotta se näkyy HubSpotissa No tai valitsemattomana. |
| Termiominaisuudet |
Rivikohdan ominaisuus Termi tulisi lisätä ISO-8601-ajanjakson muotoina PnYnMnD tai PnW. Esimerkiksi P12M tai P24M vuosittaisille termeille. Jos kenttä jätetään tyhjäksi, asetetaan oletusarvot. |
| Teksti |
Jos olet asettanut validointisäännöt, tuodut arvot on asetettava sääntöjen mukaisesti, muuten niitä ei tuoda. |
| Käyttäjä (omistaja) |
Omistajan määrittäminen tietueelle tai toiminnolle tuonnin aikana:
|
Lisäyhteyshenkilöiden sähköpostiosoitteet tai yritysten verkkotunnukset
Jos tuot yhteystietoja, joilla on useampi kuin yksi sähköpostiosoite, lisää sarakkeeseen Lisäsähköpostiosoitteet niiden toissijaiset sähköpostiosoitteet. Jos tuot yrityksiä, joilla on useampi kuin yksi verkkotunnus, lisää sarakkeeseenLisäverkkotunnukset niiden toissijaiset verkkotunnukset. Jos haluat lisätä useita sähköpostiosoitteita tai verkkotunnuksia soluun, erota arvot puolipisteillä (esim. email@email.com; emailtwo@email.com).
Jos tuot tietoja yhteystietojen tai yritysten luomiseksi, et voi asettaa uuden yhteystiedon sähköpostiosoitteeksi tai uuden yrityksen verkkotunnukseksi sähköpostiosoitetta tai verkkotunnusta, joka on jo olemassa olevien lisätietojen sähköpostiosoite tai verkkotunnus.
Tyhjät solut
Tuontityökalu ohittaa taulukon tyhjät solut, joten kun tuot uusia ominaisuustietoja, jätä solut tyhjiksi tietueille, joilla ei ole arvoa ominaisuudelle. Jos olemassa olevalla tietueella on jo arvo ominaisuudelle HubSpotissa, tyhjät solut eivät poista olemassa olevaa ominaisuusarvoa. Voit poistaa olemassa olevat ominaisuusarvot joukkokäsittelyllä muokkaamalla arvot manuaalisesti tai käyttämällä Muokkaa tietueita -työnkulun toimintoa .Kaupan yhteistyökumppanit
Jos lisäät yhteistyökumppaneita kauppaan tuonnin kautta, lisää Kaupan yhteistyökumppani -otsikko. Jokaiseen soluun on lisättävä vähintään kaksi käyttäjää, jotka on erotettu puolipisteillä (esim. user1@example.com;user2@example.com).Tuotteen voimassaoloaika ja laskutusväli
Jos tuot Term-ominaisuuden arvon, voit muotoilla arvon Term-sarakkeessa kuukausina (esim. 10 tarkoittaa 10 kuukautta), PXM-muodossa , jossa X on kuukausien lukumäärä (esim. P6M tarkoittaa 6 kuukauden termiä) tai PXY-muodossa, jossa X on vuosien lukumäärä (esim. P1Y tarkoittaa 1 vuoden termiä).
Jos tuot laskutustiheysominaisuuden arvon, käytä kuukausittain, vuosittain tai neljännesvuosittain, jos tuotteella on toistuva hintatyyppi. Jätä solu tyhjäksi, jos tuotteella on kertaluonteinen hinta.
Vaaditut ominaisuudet
Riippuen siitä, mitä objekteja tai aktiviteetteja tuot, seuraavat ominaisuudet ovat pakollisia tietueiden luomiseksi, ja ne on sisällytettävä tiedostojesi sarakkeiden otsikoiksi. Jos päivität tietueita, sinun on sisällytettävä yksilöllinen tunniste (esim. tietueen tunnus, sähköpostiosoite, yrityksen verkkotunnus).
Vaikkase ei ole pakollista, voit tuoda lisäominaisuuksia jokaiselle objektille, mukaan lukien mukautetut ja oletusominaisuudet. Katso oletusominaisuudet yhteystiedoille, yrityksille, kaupoille, lipuille, puheluille, sähköposteille, kokouksille, muistiinpanoille ja tehtäville. Voit myös tarkastella kaikkia ominaisuuksia ja niiden arvoja ominaisuusasetuksissa.
- Yhteystiedot: vähintään yksi seuraavista: etunimi, sukunimi tai sähköpostiosoite.
- Yritykset: vähintään yksi seuraavista: nimi tai yrityksen verkkotunnus.
Huomaa: Yrityksen verkkotunnus -ominaisuus hyväksyy vain ylätason verkkotunnuksen (esim. .com, .edu) arvoja. Arvot, joiden perässä on merkkijono (esim. .edu/home), poistetaan automaattisesti tuonnin yhteydessä.
- Kaupat: jos luot uusia kauppoja,kaupan nimi, myyntiputki ja kaupan vaihe.
- Tiketit: jos luot uusia tikettejä, tiketin nimi, myyntiputki ja tiketin tila.
- Tapaamiset: Tapaamisen alkamisaika. Tapaamisen alkamisaika tulee muotoillapäivämäärä-aika-ominaisuudeksi.
- Kurssit: Kurssin nimi.
- Listaukset: nimi.
- Palvelut: nimi, myyntiputki ja myyntiputken vaihe.
- Tuotteet: jos päivität tuotteita, tietueen tunnus tai SKU.
- Jos päivität tuotteita tilillä, jossa on yksi valuutta,yksikköhinta ja nimi.
- Jos päivität tuotteita tilillä, jossa on useita valuuttoja,hinta [valuutan lyhenne] (esim. hinta USD) ja nimi.
- Tilaukset: nimi, myyntiputki ja myyntiputken vaihe.
- Ostoskorit: nimi.
- Tuotelinjat: nimi, määrä, hinta janiihin liittyvät kaupan tunnus tai kaupan nimi. Lisää tuotteen tuote-ID , jos liität tuotelinjan myös tuotteeseen, joka määritetään tuotelinjan ominaisuudeksi tuonnin aikana.
Huomaa: kun tuot rivikohteita kaupoilla, tuonti ei päivitä kaupan summaa. Voit päivittää kaupan summan muokkaamalla rivikohteita manuaalisesti tai liittämällä rivikohteet kauppaan HubSpotissa.
- Puhelut: Puhelumuistiinpanot. Kun tuot uusia puheluita, on suositeltavaa lisätä myös Toiminnan päivämäärä.
- Sähköpostit: Sähköpostin tekstija sähköpostin suunta.
- Kokoukset:Kokouksen kuvaus, kokouksen alkamisaika ja kokouksen päättymisaika. Uusia kokouksia tuotaessa on suositeltavaa lisätä myös Toiminnan päivämäärä. Aloitusajan, lopetusajan ja aktiviteetin päivämäärän arvot tulee muotoilla päivämäärä-aika-ominaisuuksiksi.
- Muistiinpanot: Muistiinpanon teksti.
- Tehtävät:Tehtävän otsikkojamääräaika. Määräaika tulee muotoilla päivämäärä-aika-ominaisuudeksi.
Huomaa: Vaikka se ei ole pakollista, on suositeltavaa lisätä toiminnan päivämäärä, kun tuodaan uusia toimintoja, jotta voidaan määrittää toiminnan päivämäärä ja kellonaika. Jos tätä ominaisuutta ei lisätä, toiminnan päivämääräarvot asetetaan automaattisesti tuonnin päivämääräksi ja kellonajaksi.
Vaatimukset olemassa olevien tietueiden päivittämiseksi tai päällekkäisyyksien välttämiseksi
Olemassa olevien tietueiden päivittämiseksi ja päällekkäisyyksien välttämiseksi tiedostoissasi on oltava jokaiselle objektille yksilöllinen tunnisteominaisuus. Kaikille objekteille voit viedä olemassa olevat tietueet ja käyttää tietueen tunnusta yksilöllisenä tunnisteena tai käyttää mukautettua ominaisuutta, joka vaatii yksilöllisiä arvoja. Yhteystietojen osalta voit käyttää myös sähköpostiosoitetta. Yritysten osalta voit käyttää myös yrityksen verkkotunnusta .
Jos tuot useita objekteja ja lisäät tietueiden tunnukset, on suositeltavaa erotella tiedoston sarakkeiden otsikot, jotta tunnus voidaan yhdistää oikeaan objektiin (esim. yksi sarake nimeltä Tietueen tunnus – Yhteystiedot ja toinen nimeltä Tietueen tunnus – Yritykset).
Huomaa:seuraava käytäntö koskee tapauksia, joissa tiedostossa on sähköpostiosoite tai yrityksen verkkotunnus :
- Jos käytät mukautettua yksilöllistä arvoa kontaktien päällekkäisyyksien poistamiseen, sähköpostiosoite -ominaisuus vaatii edelleen yksilöllisiä arvoja.
- Jos käytät mukautettua yksilöllistä arvoa yritysten poistamiseen, yrityksen verkkotunnusominaisuus ei vaadi yksilöllisiä arvoja. Tämä tarkoittaa, että voit tuoda päällekkäisiä yritysten verkkotunnuksia. Jos et halua useita yrityksiä, joilla on sama verkkotunnus, sinun tulee poistaa päällekkäiset verkkotunnukset tiedostosta ennen tuontia tai käyttää yrityksen verkkotunnusta yksilöllisenä tunnisteena.
- Voit käyttää toissijaista sähköpostiosoitetta yksilöllisenä tunnisteena olemassa oleville yhteystiedoille, joilla on toissijainen sähköpostiosoite HubSpotissa. Jos käytät toissijaista sähköpostiosoitetta etkä sisällytä tiedostoon RecordID -saraketta, toissijainen sähköpostiosoite ei korvaa ensisijaista sähköpostiosoitetta. Jos kuitenkin sisällytät tiedostoon sekä toissijaisen sähköpostiosoitteen että Record ID -sarakkeen, toissijainen sähköpostiosoite korvaa ensisijaisen sähköpostiosoitteen.
Tietueiden yhdistämisen vaatimukset
Tuo yhdistelmät yhdessä tiedostossa
Yhdessä tiedostossa voit yhdistää kaksi tai useampia tietueita riviä kohden. Lisää tiedot yhdistetyistä tietueista ja/tai toiminnoista samaan riviin ja lisää yksilöllinen tunniste jokaiselle objektille. Jos haluat yhdistää yhden tietueen useisiin toimintoihin tai toisen objektin tietueisiin, lisää tietueen yksilöllinen tunniste useisiin riveihin jokaiselle tietueelle, jonka haluat yhdistää.
Esimerkiksi Luke Danes on johtaja Luke's Diner -ravintolassa, mutta urakoitsija The Dragonfly Inn -majatalossa. Yhdistääksesi hänet molempiin yrityksiin, sinun on lisättävä kaksi riviä Luke Danesille sarakkeisiin Sähköposti (tai tietueen tunnus) ja Yrityksen verkkotunnus (tai tietueen tunnus) kummallekin yritykselle.
Huomaa: jos et lisää yksilöllisiä tunnisteita (esim. Sähköposti, Yrityksen verkkotunnus, Tietueen tunnus), tuonti luo kaksoiskappaleita sen sijaan, että yhdistäisi kunkin samaan tietueeseen.

Jos tuot samoja objektien yhdistämisiä, on lisävaatimuksia.
Tuo yhdistämiset kahdessa tiedostossa
Jos haluat yhdistää kahden tiedoston kahden objektin tietueet, käytä yhteistä saraketta yhdistämään kunkin tiedoston tietueet. Lisäohjeita tietueiden tuontiin ja yhdistämiseen löydät esimerkkitiedostoista.
Saman objektin assosiaatiot
Voit tuoda yhden tiedoston yhdistääksesi saman objektin tietueet joukkona. Tuontiprosessin aikana sinun on valittava valintaruutu, jotta saman objektin assosiaatiot sisällytetään.
Kun määrität tiedostoa, lisää tiedot assosioiduista tietueista samaan riviin ja lisää yksilöllinen tunnistejokaiselle tietueelle. Seuraavat lisävaatimukset koskevat erityisesti saman objektin tuontia:
- Ainakin yhden tietueen parista on oltava jo olemassa HubSpotissa ennen tuontia. Voit esimerkiksi tuoda uuden yhteystiedon ja liittää sen olemassa olevaan yhteystietoon, muttaet voituoda kahta uutta yhteystietoa ja liittää niitä toisiinsa.
- Kun liität olemassa olevia yhteyshenkilöitä/yrityksiä, voit käyttää vain ensisijaistasähköpostiosoitetta/yrityksen verkkotunnusta yksilöllisenä tunnisteena. Toissijaisia sähköpostiosoitteita tai verkkotunnuksia ei tueta.
- Jos liität useita tietueita yhteen tietueeseen, erota tietueiden yksilölliset tunnistearvot puolipisteellä samassa solussa (esim.luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com).
Alla olevassa esimerkkitiedostossa Rory ja Jackson ovat uusia yhteystietoja, jotka liitetään olemassa oleviin yhteystietoihin yksilöllisillä tunnisteilla käyttäen heidänsähköpostiosoitteitaanyksilöllisenä tunnisteena. Sookie on olemassa oleva yhteystieto, joka liitetään kahteen olemassa olevaan yhteystietoon, joilla on sama tunniste. Ensimmäisellä rivillä liitostunniste on osa tunnisteparia, mikä tarkoittaa, että kun tuonti on valmis, liitetyllä tietueella on tunnisteParent ja Roryllaon paritunnisteChild.
Vanhempi/lapsiyritysten yhdistämiset
Jos haluat luoda lapsiyritysten ja emoyritysten yhdistämisiä tuonnin avulla, lue lisää lapsiyritysten tuonnista.
Mukautetut yhdistämismerkinnät
Tilaus edellytetään Mukautettujen yhdistämisen nimikkeiden käyttäminen edellyttää Professional- tai Enterprise-tilausta.
Tuo assosiaatiomerkinnät lisäämällä Assosiaatiomerkintä-sarake. Tämä sarake tulisi lisätä vain, jos haluat lisätä merkintöjä assosiaatioiden kuvaamiseksi. Jos et tarvitse assosiaatioiden merkintöjä, saraketta ei tarvita.
- Sinun on luotava yhdistelmien nimet HubSpotissa ennen tuontia.
- Jos haluat asettaa yrityksen assosiaation ensisijaiseksi, lisää arvo Ensisijainen kyseisen rivin Assosiaatiomerkki-sarakkeeseen.
- Jos haluat määrittää useita merkintöjä kuvaamaan kahden tietueen välistä suhdetta, voit lisätä useita assosiaatiomerkintöjen arvoja yhteen soluun, erotettuna puolipisteellä (esim. Johtaja; Laskutusyhteyshenkilö).
- Jos tuot assosiaatiotunnisteita usean tiedoston tuonnissa, sinun on lisättävä Assosiaatiotunniste-sarake ja yksilöllinen tunniste samassa tiedostossa assosioitavalle objektille.
- Jos tuotpariliitoksia:
- Objektien välisissä assosiaatioissa lisää vain yksi nimikkeistä Assosiaationimike-sarakkeeseen. Nimikkeet määritetään oikealle objektille tuontiprosessin aikana.
- Saman objektin assosiaatioissaAssociated [unique identifier] -sarakkeen tietue saa tuontiprosessissa lisätyntai tiedoston label-sarakkeeseen sisällytetyn etiketin. Rivin toinen tietue saa parin toisen etiketin.
Esimerkkitiedostot
Tuontiprosessin alussa voit luoda esimerkkitiedoston, jossa on valittujen objektien ja toimintojen vaaditut ominaisuudet. Jos haluat tarkastella lisää esimerkkejä, joissa on lisäominaisuuksia, katso tämä artikkeli, jossa on esimerkkitiedostoja.