Data ostatniej aktualizacji: 10 grudnia 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 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.
Zapoznaj się z działaniem narzędzia do importowania i przygotuj dane, korzystając z plików przykładowych lub wygenerowanych plików przykładowych. 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 z bezpłatnych narzędzi HubSpot, możesz:
- Importować pliki o rozmiarze do 20 MB.
- Wykonaj 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ę Smart CRM lub 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 osubskrypcji HubSpot i jej ograniczeniach.
Formatowanie wartości
Do każdego wiersza importowanego pliku 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 |
| Selektor 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 dwiema 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 sprawdzania poprawności, 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 podasz 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 ś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 pojedynczego pola wyboru i ustaw wartość w każdym wierszu na TruelubYes, aby wyświetlać jako Yes lub zaznaczone w HubSpot, lubFalselubNo,aby wyświetlać jako No lub niezaznaczone w HubSpot. |
| Właściwości terminu |
Właściwość pozycji Wykres powinna być dodana 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 warunki. |
| 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 e-mail. 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 jako adresu e-mail lub domeny, 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 Okres można sformatować wartość w kolumnie Okres jako liczbę miesięcy (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. Jeśli produkt ma cenę jednorazową, komórkę należy pozostawić pustą.
Wymagane właściwości
W zależności od importowanych obiektów lub działań, do utworzenia rekordów wymagane są następujące właściwości, które muszą być uwzględnione jako nagłówki kolumn w plikach. Jeśli aktualizujesz rekordy, musisz dołączyć unikalny identyfikator (np. identyfikator rekordu, adres e-mail, nazwę domeny firmy).
Chociażnie jest to wymagane, możesz 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ść nazwy 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 jakowł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 identyfikator rekordu powiązanej transakcji lub nazwa transakcji. Jeśli pozycja jest powiązana z produktem, należy podać identyfikator produktu , który zostanie przypisany jako właściwość pozycji podczas importu.
Uwaga: podczas importowania pozycji 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 datę działania.
- E-maile: treść e-mailai kierunek e-maila.
- Spotkania:opis spotkania, czas rozpoczęcia spotkania i czas zakończenia spotkania. Podczas importowania nowych spotkań zaleca się również uwzględnienie datę działania. Wartości godziny rozpoczęcia, godziny zakończenia i daty działania powinny być sformatowane jako właściwości daty i godziny.
- Notatki: treść notatki.
- Zadania:Tytuł zadaniaitermin 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.
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 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ść 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, aby wiele firm miało 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 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 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 Adres e-mail (lub identyfikator rekordu) oraz Nazwa domeny firmy (lub identyfikator rekordu) dla każdej firmy.
Uwaga: jeśli nie podasz 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.
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 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 i podać unikalny identyfikatordla każdego rekordu. Poniższe dodatkowe wymagania dotyczą importowania tego samego obiektu:
- Co najmniej 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 kojarzenia istniejących kontaktów/firm jako unikalny identyfikator można używać tylko podstawowego adresue-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ś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” (Rodzic),a Rorybędzie miał sparowaną etykietę„Child”(Dziecko).
Powiązania rodzic/dziecko
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ązania
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ązaniadla tego wiersza.
- Aby ustawić wiele etykiet opisujących relację między dwoma rekordami, można dodać 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 importujeszetykiety 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 Powiązany [unikalny identyfikator] otrzyma etykietę dodaną wprocesie 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.
