Data ostatniej aktualizacji: 14 kwietnia 2026
Dostępne z każdą z następujących podpisów, z wyjątkiem miejsc, w których zaznaczono:
Przed rozpoczęciem importowania danych do HubSpot upewnij się, że pliki spełniają wymagania dotyczące formatu i ograniczeń technicznych. Niektóre ograniczenia zależą od rodzaju subskrypcji. Zapoznaj się z obsługiwanymi typami plików, sposobem strukturyzowania i formatowania wartości właściwości oraz liczbą wierszy i plików, które można zaimportować w danym okresie.
Przed rozpoczęciem importu zapoznaj się z artykułem „Pierwsze kroki z importowaniem”.
Wymagania techniczne i ograniczenia
Wszystkie pliki importowane do HubSpot muszą:- Być plikami w formacie .csv, .xlsx lub .xls.
- Zawierać tylko jeden arkusz.
- Zawierać wiersz nagłówkowy, w którym każdy nagłówek kolumny odpowiada właściwości w HubSpot. Nagłówki kolumn można uporządkować w dowolnej kolejności bez wpływu na import. Przed importem możesz sprawdzić, czy istnieje już domyślna właściwość pasująca do Twojego nagłówka, lub utworzyć właściwość niestandardową. Dowiedz się więcej o wymaganiach dotyczących właściwości.
- Posiadać mniej niż 1000 kolumn.
- Plik musi być zakodowany w formacie UTF-8, jeśli zawiera znaki obcojęzyczne.
- Jeśli importujesz plik Excel:
- Zawierać dane mieszczące się w maksymalnych limitach arkusza i skoroszytu programu Excel.
- Zawierać komórki w formacie liczbowym podczas importowania właściwości selektora daty i godziny.
W zależności od Twojej subskrypcji HubSpot na narzędzie do importowania mają zastosowanie dodatkowe ograniczenia techniczne. Obejmują one ograniczenia dotyczące rozmiaru i liczby wierszy pliku importowego, a także liczby plików i wierszy, które można zaimportować dziennie.
- Jeśli korzystasz z bezpłatnych narzędzi HubSpot, możesz:
- Importować pliki o rozmiarze do 20 MB.
- Przeprowadzić do 50 importów dziennie.
- Zaimportować do 500 000 wierszy dziennie. Pliki zawierające ponad 500 000 wierszy będą importowane przez kilka dni.
- Rozpocząć jednocześnie do 3 importów. Maksymalnie 2 z tych importów mogą zawierać więcej niż 10 000 wierszy. Jeśli rozpoczniesz 4 lub więcej importów jednocześnie, zostaną one umieszczone w kolejce.
- Jeśli Twoje konto posiada subskrypcję Smart CRM lub Starter, Professional lub Enterprise, możesz:
- Importować pliki o rozmiarze do 512 MB.
- Przeprowadzić do 500 importów dziennie.
- Importować do 10 000 000 wierszy dziennie, z limitem 1 048 576 wierszy na plik. Jeśli importujesz za pomocą API importów, możesz importować do 80 000 000 wierszy dziennie.
- Uruchomić do 3 importów jednocześnie. Maksymalnie 2 z tych importów mogą obejmować więcej niż 10 000 wierszy. Jeśli uruchomisz 4 lub więcej importów jednocześnie, zostaną one umieszczone w kolejce.
Limity te dotyczą 24-godzinnego okresu i nie są resetowane o określonej porze dnia. Dowiedz się więcej o swojejsubskrypcji HubSpot i jej ograniczeniach.
Formatowanie wartości właściwości
Dla każdego wiersza pliku importu możesz 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 w zależności od typu pola właściwości
W zależności od typu pola właściwości obowiązują określone wymagania dotyczące formatowania:
| Typ pola | Wymagania |
| Selektor daty Wybór 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 ustawiłeś reguły walidacji, importowane wartości muszą być zgodne z tymi regułami, w przeciwnym razie nie zostaną zaimportowane. |
| Selektor daty i godziny |
Sygnatury czasowe można dodawać w formacie Różnice stref czasowych względem strefy czasowej konta można dodać jako |
| Czas trwania |
W przypadku właściwości zawierających czas trwania, takich jak właściwość Czas trwania połączenia, wartości muszą być sformatowane jako znacznik czasu UNIX w milisekundach. Dowiedz się więcej o formatowaniu wartości znaczników czasu i konwertowaniu daty do formatu UNIX. |
| Wypis |
Wartości w pliku importu muszą odpowiadać etykiecie lub wartości wewnętrznej zdefiniowanych opcji właściwości. W przypadku domyślnych właściwości wyliczeniowych HubSpot (np. Etap cyklu życia, Branża) wartości muszą odpowiadać wartości wewnętrznej lub etykiecie w języku angielskim. |
| Plik |
Aby dodać istniejące pliki do właściwości pliku, jako wartość podaj identyfikator 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 średnikprzed pierwszą wartością (;wartość 3;wartość 4). Spowoduje to dołączenie wartości zamiast nadpisania istniejącej wartości właściwości. Dowiedz się więcej o importowaniu wielu wartości pól wyboru. |
| Liczba |
Sformatuj wartość w oparciu o typ utworzonej właściwości liczbowej:
|
| Pojedyncze pole wyboru |
Utwórz kolumnę dla pola z pojedynczym polem wyboru i ustaw wartość w każdym wierszu na TruelubYes, aby wyświetlać jako Yes lub zaznaczone w HubSpot, lubna FalselubNo,aby wyświetlać jako No lub niezaznaczone w HubSpot. |
| Właściwości okresu |
Właściwość pozycji „Okres” należy dodać w formatach okresów ISO-8601 PnYnMnD lub PnW. Na przykład P12M lub P24M dla okresów rocznych. Jeśli pole pozostanie puste, zostaną ustawione domyślne okresy. |
| Tekst |
Jeśli ustawiłeś 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 adresy e-mail kontaktów lub domeny firmowe
Jeśli importujesz kontakty z więcej niż jednym adresem e-mail, dodaj kolumnę „Dodatkowe adresy e-mail ” z ich dodatkowymi adresami. Jeśli importujesz firmy z więcej niż jedną nazwą domeny, dodaj kolumnę„Dodatkowe domeny” z ich dodatkowymi domenami. Aby umieścić wiele adresów e-mail lub domen w jednej komórce, oddziel wartości średnikami (np. email@email.com; emailtwo@email.com).
Jeśli importujesz dane w celu utworzenia kontaktów lub firm, nie możesz ustawić adresu e-mail nowego kontaktu ani nazwy domeny nowej firmy na adres e-mail lub domenę, która jest już dodatkowym adresem e-mail/domeną dla innego rekordu.
Puste komórki
Narzędzie do importu ignoruje puste komórki w arkuszu kalkulacyjnym, więc podczas importowania nowych danych właściwości pozostaw komórki puste dla rekordów bez wartości dla danej właściwości. Jeśli istniejący rekord ma już wartość dla tej właściwości w HubSpot, puste komórki nie spowodująwyczyszczenia istniejącej wartości właściwości. Aby zbiorczo wyczyścić istniejące wartości właściwości, możesz ręcznie edytować wartości lub użyć akcjiprzepływu pracy „Edytuj rekordy” .Współpracownicy transakcji
Jeśli dodajesz współpracowników do transakcji poprzez import, dołącz nagłówekWspółpracownicy transakcji. W każdej komórce musisz podać co najmniej dwóch użytkowników, oddzielonych średnikami (np. user1@example.com;user2@example.com).Warunki produktu i częstotliwość rozliczeń
W przypadku importowania wartości właściwości Okres można sformatować wartość w kolumnie Okres jako liczbę w miesiącach (np. 10 dla 10 miesięcy), jako PXM , gdzie X oznacza liczbę miesięcy (np. P6M dla okresu 6 miesięcy) lub PXY, gdzie X oznacza liczbę lat (np. P1Y dla okresu 1 roku).
W przypadku importowania wartości właściwości Częstotliwość rozliczeń należy użyć wartości miesięcznie, rocznie lub kwartalnie, jeśli produkt ma typ ceny cyklicznej. Komórkę należy pozostawić pustą, jeśli produkt ma cenę jednorazową.
Uwzględnij 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 utworzenia rekordów i muszą być uwzględnione jako nagłówki kolumn w plikach. Jeśli aktualizujesz rekordy, musisz uwzględnić unikalny identyfikator (np. ID rekordu, adres e-mail, nazwę domeny firmy).
Chociażnie jest to wymagane, możesz 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, zgłoszeń, połączeń, wiadomości e-mail, spotkań, notatek i zadań. Możesz również wyświetlić wszystkie właściwości i ich wartości w ustawieniach właściwości.
- Kontakty: co najmniej jedno z następujących pól: Imię, Nazwisko lub Adres e-mail.
- Firmy: co najmniej jedna z następujących opcji: Nazwa lub Nazwa domeny firmy.
Uwaga: właściwość Nazwa domeny firmy akceptuje tylko wartości do poziomu domeny najwyższego poziomu (np. .com, .edu). Wartości z ciągami znaków po niej (np. .edu/home) zostaną automatycznie usunięte podczas importu.
- Transakcje: jeśli tworzysz nowe transakcje,nazwa transakcji, lejek i etap transakcji.Lejek ietap transakcji muszą odpowiadać istniejącym opcjom na Twoim koncie, a etap transakcji musi być prawidłowym etapem w tym lejku.
- Zgłoszenia: jeśli tworzysz nowe zgłoszenia, nazwa zgłoszenia, ścieżka i status zgłoszenia.
- Spotkania: Początek spotkania. Początek spotkania powinien być sformatowany jakowłaściwość typu data-czas.
- Kursy: Nazwa kursu.
- Oferty: Nazwa.
- Usługi: nazwa, ścieżka i etap ścieżki.
- Produkty: jeśli aktualizujesz produkty, identyfikator 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) oraz nazwa.
- Zamówienia: Nazwa, Potok i Etap potoku.
- Koszyki: Nazwa.
- Pozycje: Nazwa, Ilość, Cena oraz identyfikator rekordu powiązanej transakcji lub nazwa transakcji. Jeśli pozycję powiązujesz również z produktem, podaj identyfikator produktu , który podczas importu zostanie przypisany jako właściwość pozycji.
Uwaga: podczas importowania pozycji z transakcjami import nie zaktualizuje kwoty transakcji. Aby zaktualizować kwotę powiązanej transakcji, możesz ręcznie edytować pozycje lub powiązać je z transakcją w HubSpot.
- Rozmowy: notatki z rozmów. Podczas importowania nowych rozmów zaleca się również uwzględnienie Datę działania.
- E-maile: treść wiadomości e-maili kierunek wiadomości e-mail.
- Spotkania:opis spotkania, godzina rozpoczęcia spotkania oraz godzina zakończenia spotkania. Podczas importowania nowych spotkań zaleca się również uwzględnienie datę działania. Wartości godziny rozpoczęcia, godziny zakończenia oraz daty działania powinny być sformatowane jako właściwości typu data-czas.
- Notatki: Treść notatki.
- Zadania:Tytuł zadaniaiTermin wykonania. Termin wykonania powinien być sformatowany jako właściwość typu data-czas.
Uwaga: choć nie jest to wymagane, zaleca się dołączenie daty działania podczas importowania nowych działań w celu określenia daty i godziny, w której miało ono miejsce. Jeśli nie dołączysz tej właściwości, wartości daty działania 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ć właściwość unikalnego 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 wymagającej unikalnych wartości. W przypadku kontaktów można również użyć adresu e-mail. W przypadku firm można również użyć nazwy domeny firmy.
Jeśli importujesz wiele obiektów i dołączasz identyfikatory rekordów, zaleca się rozróżnienie nagłówków kolumn pliku, aby dopasować identyfikator do właściwego obiektu (np. jedna kolumna o nazwie Identyfikator rekordu — Kontakty, a inna o nazwie Identyfikator rekordu — Firmy).
Uwaga:jeśli w pliku znajduje się adres e-mail lub nazwa domeny firmy , obowiązują następujące zasady:
- Jeśli używasz niestandardowej właściwości o unikalnej wartości do deduplikacji kontaktów, właściwość „E-mail” nadal będzie wymagała unikalnych wartości.
- Jeśli używasz niestandardowej właściwości o unikalnej wartości do deduplikacji firm, właściwość „Nazwa domeny firmy ” nie będzie wymagała unikalnych wartości. Oznacza to, że możesz importować zduplikowane domeny firm. Jeśli nie chcesz, aby istniało wiele firm z tą samą domeną, przed importem usuń zduplikowane domeny z pliku lub zamiast tego użyj 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 podany w HubSpot. Jeśli używasz dodatkowego adresu e-mail i nie uwzględnisz kolumny„Identyfikator rekordu” w pliku, dodatkowy adres e-mail nie zastąpi adresu głównego. 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 adres główny.
Wymagania dotyczące powiązania rekordów
Importowanie powiązań w jednym pliku
W jednym pliku można powiązać dwa lub więcej rekordów w jednym wierszu. Należy uwzględnić informacje o powiązanych rekordach i/lub działaniach w tym samym wierszu oraz unikalny identyfikator dla każdego obiektu. Aby powiązać jeden rekord z wieloma działaniami lub rekordami innego obiektu, należy uwzględnić unikalny identyfikator rekordu w wielu wierszach dla każdego rekordu, który chcesz powiązać.
Na przykład Luke Danes jest kierownikiem w restauracji Luke's Diner, ale wykonawcą w The Dragonfly Inn. Aby powiązać go z obiema firmami, należy uwzględnić dwa wiersze dla Luke'a Danesa z kolumnami „E-mail” (lub „Identyfikator rekordu”) oraz „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 spowoduje utworzenie zduplikowanych rekordów zamiast powiązania każdego z nich z tym samym rekordem.
Jeśli importujesz powiązania tych samych obiektów, obowiązują dodatkowe wymagania.
Importowanie powiązań w dwóch plikach
Aby powiązać rekordy dwóch obiektów w dwóch plikach, użyj wspólnej kolumny do połączenia rekordów w każdym pliku. Więcej informacji na temat importowania i powiązania rekordów znajdziesz w przykładowych plikach.
Powiązania
tego
samego obiektu
Możesz zaimportować jeden plik, aby zbiorczo powiązać rekordy tego samego obiektu. Podczas procesu importu musisz zaznaczyć pole wyboru, aby uwzględnić powiązania tego samego obiektu.
Podczas konfigurowania pliku umieść informacje o powiązanych rekordach w tym samym wierszu i dołącz unikalny identyfikatordla każdego rekordu. Poniższe dodatkowe wymagania dotyczą wyłącznie importów tego samego obiektu:
- Przynajmniej jeden rekord z pary rekordów musi już istnieć w HubSpot przed importem. Na przykład można zaimportować nowy kontakt i powiązać go z istniejącym kontaktem, aleniemożna zaimportować w celu utworzenia i powiązania dwóch nowych kontaktów.
- Podczas powiązania istniejących kontaktów/firm jako unikalny identyfikator można używać wyłącznie głównego adresue-mail/domeny firmy. Dodatkowe adresy e-mail lub domeny nie są obsługiwane.
- Jeśli powiązujesz 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 poniższym pliku przykładowym Rory i Jackson to nowe kontakty powiązane z unikalnymi etykietami istniejących kontaktów, przy użyciu ich wartoście-mailjako 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ę„Parent”, a Rorybędzie miał etykietę z tej pary, czyli„Child”.
Powiązania rodzic/dziecko
Aby utworzyć powiązania między spółkami nadrzędnymi i podrzędnymi poprzez import, dowiedz się więcej o importowaniu spółek podrzędnych.
Niestandardowe etykiety powiązań
Wymagana subskrypcja Aby korzystać z niestandardowych etykiet powiązań, wymagana jest subskrypcja Professional lub Enterprise.
Aby zaimportować etykiety powiązań, dodaj kolumnę „Etykieta powiązania”. Kolumnę tę należy dodać tylko wtedy, gdy chcesz dodać etykiety opisujące powiązania. Jeśli nie musisz oznaczać powiązań, kolumna ta nie jest wymagana.
- Przed importem należy utworzyć etykiety powiązań w HubSpot.
- Aby ustawić powiązanie firmy jako podstawowe, dodaj wartość „Podstawowe” w kolumnie „Etykieta powiązania”dla tego wiersza.
- Aby ustawić wiele etykiet opisujących relację między dwoma rekordami, możesz umieścić wiele wartości etykiet powiązania w jednej komórce, oddzielając je średnikiem (np. Menedżer; Osoba kontaktowa ds. rozliczeń).
- Jeśli importujesz etykiety powiązań w ramach importu wielu plików, musisz umieścić kolumnę Etykieta powiązania oraz unikalny identyfikator obiektu, z którym tworzysz powiązanie, w tym samym pliku.
- Jeśli importujeszetykiety sparowane:
- W przypadku powiązań między obiektami w kolumnie „Etykieta powiązania ” należy umieścić tylko jedną z etykiet. Etykiety zostaną przypisane do właściwego obiektu podczas procesu importowania.
- W przypadku powiązań między tymi samymi obiektami rekord wkolumnie Powiązany [unikalny identyfikator] otrzyma etykietę dodaną podczasprocesu importu lub zawartą w kolumnie etykiet pliku. Drugi rekord w wierszu otrzyma drugą etykietę z pary.
Pliki przykładowe
Na początku procesu importu można wygenerować plik przykładowy 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 zawierającym pliki przykładowe.
Kolejne kroki
Teraz, gdy plik importu jest gotowy, postępuj zgodnie z odpowiednimi instrukcjami importu:
