- Baza wiedzy
- CRM
- Import i eksport
- Konfiguracja plików importu
Konfiguracja plików importu
Data ostatniej aktualizacji: 3 października 2025
Dostępne z każdą z następujących podpisów, z wyjątkiem miejsc, w których zaznaczono:
-
Stanowiska wymagane dla niektórych funkcji
Przed zaimportowaniem danych do HubSpot zapoznaj się z poniższymi ograniczeniami i wymaganiami. Możesz także uzyskać dostęp do przykładowych plików lub wygenerować przykładowe pliki, aby rozpocząć.
Aby dowiedzieć się więcej o narzędziu do importowania, zapoznaj się z tym artykułem. Jeśli plik jest gotowy, dowiedz się, jak go zaimportować.
Wymagania techniczne i ograniczenia
Wszystkie pliki importowane do HubSpot muszą:- Być plikiem .csv, .xlsx lub .xls.
- Mieć tylko jeden arkusz.
- Zawierać wiersz nagłówka, w którym każdy nagłówek kolumny odpowiada właściwości w HubSpot. Nagłówki kolumn mogą być uporządkowane w dowolnej kolejności bez wpływu na import. Możesz sprawdzić, czy istnieje już domyślna właściw ość pasująca do nagłówka lub utworzyć niestandardową właściw ość przed importem. Dowiedz się więcej o wymaganiach dotyczących właściwości.
- Zawierać mniej niż 1000 kolumn.
- Być zakodowany w UTF-8, jeśli zawiera znaki obcojęzyczne.
- Jeśli importujesz plik Excel:
- Zawierać dane, które nie przekraczają maksymalnych limitów arkusza i skoroszytu programu Excel.
- Zawierać komórki w formacie liczbowym podczas importowania właściwości selektora daty i godziny.
Istnieją dodatkowe ograniczenia techniczne dla narzędzia importu w zależności od subskrypcji HubSpot. Limity te obejmują rozmiar i limity wierszy pliku importu, a także liczbę plików i wierszy, które można zaimportować dziennie.
- Jeśli korzystasz tylko z bezpłatnych narzędzi HubSpot lub Smart CRM Professional lub Enterprise , możesz:
- Importować pliki do 20 MB.
- Wykonać do 50 importów dziennie.
- Importować do 500 000 wierszy dziennie. Zaimportowanie pliku zawierającego więcej niż 500 000 wierszy zajmie kilka dni.
- Jeśli Twoje konto posiada subskrypcję Starter, Professional lub Enterprise, możesz:
- Importować pliki o rozmiarze do 512 MB.
- Wykonać do 500 importów dziennie.
- Importować do 10 000 000 wierszy dziennie, z limitem 1 048 576 wierszy na plik. W przypadku importu za pośrednictwem interfejsu API importu można zaimportować do 80 000 000 wierszy dziennie.
Limity te dotyczą 24-godzinnego okresu i nie są resetowane o określonej porze dnia. Dowiedz się więcej o subskrypcji HubSpot i jej ograniczeniach.
Formatowanie wartości
Dla każdego wiersza pliku importu można dodać wartości dla kolumn właściwości. Formatowanie wartości zależy od typu pola właściwości i celu importu.
Formatowanie wartości na podstawie typu pola właściwości
W zależności od typu pola właściwości istnieją określone wymagania dotyczące formatowania:
Typ pola | Wymagania |
Selektor daty Selektor daty i godziny |
Miesiące mogą być liczbą, trzema literami lub pełną nazwą (10, OCT, Oct, OCTOBER, October), lata mogą być dwucyfrowe lub czterocyfrowe (2023, 23), a separatorami mogą być ukośnik, myślnik lub kropka (10/28/2023, 10-28-2023, 10.28.2023). Prawidłowe formaty daty to dzień miesiąc rok (np. 28/10/2023), miesiąc dzień rok (np. 10-28-23) lub rok miesiąc dzień (np. 2023.OCT.28). Jeśli ustawiono reguły walidacji, importowane wartości muszą być zgodne z regułami, w przeciwnym razie nie zostaną zaimportowane. |
Selektor daty i godziny |
Znaczniki czasu można dodawać jako hh:mm (28/10/2020 14:30) we wszystkich typach plików lub jako znacznik czasu UNIX w milisekundach w plikach CSV lub pliku Excel z komórkami w formacie liczb tekstowych. Jeśli nie dołączysz znacznika czasu, czas zostanie domyślnie ustawiony na północ. |
Czas trwania |
W przypadku właściwości zawierających czas trwania, takich jak właściwość Call duration, wartości muszą być sformatowane jako znacznik czasu UNIX w milisekundach. Dowiedz się więcej o formatowaniu wartości znacznika czasu i konwertowaniu daty na format UNIX. |
Wyliczenie |
Wartości w pliku importu muszą być zgodne z etykietą lub wewnętrzną wartością zdefiniowanych opcji właściwości. W przypadku domyślnych właściwości wyliczeniowych HubSpot (np. Lifecycle stage, Industry) wartości muszą być zgodne z wartością wewnętrzną lub etykietą w języku angielskim. |
Plik |
Aby dodać istniejące pliki do właściwości pliku, jako wartość należy podać ID pliku. Identyfikator pliku można znaleźć w sekcji Ogólne w szczegółach pliku. |
Wiele pól wyboru |
Aby zaimportować wiele wartości, dodaj średnik między każdą wartością bez spacji (wartość 1; wartość 2). Te opcje właściwości muszą zostać utworzone przed importem. Aby dodać lub dołączyć wartości, dodaj średnik przed pierwszą wartością (;value 3;value 4). Spowoduje to dołączenie wartości zamiast nadpisywania istniejącej wartości właściwości. |
Liczba |
Formatuje wartość w oparciu o typ utworzonej właściwości liczbowej:
|
Pojedyncze pole wyboru |
Utwórz kolumnę dla pojedynczego pola wyboru i ustaw wartość w każdym wierszu na True lub Yes, aby wyświetlić jako Yes lub zaznaczone w HubSpot lub False lub No, aby wyświetlić jako No lub niezaznaczone w HubSpot. |
Właściwości terminu |
Właściwość pozycji linii Term powinna być dodana w formatach okresów ISO-8601 PnYnMnD lub PnW. Na przykład P12M lub P24M dla terminów rocznych. Jeśli pozostanie puste, zostaną ustawione domyślne terminy. |
Tekst |
Jeśli ustawiono reguły walidacji, importowane wartości muszą być zgodne z tymi regułami, w przeciwnym razie nie zostaną zaimportowane. |
Użytkownik (Właściciel) |
Aby przypisać właściciela do rekordu lub działania podczas importu:
|
Dodatkowe kontaktowe adresy e-mail lub domeny firmowe
Jeśli importujesz kontakty z więcej niż jednym adresem e-mail, dołącz kolumnę Dodatkowe adresy e-mail z ich dodatkowymi adresami e-mail. Jeśli importujesz firmy z więcej niż jedną nazwą domeny, dołącz kolumnę Dodatkowe domeny z ich dodatkowymi domenami. Aby uwzględnić wiele adresów e-mail lub domen w komórce, oddziel wartości średnikami (np. email@email. com; emailtwo@email.com).
Jeśli importujesz w celu utworzenia kontaktów lub firm, nie możesz ustawić adresu e-mail nowego kontaktu lub nazwy domeny firmy nowej firmy na adres e-mail lub domenę, która jest istniejącym dodatkowym adresem e-mail/domeną dla innego rekordu.
Puste komórki
Narzędzie importu ignoruje puste komórki w arkuszu kalkulacyjnym, więc podczas importowania nowych danych właściwości należy pozostawić puste komórki dla rekordów bez wartości dla właściwości. Jeśli istniejący rekord ma już wartość właściwości w HubSpot, puste komórkinie wyczyszczą istniejącej wartości właściwości. Aby zbiorczo wyczyścić istniejące wartości właściwości, można ręcznie edytować wartości lub użyć akcji przepływu pracyEdytuj rekordy .Współpracownicy transakcji
Jeśli dodajesz współpracowników do transakcji poprzez import, dołącz nagłówekWspółpracownik transakcji. Dla każdej komórki należy uwzględnić dwóch lub więcej użytkowników, oddzielonych średnikami (np. user1@example.com;user2@example.com).Termin produktu i częstotliwość rozliczeń
W przypadku importowania wartości właściwości Term można sformatować wartość w kolumnie Term jako liczbę w miesiącach (np. 10 dla 10 miesięcy), jako PXM , gdzie X jest liczbą miesięcy (np. P6M, dla okresu 6 miesięcy) lub PXY, gdzie X jest liczbą lat (np. P1Y, dla okresu 1 roku).
W przypadku importowania wartości właściwości Częstotliwość rozli czeń należy użyć opcji miesięcznie, rocznie lub kwartalnie, jeśli produkt ma powtarzający się typ ceny. Pozostaw komórkę pustą, jeśli produkt ma cenę jednorazową.
Wymagane właściwości
W zależności od importowanych obiektów lub działań, następujące właściwości są wymagane do tworzenia rekordów i muszą być uwzględnione jako nagłówki kolumn w plikach. Jeśli aktualizujesz rekordy, musisz dołączyć unikalny identyfikator (np. ID rekordu, adres e-mail, nazwę domeny firmy).
Chociażnie jest to wymagane, można zaimportować dodatkowe właściwości dla każdego obiektu, w tym właściwości niestandardowe i domyślne. Zapoznaj się z domyślnymi właściwościami dla kontaktów, firm, transakcji, biletów, połączeń, wiadomości e-mail, spotkań, notatek i zadań. Możesz także wyświetlić wszystkie właściwości i ich wartości w ustawieniach właściwości.
- Kontakty: co najmniej jeden z następujących atrybutów: Imię, Nazwisko lub E-mail.
- Firmy: co najmniej jedna z opcji: Nazwa lub Nazwa domeny firmy.
Uwaga: właściwość Nazwa domeny firmy akceptuje tylko wartości do domeny najwyższego poziomu (np. .com, .edu). Wartości z ciągami znaków po nich (np. .edu/home) zostaną automatycznie usunięte podczas importowania.
- Transakcje: jeśli tworzysz nowe transakcje, nazwę transakcji, potok i etap transakcji.
- Bilety : jeśli tworzysz nowe bilety, nazwa biletu, potok i status biletu.
- Powołania: Początek spotkania. Początek spotkania powinien być sformatowany jako właściwość daty i godziny.
- Kursy: Nazwa kursu.
- Listings: Nazwa.
- Usługi: Nazwa, Potok i Etap potoku.
- Produkty: jeśli aktualizujesz produkty, ID rekordu lub SKU.
- Jeśli aktualizujesz produkty na koncie z jedną walutą, Cena jednostkowa i Nazwa.
- Jeśli aktualizujesz produkty na koncie z wieloma walutami, Cena [skrót waluty] (np. Cena USD) i Nazwa.
- Zamówienia: Nazwa, Potok i Etap potoku.
- Koszyki: Nazwa.
- Pozycje: Nazwa, ilość, cena i powiązany identyfikator rekordu lub nazwa transakcji. Dołącz identyfikator produktu produktu, jeśli kojarzysz również pozycję z produktem, który zostanie zmapowany jako właściwość pozycji podczas importu.
Uwaga: podczas importowania pozycji liniowych z transakcjami import nie zaktualizuje kwoty transakcji. Aby zaktualizować powiązaną kwotę transakcji, można ręcznie edytować pozycje liniowe lub powiązać pozycje liniowe z transakcją w HubSpot.
- Połączenia: Notatki dotyczące połączeń. Podczas importowania nowych połączeń zaleca się również uwzględnienie daty aktywności.
- Wiadomości e-mail: Treść wiadomości e-mail i kierunek wiadomości e-mail.
- Spotkania: Opis spotkania, Godzina rozpoczęcia spotkania i Godzina zakończenia spotkania. Podczas importowania nowych spotkań zaleca się również uwzględnienie daty aktywności. Wartości czasu rozpoczęcia, czasu zakończenia i daty aktywności powinny być sformatowane jako właściwości daty i czasu.
- Uwagi: Treść notatki.
- Zadania: Tytuł zadania i Termin wykonania. Termin powinien być sformatowany jako właściwość daty i czasu.
Uwaga: choć nie jest to wymagane, zaleca się uwzględnienie daty działania podczas importowania nowych działań w celu określenia daty i godziny wystąpienia działania. Jeśli nie uwzględnisz tej właściwości, wartości daty aktywności zostaną automatycznie ustawione na datę i godzinę importu.
Wymagania dotyczące aktualizacji istniejących rekordów lub unikania duplikatów
Aby zaktualizować istniejące rekordy i uniknąć duplikatów, pliki muszą zawierać unikalną właściwość identyfikatora dla każdego obiektu. W przypadku wszystkich obiektów można wyeksportowaćistniejące rekordy i użyć identyfikatora rekordu jako unikalnego identyfikatora lub użyć niestandardowej właściwości, która wymaga unikalnych wartości. W przypadku kontaktów można również użyć Email. W przypadku firm można również użyć nazwy domeny firmy.
Jeśli importujesz wiele obiektów i uwzględniasz identyfikatory rekordów, zaleca się rozróżnienie nagłówków kolumn pliku w celu dopasowania identyfikatora do właściwego obiektu (np. jedna kolumna o nazwie Identyfikator rekordu - Kontakty, a druga o nazwie Identyfikator rekordu - Firmy).
Uwaga: poniższe zachowanie ma zastosowanie, jeśli w pliku znajduje się adres e-mail lub nazwa domeny firmy :
- Jeśli używasz niestandardowej właściwości unikalnej wartości do deduplikacji kontaktów, właściwość Email będzie nadal wymagać unikalnych wartości.
- Jeśli używasz niestandardowej właściwości unikatowej wartości do deduplikacji firm, właściwość Nazwa domeny firmy nie będzie wymagać unikatowych wartości. Oznacza to, że można importować zduplikowane domeny firm. Jeśli nie chcesz mieć wielu firm z tą samą domeną, powinieneś usunąć zduplikowane domeny z pliku przed importem lub zamiast tego użyć nazwy domeny firmy jako unikalnego identyfikatora.
- Możesz użyć dodatkowego adresu e-mail jako unikalnego identyfikatora dla istniejących kontaktów, które mają dodatkowy adres e-mail wymieniony w HubSpot. Jeśli użyjesz dodatkowego adresu e-mail i nie uwzględnisz w pliku kolumny Record ID, dodatkowy adres e-mail nie zastąpi podstawowego adresu e-mail. Jeśli jednak uwzględnisz zarówno dodatkowy adres e-mail, jak i identyfikator rekordu jako kolumny w pliku, dodatkowy adres e-mail zastąpi podstawowy adres e-mail.
Wymagania dotyczące kojarzenia rekordów
Importowanie skojarzeń w jednym pliku
W jednym pliku można skojarzyć dwa lub więcej rekordów na wiersz. Informacje o powiązanych rekordach i/lub działaniach należy umieścić w tym samym wierszu, a dla każdego obiektu należy podać unikatowy identyfikator. Aby skojarzyć jeden rekord z wieloma działaniami lub rekordami innego obiektu, dołącz unikalny identyfikator rekordu w wielu wierszach dla każdego rekordu, który chcesz skojarzyć.
Na przykład Luke Danes jest menedżerem w Luke's Diner, ale wykonawcą w The Dragonfly Inn. Aby powiązać go z obiema firmami, należy dołączyć dwa wiersze dla Luke'a Danesa z kolumnami Email (lub identyfikator rekordu) i Nazwa domeny firmy (lub identyfikator rekordu) dla każdej firmy.
Uwaga: jeśli nie uwzględnisz unikalnych identyfikatorów (np. adresu e-mail, nazwy domeny firmy, identyfikatora rekordu), import utworzy zduplikowane rekordy zamiast powiązać każdy z nich z tym samym rekordem.
Jeśli importujesz te same skojarzenia obiektów, istnieją dodatkowe wymagania.
Import skojarzeń w dwóch plikach
Aby skojarzyć rekordy dwóch obiektów w dwóch plikach, należy użyć wspólnej kolumny do połączenia rekordów w każdym pliku. Więcej informacji na temat importowania i kojarzenia rekordów można znaleźć w przykładowych plikach.
Skojarzenia tych samych obiektów
Możesz zaimportować jeden plik, aby skojarzyć rekordy tego samego obiektu zbiorczo. Podczas procesu importowania należy zaznaczyć pole wyboru, aby uwzględnić skojarzenia tego samego obiektu.
Podczas konfigurowania pliku należy dołączyć informacje o powiązanych rekordach w tym samym wierszu i dołączyć unikalny identyfikator dla każdego rekordu. Poniższe dodatkowe wymagania są specyficzne dla importu tego samego obiektu:
- Co najmniej jeden rekord w parze rekordów musi już istnieć w HubSpot przed zaimportowaniem. Na przykład można zaimportować nowy kontakt i powiązać go z istniejącym kontaktem, ale nie można zaimportować w celu utworzenia i powiązania dwóch nowych kontaktów.
- Podczas kojarzenia istniejących kontaktów/firm jako unikalnego identyfikatora można użyć tylko podstawowego adresue-mail/domen firmowych. Dodatkowe adresy e-mail lub domeny nie są obsługiwane.
- Jeśli kojarzysz wiele rekordów z jednym rekordem, oddziel wartości unikalnych identyfikatorów rekordów średnikiem w tej samej komórce (np. luke@lukesdiner. com; rory@yale.edu; sookie@dragonfly.com).
W przykładowym pliku poniżej, Rory i Jackson są nowymi kontaktami powiązanymi z unikalnymi etykietami do istniejących kontaktów, używając ich wartości Email jako unikalnego identyfikatora. Sookie to istniejący kontakt powiązany z dwoma istniejącymi kontaktami o tej samej etykiecie. W pierwszym wierszu etykieta powiązania jest częścią pary etykiet, co oznacza, że po zakończeniu importu powiązany rekord będzie miał etykietę Rodzic, a Rory będzie miał sparowaną etykietę Dziecko.

