Konfiguracja plików importu
Data ostatniej aktualizacji: maja 8, 2025
Dostępne z każdą z następujących podpisów, z wyjątkiem miejsc, w których zaznaczono:
|
Przed importem danych do HubSpot należy dokonać oceny obserwujących ograniczeń i wymagań. 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 Import, zapoznaj się z tym artykułem. Jeśli plik jest gotowy, dowiedz się, jak wykonać import.
Wymagania techniczne i ograniczenia
Wszystkie pliki importowane do HubSpot muszą:- Plik .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ć organiczne w dowolnej kolejności bez wpływu na import. Przed importem można sprawdzić, czy istnieje już domyślna właściw ość pasująca do nagłówka lub utworzyć właściwość niestandardową. 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 importu właściwości selektora daty i czasu.
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 importować dziennie.
- Jeśli korzystasz z bezpłatnych narzędzi HubSpot, możesz to zrobić:
- Importować pliki o rozmiarze do 20 MB.
- Wykonać do 50 importów dziennie.
- Importować do 500 000 wierszy dziennie. Import pliku zawierającego więcej niż 500 000 wierszy zajmie kilka dni.
- Jeśli twoje konto ma 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 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ć obserwujące reguły, w przeciwnym razie nie zostaną zaimportowane. |
Wybór daty i godziny |
Reklamy mogą być dodawane 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ść Czas trwania połączenia, 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 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, należy podać ID pliku jako wartość. Identyfikator pliku można znaleźć w sekcji Ogólne w szczegółach pliku. |
Wiele pól wyboru |
Aby importować wiele wartości, należy dodać ś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ść na podstawie typu utworzonej właściwości number:
|
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ść Term |
Właściwość pozycji Term powinna być dodawana w formatach okresów ISO-8601 PnYnMnD lub PnW. Na przykład P12M lub P24M dla terminów rocznych. Pozostawienie pustego pola spowoduje ustawienie domyślnych terminów. |
Tekst |
Jeśli ustawiłeś reguły walidacji, importowane wartości muszą być obserwujące reguły, w przeciwnym razie nie zostaną zaimportowane. |
Użytkownik (Właściciel) |
Aby przypisać właściciela do rekordu lub aktywności podczas importu:
|
Dodatkowe wiadomości e-mail do kontaktu lub domeny firmy
Jeśli importujesz kontakty z więcej niż jednym adresem e-mail, dołącz kolumnę Dodatkowe adresy e-mail z ich dodatkowymi wiadomościami 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 wiadomości 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ć E-maila nowego kontaktu lub Nazwy domeny nowej firmy na e-mail lub domenę, która jest istniejącym dodatkowym e-mailem/domeną dla innego rekordu.
Puste komórki
Narzędzie importu ignoruje puste komórki w arkuszu kalkulacyjnym, więc podczas importu 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ść dla właściwości w HubSpot, puste komórki będą nie wyczyści 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żyj Wyczyść działanie przepływu pracywartości właściwości .Współpracownicy Transakcji
Jeśli dodajesz współpracowników do transakcji za pomocą importu, dołącz opcję Współpracownik Transakcji nagłówek. W każdej komórce należy podać dwóch lub więcej użytkowników oddzielonych średnikami (np. user1@example.com;user2@example.com).Okres obowiązywania produktu i częstotliwość rozliczeń
W przypadku importu wartości właściwości Termin, można sformatować wartość w kolumnie Termin jako liczbę w miesiącach (np. 10 dla 10 miesięcy), jako PXM , gdzie X jest liczbą miesięcy (np. P6M, dla terminu 6 miesięcy) lub PXY, gdzie X jest liczbą lat (np. P1Y, dla terminu 1 roku).
W przypadku importu wartości właściwości Częstotliwość rozli czeń, użyj miesięcznej, rocznej lub kwartalnej, 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 tego, które obiekty lub działania są importowane, następujące właściwości są wymagane do tworzenia rekordów i muszą być zawarte jako nagłówki kolumn w plikach. Jeśli aktualizujesz rekordy, musisz dołączyć unikalny identyfikator (np. ID rekordu, Wiadomość 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 właściwościami domyślnymi dla Kontaktów, Firm, Transakcji, Zgłoszeń, Połączeń, Wiadomości e-mail, Spotkań, Notatek i Zadań. Wszystkie właściwości i ich wartości można również wyświetlić w ustawieniach właściwości.
- Kontakt: co najmniej jeden z następujących elementów: Imię, Nazwisko lub Wiadomość e-mail.
- Firmy: co najmniej jedno z następujących pól: Nazwa lub Nazwa domeny firmy.
- Transakcje: jeśli tworzysz nowe transakcje, Nazwa transakcji, Proces sprzedaży i Etap transakcji.
- Zgłoszenia : jeśli tworzysz nowe zgłoszenia, Nazwa zgłoszenia, Proces przetwarzania zgłoszeń i Status zgłoszenia.
- Powołania: Początek spotkania. Początek spotkania powinien być sformatowany jako właściwość daty i godziny.
- Kursy: Nazwa kursu.
- Listy: Nazwa.
- Usługi: Nazwa, Proces i Etap procesu.
- Produkty: jeśli tworzysz produkty, Cena jednostkowa i Nazwa.
- Zamówienia: Nazwa, Proces i Etap procesu.
- Koszyki: Nazwa.
- Pozycje: Nazwa, Ilość, Cena i powiązanie rekordu transakcji lub nazwy transakcji. Uwzględnij identyfikator produktu , jeśli pozycja jest powiązana z Właściwością produktu, która zostanie mapowana jako właściwość pozycji podczas importu.
Uwaga: w przypadku importu pozycji z transakcjami, import nie zaktualizuje kwoty transakcji. Aby zaktualizować powiązaną kwotę transakcji, można ręcznie edytować pozycje lub powiązać pozycje z transakcją w HubSpot.
- Połączenia: Notatki dotyczące połączeń. Podczas importu 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 wykonania powinien być sformatowany jako właściwość data-czas.
Uwaga: choć nie jest to wymagane, zaleca się uwzględnienie daty aktywności podczas importu nowych aktywności w celu określenia daty i godziny wystąpienia aktywności. Jeśli właściwość ta nie zostanie uwzględniona, 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 eksportować istniejące rekordy i użyć ID rekordu jako unikalnego identyfikatora lub użyć właściwości niestandardowej, która wymaga unikalnych wartości. W przypadku Kontaktów można również użyć Wiadomość e-mail. W przypadku firm można również użyć Nazwy domeny firmy.
Jeśli importujesz wiele obiektów i dołączasz do nich identyfikatory rekordów, zalecane jest zróżnicowanie 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 Wiadomość e-mail lub Nazwa domeny firmy są zawarte w pliku:
- Jeśli używasz niestandardowej właściwości unikatowej wartości do deduplikacji kontaktów, właściwość E-mail będzie nadal wymagać unikatowych wartości.
- Jeśli używasz niestandardowej właściwości unikalnej wartości do deduplikacji firm, właściwość Nazwa domeny firmy nie będzie wymagać unikalnych 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 na liście w HubSpot. Jeśli użyjesz dodatkowego adresu e-mail i nie umieścisz w pliku kolumny ID rekordu, dodatkowy adres e-mail nie zastąpi głównego 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 główny adres e-mail.
Wymagania dotyczące Powiązania rekordu
Import powiązań w jednym pliku
W jednym pliku można powiązać dwa lub więcej rekordów w jednym wierszu. Dołącz informacje o powiązanych rekordach i/lub działaniach w tym samym wierszu i dołącz unikalny identyfikator dla każdego obiektu. Aby powiązać 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 powiązać.
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, musisz dołączyć dwa wiersze dla Luke'a Danesa z kolumnami Wiadomość e-mail (lub Identyfikator rekordu) i Nazwa domeny firmy (lub Identyfikator rekordu) dla każdej firmy.
Uwaga: jeśli nie podasz unikalnych identyfikatorów (np. Wiadomość e-mail, Nazwa domeny firmy, ID rekordu), import utworzy zduplikowane rekordy zamiast powiązania każdego z nich z tym samym rekordem.
W przypadku importowania powiązań tych samych obiektów istnieją dodatkowe wymagania.
Import 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 z tym samym obiektem
Możesz importować jeden plik, aby powiązać rekordy tego samego obiektu zbiorczo. Podczas procesu importu 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 dołączyć unikalny identyfikator dla każdego rekordu. Obserwujące dodatkowe wymagania są specyficzne dla importu tego samego obiektu:
- Co najmniej jeden rekord w parze rekordów musi już istnieć w HubSpot przed importem. Na przykład, można importować nowy kontakt i powiązać go z istniejącym kontaktem, ale nie można importować w celu utworzenia i powiązania dwóch nowych kontaktów.
- Podczas powiązania istniejących kontaktów/firm można użyć tylko podstawowej wiadomoście-mail/domeny firmy jako unikalnego identyfikatora. Dodatkowe wiadomości e-mail lub domeny nie są obsługiwane.
- W przypadku powiązania wielu rekordów z jednym rekordem należy oddzielić 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 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ę Rodzic, a Rory będzie miał sparowaną etykietę Dziecko.

Powiązania rodzic/dziecko
Aby utworzyć powiązania jednostki zależnej z jednostką nadrzędną za pomocą importu, dowiedz się więcej o importowaniu jednostek zależnych.
Niestandardowe etykiety powiązań( tylkoProfessional i Enterprise )
Aby importować etykiety powiązań, należy dołączyć kolumnę Etykieta powiązania . Kolumna ta powinna być dodana tylko wtedy, gdy chcesz dodać etykiety powiązań. Jeśli etykieta powiązania nie jest potrzebna, kolumna ta nie jest wymagana.
- Etykiety powiązań należy utworzyć w HubSpot przed importem.
- Aby ustawić powiązanie firmy jako podstawowe, umieść wartość Primary w kolumnie Etykieta powiązania dla tego wiersza.
- Aby ustawić wiele etykiet opisujących powiązania między dwoma rekordami, można 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ązań w imporcie wielu plików, musisz dołączyć kolumnę Etykieta powiązania i unikalny identyfikator powiązanego obiektu w tym samym pliku.
- W przypadku importu sparowanych etykiet:
- W przypadku Właściwości współdzielonych należy uwzględnić tylko jedną z etykiet w kolumnie Etykieta powiązania. Etykiety zostaną przypisane do właściwego obiektu podczas procesu importu.
- W przypadku powiązań tego samego obiektu, rekord w kolumnie Associated [unique identifier] otrzyma etykietę powiązania dodaną w procesie importu lub zawartą w kolumnie Etykieta pliku. Drugi rekord w wierszu otrzyma drugą etykietę w parze.
Przykładowe pliki
Na początku procesu importu można wygenerować przykładowy plik z wymaganymi właściwościami dla wybranych obiektów i działań. Jeśli chcesz ocenić więcej przykładów z dodatkowymi właściwościami, zapoznaj się z tym artykułem z przykładowymi plikami.
