Konfigurera importfiler
Senast uppdaterad: december 3, 2024
Tillgänglig med något av följande abonnemang, om inte annat anges:
Alla produkter och planer |
Innan du importerar data till HubSpot bör du granska följande begränsningar och krav. Du kan också få tillgång till exempelfiler eller generera exempelfiler för att komma igång.
Läs den här artikeln om du vill veta mer om importverktyget. Om din fil är klar kan du lära dig hur du importerar.
Tekniska krav och begränsningar
Alla filer som importeras till HubSpot måste:- Vara en .csv-, .xlsx- eller .xls-fil
- Har endast ett ark.
- Innehålla en rubrikrad där varje kolumnrubrik motsvarar en egenskap i HubSpot. Kolumnrubrikerna kan organiseras i valfri ordning utan att det påverkar importen. Du kan bekräfta om det redan finns en standardegenskap som matchar din rubrik eller skapa en anpassad egenskap innan du importerar. Läs mer om krav på egenskaper.
- Innehåller mindre än 1000 kolumner.
- Vara UTF-8-kodad om tecken från främmande språk ingår.
- Om du importerar en Excel-fil:
- Innehålla data som håller sig under Excels maxgränser för kalkylblad och arbetsbok.
- Innehåller celler i nummerformat när du importerar egenskaper för datum- och tidsväljare.
Det finns ytterligare tekniska begränsningar för importverktyget beroende på din HubSpot-prenumeration. Dessa begränsningar inkluderar storleks- och radgränser för en importfil, samt hur många filer och rader du kan importera per dag.
- Om du använder HubSpots gratisverktyg kan du göra det:
- Importera filer på upp till 20 MB.
- Slutföra upp till 50 importer per dag.
- Importera upp till 500 000 rader per dag. Om du importerar en fil som innehåller mer än 500 000 rader kommer det att ta flera dagar att slutföra.
- Om ditt konto har en Starter-, Professional- eller Enterprise-prenumeration kan du
- Importera filer på upp till 512 MB.
- Slutföra upp till 500 importer per dag.
- Importera upp till 10 000 000 rader per dag, med en gräns på 1 048 576 rader per fil. Om du importerar via API:et för import kan du importera upp till 80 000 000 rader per dag.
Dessa gränser gäller för en rullande 24-timmarsperiod och återställs inte vid en viss tidpunkt på dagen. Läs mer om din HubSpot-prenumeration och dess begränsningar.
Formatering av värden
För varje rad i din importfil kan du lägga till värden för kolumnerna med egenskaper. Formateringen av ett värde beror på typen av egenskapsfält och målet med importen.
Formatera värden baserat på egenskapens fälttyp
Beroende på typ av fält för egenskapen finns det specifika formateringskrav:
Typ av fält | Krav på fält |
Väljare för datum Väljare för datum och tid |
Månader kan bestå av en siffra, tre bokstäver eller ett fullständigt namn (10, OCT, Oct, OCTOBER, October), år kan bestå av två eller fyra siffror (2023, 23) och separatorer kan bestå av ett snedstreck, bindestreck eller punkt (10/28/2023, 10-28-2023, 10.28.2023). Giltiga datumformat är dag månad år (t.ex. 28/10/2023), månad dag år (t.ex. 10-28-23) eller år månad dag (t.ex. 2023.OCT.28). Om du har ställt in valideringsregler måste de importerade värdena följa reglerna, annars importeras de inte. |
Väljare för datum och tid |
Tidsstämplar kan läggas till som hh:mm (28/10/2020 14:30) i alla filtyper eller som en UNIX-tidsstämpel i millisekunder i CSV-filer eller en Excel-fil med celler i textnummerformat. Om du inte inkluderar någon tidsstämpel ställs tiden in på midnatt som standard. |
Varaktighet |
För egenskaper som innehåller en varaktighet, t.ex. egenskapen Call duration, måste värdena formateras som en UNIX-tidsstämpel i millisekunder. Läs mer om hur du formaterar tidsstämpelvärden och hur du konverterar ett datum till UNIX-format. |
Uppräkning |
Värdena i din importfil måste matcha antingen etiketten eller det interna värdet för egenskapens definierade alternativ. För HubSpots standardiserade uppräkningsegenskaper (t.ex. Livscykelfas, Egenskap) måste värdena matcha det interna värdet eller etiketten på engelska. |
Fil |
Om du vill lägga till befintliga filer i en egenskap för en fil anger du fil-ID som värde. Du hittar en fils ID i avsnittet Allmänt i filens detaljer. |
Flera kryssrutor |
Om du vill importera flera värden lägger du till ett semikolon mellan varje värde utan mellanslag (värde 1;värde 2). Dessa alternativ för egenskaper måste skapas före importen. Om du vill lägga till eller bifoga värden lägger du till ett semikolon före det första värdet (;värde 3;värde 4). Detta kommer att lägga till värdet istället för att skriva över den befintliga egenskapens värde. |
Antal |
Formatera värdet baserat på den typ av egenskap för tal som skapats:
|
Enstaka kryssruta |
Skapa en kolumn för fältet med en enda kryssruta och ange värdet på varje rad till True eller Yes för att visas som Yes eller markerad i HubSpot eller False eller No för att visas som No eller ej markerad i HubSpot. |
Text |
Om du har ställt in valideringsregler måste dina importerade värden följa reglerna, annars importeras de inte. |
Användare (Ägare) |
För att tilldela en ägare till en post eller aktivitet under importen:
|
Ytterligare e-postadresser för kontaktpersoner eller företagsdomäner
Om du importerar kontakter med mer än en e-postadress ska du inkludera en kolumn med ytterligare e-postadresser med deras sekundära e-postadresser. Om du importerar företag med mer än ett domännamn inkluderar du en kolumn med ytterligare domäner med deras sekundära domäner. Om du vill inkludera flera e-postadresser eller domäner i en cell separerar du värdena med semikolon (t.ex. email@email. com; emailtwo@email.com).
Om du importerar för att skapa kontakter eller företag kan du inte ange en ny kontakts e-postadress eller ett nytt företags företagsdomännamn till en e-postadress eller domän som är en befintlig ytterligare e-postadress/domän för en annan post.
Tomma celler
Importverktyget ignorerar tomma celler i ett kalkylblad, så när du importerar ny fastighetsdata, lämna cellerna tomma för poster utan ett värde för egenskapen. Om en befintlig post redan har ett värde för egenskapen i HubSpot kommer tomma celler att inte rensa det befintliga värdet för egenskapen. Om du vill rensa befintliga värden för egenskaper i bulk kan du redigera värdena manuellt eller använd Arbetsflödesåtgärd föratt rensa värdet på egenskapen .Samarbetspartners för avtal
Om du lägger till medarbetare till en affär via import, inkludera en Samarbetspartner för avtal rubrik. För varje cell måste du ange två eller flera användare, åtskilda med semikolon (t.ex. user1@example.com;user2@example.com).Produktens löptid och faktureringsfrekvenser
Om du importerar en Term egenskap kan du formatera värdet i kolumnen Term som ett antal månader (t.ex. 10 för 10 månader), som PXM där X är antalet månader (t.ex. P6M, för en term på 6 månader) eller PXY där X är antalet år (t.ex. P1Y, för en term på 1 år).
Om du importerar ett värde för egenskapen Faktureringsfrekvens ska du använda Månad, År eller Kvartal om produkten har en återkommande pristyp. Lämna cellen tom om produkten har ett engångspris.
Egenskaper som krävs
Beroende på vilka objekt eller aktiviteter du importerar krävs följande egenskaper för att skapa poster, och de måste inkluderas som kolumnrubriker i dina filer. Om du uppdaterar poster måste du inkludera en unik identifierare (t.ex. post-ID, e-post, företagets domännamn).
Ävenom det inte krävs kan du importera ytterligare egenskaper för varje objekt, inklusive anpassade egenskaper och standardegenskaper. Se standardegenskaperna för kontakter, företag, affärer, ärenden, samtal, e-post, möten, anteckningar och uppgifter. Du kan också visa alla egenskaper och deras värden i dina inställningar för egenskaper.
- Kontakter: minst ett av följande alternativ: Förnamn, Efternamn eller E-post.
- Företag: minst ett av följande alternativ : Namn eller Företagets domännamn.
- Deals: om du skapar nya deals, Deal name, Pipeline och Affärsfas.
- Tickets : om du skapar nya tickets, Ticket name, Pipeline och Ticket status.
- Utnämningar: Start för möte. Mötesstarten bör formateras som en egenskap för datum och tid.
- Kurser: Kursnamn: Kursens namn.
- Listningar: Namn: Namn.
- Tjänster: Namn: Namn, Pipeline och Pipeline-stadium.
- Products: om du skapar produkter, Enhetspris och Namn.
- Radobjekt: Namn, antal, pris och tillhörande avtals post-ID eller avtalsnamn. Inkludera produktens Produkt-ID om du också associerar radobjektet med en produkt, som kommer att mappas som en radobjektsegenskap under importen.
Observera: när du importerar radobjekt med avtal kommer importen inte att uppdatera avtalsbeloppet. Om du vill uppdatera det associerade avtalsbeloppet kan du redigera radobjekten manuellt eller associera radobjekten med ett avtal i HubSpot.
- Samtal: Anteckningar omsamtal. När du importerar nya samtal rekommenderas det också att inkludera aktivitetsdatum.
- E-postmeddelanden: E-postens brödtext och riktning.
- Möten: Mötesbeskrivning: Mötesbeskrivning, starttid för mötet och sluttid för mötet. När du importerar nya möten rekommenderas det också att inkludera aktivitetsdatum. Värdena för starttid, sluttid och aktivitetsdatum bör formateras som egenskaper för datum och tid.
- Anteckningar: Anteckningarnas brödtext.
- Uppgifter: Uppgiftstitel och Förfallodatum . Förfallodatumet bör formateras som en egenskap för datum och tid.
Observera: även om det inte är obligatoriskt rekommenderas det att inkludera Activity date när du importerar nya aktiviteter för att ange datum och tid för när en aktivitet inträffade. Om du inte anger den här egenskapen ställs Activity date -värdena automatiskt in på datum och tid för importen.
Krav på att uppdatera befintliga register eller undvika dubbletter
För att uppdatera befintliga poster och undvika dubbla poster måste dina filer innehålla en egenskap för unik identifierare för varje objekt. För alla objekt kan du exportera befintliga poster och använda post-ID som en unik identifierare eller använda en anpassad egenskap som kräver unika värden. För kontakter kan du även använda Email. För företag kan du även använda Företagets domännamn.
Om du importerar flera objekt och inkluderar post-ID:n rekommenderas att du skiljer filens kolumnrubriker så att ID:t matchas med rätt objekt (t.ex. en kolumn som heter Post-ID - Kontakter och en annan som heter Post-ID - Företag).
Observera: följande beteende gäller om E-post eller Företagets domännamn ingår i filen:
- Om du använder en anpassad egenskap för unikt värde för att avdubbla kontakter kommer egenskapen E-post fortfarande att kräva unika värden.
- Om du använder en anpassad unik värdeegenskap för att avdubbla företag kommer egenskapen Företagets domännamn inte att kräva unika värden. Detta innebär att du kan importera dubbla företagsdomäner. Om du inte vill ha flera företag med samma domän bör du ta bort duplicerade domäner från filen innan du importerar, eller använda Företagets dom ännamn som unik identifierare istället.
- Du kan använda en sekundär e-postadress som unik identifierare för befintliga kontakter som har en sekundär e-postadress listad i HubSpot. Om du använder ett sekundärt e-postmeddelande och inte inkluderar kolumnen Record ID i din fil kommer det sekundära e-postmeddelandet inte att ersätta det primära e-postmeddelandet . Men om du inkluderar både den sekundära e-postadressen och Record ID som kolumner i din fil, kommer den sekundära e-postadressen att ersätta den primära e-postadressen.
Krav på att associera poster
Importera associationer i en fil
I en fil kan du associera två eller flera poster per rad. Inkludera information om associerade poster och/eller aktiviteter i samma rad och inkludera en unik identifierare för varje objekt. Om du vill associera en post med flera aktiviteter eller poster för ett annat objekt, inkluderar du postens unika identifierare i flera rader för varje post du vill associera.
Luke Danes är till exempel chef på Luke's Diner, men entreprenör på The Dragonfly Inn. Om du vill associera honom med båda företagen måste du inkludera två rader för Luke Danes med kolumnerna E-post (eller post-ID) och Företagets domännamn (eller post-ID) för varje företag.
Observera: Om du inte inkluderar unika identifierare (t.ex. e-post, företagets domännamn, post-ID) kommer importen att skapa dubbla poster i stället för att associera dem till samma post.
Om du importerar samma objektassociationer finns det ytterligare krav.
Importera associationer i två filer
Om du vill associera poster för två objekt i två filer använder du en gemensam kolumn för att koppla samman posterna i varje fil. Du kan se exempelfilerna för mer hjälp med att importera och associera poster.
Samma objektassociationer
Du kan importera en fil för att associera poster med samma objekt i bulk. Under importprocessen måste du markera en kryssruta för att inkludera samma objektassociationer.
När du skapar din fil ska du inkludera information om de associerade posterna i samma rad och inkludera en unik identifierare för varje post. Följande ytterligare krav är specifika för import av samma objekt:
- Minst en post i ett postpar måste redan finnas i HubSpot innan du importerar. Du kan till exempel importera en ny kontakt och associera den med en befintlig kontakt, men du kan inte importera för att skapa och associera två nya kontakter.
- När du associerar befintliga kontakter/företag kan du bara använda den primärae-postadressen/företagsdomänen som din unika identifierare. Sekundära e-postmeddelanden eller domäner stöds inte.
- Om du associerar flera poster med en post ska du separera posternas unika identifieringsvärden med ett semikolon i samma cell (t.ex. luke@lukesdiner. com; rory@yale.edu; sookie@dragonfly.com).
I exempelfilen nedan är Rory och Jackson nya kontakter som associeras med unika etiketter till befintliga kontakter, med deras e-postvärden som unik identifierare. Sookie är en befintlig kontakt som associeras med två befintliga kontakter med samma etikett. I den första raden är associationsetiketten en del av ett etikettpar, vilket innebär att när importen är klar kommer den associerade posten att ha etiketten Parent och Rory kommer att ha den parade etiketten Child.
Föreningar för föräldrar/barn
För att skapa associationer mellan underordnade företag och moderföretag via import, läs mer om import av underordnade företag.
Anpassade associationsetiketter (endastProfessional och Enterprise )
För att importera associationsetiketter måste du inkludera en kolumn för associationsetiketter . Du måste skapa associationsetiketterna i HubSpot innan du importerar dem.
- Om du vill ange att en företagsassociation ska vara primär anger du värdet Primär i kolumnen Associationsetikett för den raden.
- Om du vill ange flera etiketter för att beskriva relationen mellan två poster kan du inkludera flera värden för associationsetiketter i en cell, åtskilda av ett semikolon (t.ex. Manager; Billing contact).
- Om du importerar associationsetiketter i en import av flera filer måste du inkludera kolumnen Associationsetikett och en unik identifierare för det objekt du associerar i samma fil.
- Om du importerar parade etiketter:
- För associationer mellan Tvärobjekt ska du bara inkludera en av etiketterna i kolumnen Associationsetikett. Etiketterna kommer att tilldelas rätt objekt under importprocessen.
- För samma objektassociationer kommer posten i kolumnen Associated [unique identifier] att få den etikett som läggs till under importprocessen eller som ingår i filens etikettkolumn. Den andra posten i raden får den andra etiketten i paret.
Exempel på filer
I början av importprocessen kan du generera en exempelfil med de egenskaper som krävs för de valda objekten och aktiviteterna. Om du vill granska fler exempel med ytterligare egenskaper kan du läsa den här artikeln med exempelfiler.