Asocjacje rodzic/dziecko
Aby utworzyć asocjacje dziecko-rodzic firmy poprzez import, dowiedz się więcej o importowaniu firm-rodziców.
Niestandardowe etykiety powiązań
Wymagana subskrypcja . Do korzystania z niestandardowych etykiet powiązań wymagana jest subskrypcja Professional lub Enterprise.
Aby zaimportować etykiety asocjacji, należy dodać kolumnę Etykieta asocjacji . Kolumna ta powinna zostać dodana tylko wtedy, gdy chcesz dodać etykiety opisujące asocjacje. Jeśli nie ma potrzeby etykietowania asocjacji, kolumna ta nie jest wymagana.
- Przed zaimportowaniem należy utworzyć etykiety asocjacji w HubSpot.
- Aby ustawić asocjację firmy jako podstawową, należy dodać wartość Primary w kolumnie Association label dla tego wiersza.
- Aby ustawić wiele etykiet w celu opisania relacji między dwoma rekordami, można umieścić wiele wartości etykiet asocjacji w jednej komórce, oddzielając je średnikiem (np. Manager; Billing contact).
- Jeśli importujesz etykiety asocjacji w imporcie wielu plików, musisz dołączyć kolumnę Etykieta as ocjacji i unikalny identyfikator obiektu, który kojarzysz w tym samym pliku.
- Jeśli importujesz sparowane etykiety:
- W przypadku asocjacji między obiektami należy uwzględnić tylko jedną z etykiet w kolumnie Association label. Etykiety zostaną przypisane do właściwego obiektu podczas procesu importowania.
- W przypadku asocjacji tego samego obiektu rekord w kolumnie Associated [unique identifier] otrzyma etykietę dodaną w procesie importu lub zawartą w kolumnie etykiety pliku. Drugi rekord w wierszu otrzyma drugą etykietę w parze.
Przykładowe pliki
Na początku procesu importowania można wygenerować przykładowy plik z wymaganymi właściwościami dla wybranych obiektów i działań. Jeśli chcesz przejrzeć więcej przykładów z dodatkowymi właściwościami, zapoznaj się z tym artykułem z przykładowymi plikami.
