Data ostatniej aktualizacji: 20 listopada 2025
Dostępne z każdą z następujących podpisów, z wyjątkiem miejsc, w których zaznaczono:
Przed zaimportowaniem danych do HubSpot zapoznaj się z poniższymi ograniczeniami i wymaganiami. Możesz również uzyskać dostęp do przykładowych plików lub wygenerować przykładowe pliki, aby rozpocząć pracę.
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ć plikami .csv, .xlsx lub .xls.
- Mieć 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 mogą być uporządkowane w dowolnej kolejności bez wpływu na import. Przed importem można sprawdzić, czy istnieje już domyślna właściwość pasująca do nagłówka, lub utworzyć niestandardową właściwość. Dowiedz się więcej o wymaganiach dotyczących właściwości.
- Zawierać mniej niż 1000 kolumn.
- Jeśli zawiera znaki w języku obcym, musi być zakodowany w formacie UTF-8.
- Jeśli importujesz plik Excel:
- Zawierać dane, które mieszczą 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 subskrypcji HubSpot istnieją dodatkowe ograniczenia techniczne dotyczące narzędzia importu. Ograniczenia te obejmują rozmiar i liczbę wierszy pliku importowanego, a także liczbę plików i wierszy, które można importować dziennie.
- Jeśli korzystasz wyłącznie z bezpłatnych narzędzi HubSpot lub narzędzi Smart CRM Professional lub Enterprise , możesz:
- Importować pliki o rozmiarze do 20 MB.
- Przeprowadzać do 50 importów dziennie.
- Importować do 500 000 wierszy dziennie. Jeśli importujesz plik zawierający ponad 500 000 wierszy, zakończenie importu potrwa kilka dni.
- Jeśli Twoje konto ma subskrypcję Starter, Professional lub Enterprise, możesz:
- Importować pliki o rozmiarze do 512 MB.
- Wykonaj 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ą interfejsu API importu, możesz importować do 80 000 000 wierszy dziennie.
Limity te obowiązują przez 24 godziny i nie są resetowane o określonej porze dnia. Dowiedz się więcej o subskrypcji HubSpot i jej ograniczeniach.
Formatowanie wartości
W każdym wierszu 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 w oparciu o typ 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 |
| Wybór daty Wybór daty i godziny |
Miesiące mogą być wyrażone liczbą, trzema literami lub pełną nazwą (10, OCT, Oct, OCTOBER, October), lata mogą być wyrażone dwoma lub czterema cyframi (2023, 23), a separatory mogą być ukośnikiem, łącznikiem lub kropką (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. |
| Wybór daty i godziny |
Znaczniki czasu można dodawać w formacie hh:mm (28/10/2020 14:30) we wszystkich typach plików lub jako znacznik czasu UNIX w milisekundach w plikach CSV lub plikach Excel z komórkami w formacie tekstowym. Jeśli nie dodasz znacznika czasu, domyślnie zostanie ustawiona godzina 00:00. |
| Czas |
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. |
| Wyliczenie |
Wartości w pliku importu muszą być zgodne z etykietą lub wartością wewnętrzną 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ą 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ść podaj identyfikator pliku. Identyfikator pliku można znaleźć w sekcji Ogólne szczegółów 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ą (;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 liczby:
|
| Pojedyncze pole wyboru |
Utwórz kolumnę dla pola pojedynczego pola wyboru i ustaw wartość w każdym wierszu na True lub Yes, aby wyświetlać jako Yes lub zaznaczone w HubSpot, lub False lub No, aby wyświetlać jako No lub niezaznaczone w HubSpot. |
| Właściwości terminu |
Właściwość pozycji Wykres Termin należy dodać w formatach okresów ISO-8601 PnYnMnD lub PnW. Na przykład P12M lub P24M dla terminów rocznych. Jeśli pole pozostanie puste, zostaną ustawione terminy domyślne. |
| 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 kontaktowe 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 dodać wiele adresów e-mail lub domen do komórki, 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 lub nazwy domeny nowej firmy na adres e-mail lub domenę, które są już dodatkowymi adresami e-mail/domenami 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 pozostaw puste komórki dla rekordów bez wartości właściwości. Jeśli istniejący rekord ma już wartość właściwości w HubSpot, puste komórki nie usuną istniejącej wartości właściwości. Aby zbiorczo usunąć 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, dodaj nagłówekWspółpracownik transakcji. W każdej komórce musisz podać co najmniej dwóch użytkowników, oddzielonych średnikami (np. user1@example.com;user2@example.com).Okres obowiązywania produktu i częstotliwość rozliczeń
W przypadku importowania wartości właściwości Warunek można sformatować wartość w kolumnie Warunek 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ć opcji miesięcznie, rocznie lub kwartalnie, jeśli produkt ma cenę cykliczną. Jeśli produkt ma cenę jednorazową, należy pozostawić komórkę pustą.
Wymagane właściwości
W zależności od importowanych obiektów lub działań, poniższe właściwości są wymagane do utworzenia rekordów i muszą być uwzględnione jako nagłówki kolumn w plikach. W przypadku aktualizacji rekordów należy uwzględnić unikalny identyfikator (np. identyfikator rekordu, adres e-mail, nazwa domeny firmy).
Chociażnie jest to wymagane, można importować 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 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 właściwości: 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 niej (np. .edu/home) zostaną automatycznie usunięte podczas importowania.
- Transakcje: jeśli tworzysz nowe transakcje, nazwa transakcji, potok i etap transakcji.
- Zgłoszenia: jeśli tworzysz nowe zgłoszenia, nazwa zgłoszenia, ścieżka i status zgłoszenia.
- Spotkania: data rozpoczęcia spotkania. Data rozpoczęcia spotkania powinna być sformatowana jako właściwość daty i godziny.
- Kursy: nazwa kursu.
- Oferty: nazwa.
- Usługi: nazwa, ścieżka sprzedaży i etap ścieżki sprzedaży.
- 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 w USD) i nazwa.
- Zamówienia: nazwa, proces sprzedaży i etap procesu sprzedaży.
- Koszyki: Nazwa.
- Pozycje: Nazwa, Ilość, Cena oraz powiązany identyfikator rekordu transakcji lub nazwa transakcji. Jeśli pozycja jest również powiązana z produktem, należy podać identyfikator produktu , który zostanie przypisany jako właściwość pozycji podczas importu.
Uwaga: podczas importowania pozycji wraz z transakcjami import nie zaktualizuje kwoty transakcji. Aby zaktualizować powiązaną kwotę transakcji, możesz ręcznie edytować pozycje lub powiązać pozycje z transakcją w HubSpot.
- Połączenia: notatki dotyczące połączeń. Podczas importowania nowych połączeń zaleca się również uwzględnienie daty działania.
- E-maile: treść e-maila i kierunek e-maila.
- 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 godziny rozpoczęcia, godziny zakończenia i daty aktywności powinny być sformatowane jako właściwości daty i godziny.
- Notatki: treść notatki.
- Zadania: Tytuł zadania i termin wykonania. Termin wykonania powinien być sformatowany jako właściwość daty i godziny.
Uwaga: chociaż nie jest to wymagane, zaleca się uwzględnienie daty działania podczas importowania nowych działań, aby określić datę i godzinę wystąpienia działania. Jeśli nie uwzględnisz 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ć 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ć adresu e-mail. W przypadku firm można również użyć nazwy domeny firmy.
W przypadku importowania wielu obiektów i uwzględniania identyfikatorów 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 druga o nazwie Identyfikator rekordu — firmy).
Uwaga: poniższezachowanie 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ść „Adres e-mail” nadal będzie wymagała unikalnych wartości.
- Jeśli używasz niestandardowej właściwości unikalnej wartości do deduplikacji firm, właściwość nazwy domeny firmy nie będzie wymagała unikalnych wartości. Oznacza to, że możesz importować zduplikowane domeny firmowe. Jeśli nie chcesz mieć wielu firm z tą samą domeną, przed importem usuń zduplikowane domeny z pliku lub 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 umieścisz kolumny Identyfikator rekordu w pliku, dodatkowy adres e-mail nie zastąpi głównego adresu e-mail. Jeśli jednak umieścisz zarówno dodatkowy adres e-mail, jak i identyfikator rekordu jako kolumny w pliku, dodatkowy adres e-mail zastąpi główny adres e-mail.
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 podać unikalny identyfikator każdego obiektu. Aby powiązać jeden rekord z wieloma działaniami lub rekordami innego obiektu, należy podać unikalny identyfikator rekordu w wielu wierszach dla każdego rekordu, który ma zostać powiązany.
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) i Nazwa domeny firmy (lub Identyfikator rekordu) dla każdej firmy.
Uwaga: jeśli nie dodasz unikalnych identyfikatorów (np. adres e-mail, nazwa domeny firmy, identyfikator rekordu), import spowoduje utworzenie zduplikowanych rekordów zamiast powiązania każdego z nich z tym samym rekordem.
Jeśli importujesz powiązania tego samego obiektu, obowiązują dodatkowe wymagania.
Importuj powiązania 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 można znaleźć w przykładowych plikach.
Powiązania tego samego obiektu
Możesz zaimportować jeden plik, aby zbiorczo powiązać rekordy tego samego obiektu. Podczas procesu importowania należy zaznaczyć pole wyboru, aby uwzględnić powiązania tego samego obiektu.
Podczas konfigurowania pliku należy uwzględnić informacje o powiązanych rekordach w tym samym wierszu oraz unikalny identyfikator dla każdego rekordu. Poniższe dodatkowe wymagania dotyczą importu tych samych obiektów:
- 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, ale nie można zaimportować dwóch nowych kontaktów w celu ich utworzenia i powiązania.
- Podczas kojarzenia istniejących kontaktów/firm jako unikalny identyfikator można używać tylko podstawowegoadresu e-mail/domeny firmy. Dodatkowe adresy e-mail lub domeny nie są obsługiwane.
- Jeśli łączysz 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 przykładowym pliku Rory i Jackson to nowe kontakty powiązane z unikalnymi etykietami z istniejącymi kontaktami, przy użyciu ich wartości e-mail 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ę Nadrzędny, a Rory będzie miał sparowaną etykietę Podrzędny.
Powiązania nadrzędne/podrzędne
Aby utworzyć powiązania między firmami nadrzędnymi i podrzędnymi poprzez import, dowiedz się więcej o importowaniu firm 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ązania, dodaj kolumnę Etykieta powiązania . Kolumnę tę należy dodać tylko wtedy, gdy chcesz dodać etykiety opisujące powiązania. Jeśli nie potrzebujesz etykietować 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ść Primary 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ązań w jednej komórce, oddzielając je średnikiem (np. Kierownik; Kontakt rozliczeniowy).
- Jeśli importujesz etykiety powiązania w ramach importu wielu plików, musisz uwzględnić kolumnę Etykieta powiązania oraz unikalny identyfikator obiektu, który powiązujesz w tym samym pliku.
- Jeśli importujesz etykiety sparowane:
- W przypadku powiązań między obiektami należy umieścić tylko jedną z etykiet w kolumnie „Etykieta powiązania ”. Etykiety zostaną przypisane do właściwego obiektu podczas procesu importowania.
- W przypadku powiązań tego samego obiektu rekord wkolumnie „ ” „Associated [unikalny identyfikator]” otrzyma etykietę dodaną w procesie importu lub zawartą w kolumnie etykiet pliku. Drugi rekord w wierszu otrzyma drugą etykietę z pary.
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 zapoznać się z większą liczbą przykładów z dodatkowymi właściwościami, zapoznaj się z tym artykułem zawierającym przykładowe pliki.
