마지막 업데이트 날짜: 2025년 12월 10일
HubSpot에 데이터를 가져오기 전에 파일의 형식과 기술적 제한 사항을 확인하십시오. 일부 제한 사항은 구독 유형에 따라 다릅니다. 지원되는 파일 형식, 속성 값의 구조 및 형식 지정 방법, 특정 기간 동안 가져올 수 있는 행 수와 파일 수를 숙지하십시오.
가져오기 도구의 작동 방식을 검토하고 샘플 파일 또는 생성된 예제 파일을 사용하여 데이터를 준비하십시오. 파일 준비가 완료되면 가져오기 방법을 확인하십시오.
기술적 요구사항 및 제한 사항
HubSpot으로 가져오는 모든 파일은 다음을 충족해야 합니다:- .csv, .xlsx 또는 .xls 파일이어야 합니다.
- 단일 시트만 포함해야 합니다.
- 헤더 행이 포함되어야 하며, 각 열 헤더는 HubSpot의 속성과 일치해야 합니다. 열 헤더는 임포트에 영향을 주지 않는 범위 내에서 순서를 자유롭게 구성할 수 있습니다. 헤더와 일치하는 기본 속성이 이미 존재하는지 확인하거나, 임포트 전에 사용자 정의 속성을 생성할 수 있습니다. 속성 요구 사항에 대해 자세히 알아보세요.
- 열 수가 1000개 미만이어야 합니다.
- 외국어 문자가 포함된 경우 UTF-8로 인코딩하십시오.
- Excel 파일을 가져오는 경우:
- Excel 워크시트 및 워크북의 최대 제한을 초과하지 않는 데이터를 포함해야 합니다.
- 날짜 및 시간 선택기 속성을 가져올 때 숫자 형식의 셀을 포함해야 합니다.
HubSpot 구독 유형에 따라 가져오기 도구에 적용되는 추가 기술적 제한 사항이 있습니다. 여기에는 가져오기 파일의 크기 및 행 수 제한, 일일 가져오기 가능한 파일 수 및 행 수가 포함됩니다.
- 무료 HubSpot 도구를 사용하는 경우 다음이 가능합니다:
- 최대 20MB 크기의 파일 가져오기.
- 하루에 최대 50회까지 가져오기 완료 가능.
- 하루에 최대 500,000개의 행을 가져올 수 있습니다. 500,000개 이상의 행이 포함된 파일을 가져오는 경우 완료하는 데 여러 날이 소요됩니다.
- 계정에 Smart CRM 또는 Starter, Professional, Enterprise 구독이 있는 경우 다음을 수행할 수 있습니다:
- 최대 512MB 크기의 파일을 가져올 수 있습니다.
- 하루 최대 500회까지 가져오기 완료 가능.
- 하루에 최대 10,000,000개의 행을 가져올 수 있으며, 파일당 1,048,576개의 행으로 제한됩니다. 가져오기 API를 통해 가져오는 경우 하루에 최대 80,000,000개의 행을 가져올 수 있습니다.
이러한 제한은 24시간 동안 누적 적용되며 특정 시간에 재설정되지 않습니다.HubSpot 구독 및 제한 사항에대해 자세히 알아보세요.
값 서식 지정
가져오기 파일의 각 행에 대해 속성 열의 값을 추가할 수 있습니다. 값의 서식은 속성 필드 유형과 가져오기 목적에 따라 달라집니다.
속성 필드 유형에 따른 값 서식 지정
속성 필드 유형에 따라 특정 서식 요구 사항이 있습니다:
| 필드 유형 | 요구 사항 |
| 날짜 선택기 날짜 및 시간 선택기 |
월은 숫자, 세 글자 또는 전체 이름(10, OCT, Oct, OCTOBER, October)으로 표기 가능, 연도는 두 자리 또는 네 자리(2023, 23)로 표기 가능, 구분자는 슬래시, 하이픈 또는 마침표(10/28/2023, 10-28-2023, 10.28.2023). 유효한 날짜 형식은 일 월 년(예: 28/10/2023), 월 일 년(예: 10-28-23), 또는 년 월 일(예: 2023.OCT.28)입니다. 검증 규칙을 설정한 경우, 가져온 값은 규칙을 따라야만 가져올 수 있습니다. |
| 날짜 및 시간 선택기 |
타임스탬프는 모든 파일 유형에서 hh:mm(28/10/2020 14:30) 형식으로 추가하거나, CSV 파일 또는 텍스트 숫자 형식의 셀이 있는 Excel 파일에서 밀리초 단위의 UNIX 타임스탬프로 추가할 수 있습니다. 타임스탬프를 포함하지 않으면 시간은 기본적으로 자정으로 설정됩니다. |
| 기간 |
통화 시간 속성과 같이 기간이 포함된 속성의 경우, 값은 밀리초 단위의 UNIX 타임스탬프 형식으로 지정해야 합니다. 타임스탬프 값 형식 지정 방법 및 날짜를 UNIX 형식으로 변환하는 방법에 대해 자세히 알아보세요 . |
| 열거형 |
가져오기 파일의 값은 속성의 정의된 옵션 중 레이블 또는 내부 값과 일치해야 합니다. HubSpot 기본 열거형 속성(예: 라이프사이클 단계, 산업)의 경우 값은 내부 값 또는 영어 레이블과 일치해야 합니다. |
| 파일 |
파일 속성에 기존 파일을 추가하려면 값으로 파일 ID를 포함하세요. 파일 ID는 파일 세부 정보의 일반 섹션에서 확인할 수 있습니다. |
| 여러 선택 항목 |
여러 값을 가져오려면 각 값 사이에 공백 없이 세미콜론을 추가하세요(값 1;값 2). 이러한 속성 옵션은 가져오기 전에 미리 생성해야 합니다. 값을 추가하거나 이어 붙이려면첫 번째 값 앞에 세미콜론을 추가하세요(;값 3;값 4). 이렇게 하면 기존 속성 값을 덮어쓰지 않고 값이 이어 붙여집니다. 여러 체크박스 값 가져오기에 대해 자세히 알아보세요. |
| 숫자 |
생성된 숫자 속성 유형에 따라 값을 형식화하세요:
|
| 단일 체크박스 |
단일 체크박스 필드에 대한 열을 생성하고 각 행의 값을 True또는Yes로설정하면 HubSpot에서 Yes 또는 선택됨으로 표시되고,False또는No로설정하면 HubSpot에서 No 또는 선택되지 않음으로 표시됩니다. |
| 기간 속성 |
라인 항목 속성 기간은 PnYnMnD 또는 PnW 형식의 ISO-8601 기간 형식으로 추가 해야 합니다 . 예를 들어, 연간 기간의 경우 P12M 또는 P24M을 사용합니다. 비워두면 기본 기간이 설정됩니다. |
| 텍스트 |
설정한 경우 검증 규칙을 설정한 경우, 가져온 값은 해당 규칙을 따라야 하며 그렇지 않으면 가져오지 않습니다. |
| 사용자(소유자) |
가져오기 중에 레코드나 활동에 소유자를 할당하려면:
|
추가 연락처 이메일 또는 회사 도메인
여러 개의 이메일 주소를 가진 연락처를 가져오는 경우, 보조 이메일 주소를 포함하는 '추가 이메일 주소' 열을 포함하십시오. 여러 개의 도메인 이름을 가진 회사를 가져오는 경우, 보조 도메인을 포함하는 '추가 도메인' 열을 포함하십시오. 하나의 셀에 여러 이메일 또는 도메인을 포함하려면 값을 세미콜론으로 구분하십시오(예: email@email.com; emailtwo@email.com).
연락처 또는 회사를 생성하기 위해 가져오는 경우, 새 연락처의 이메일 또는 새 회사의 회사 도메인 이름을 다른 레코드의 기존 추가 이메일/도메인으로 설정할 수 없습니다.
빈 셀
가져오기 도구는 스프레드시트의 빈 셀을 무시합니다. 따라서 새 속성 데이터를 가져올 때 해당 속성 값이 없는 레코드의 셀은 비워 두십시오. 기존 레코드가 HubSpot 내에서 해당 속성 값을 이미 가지고 있는 경우, 빈 셀은기존 속성 값을 지우지 않습니다. 기존 속성 값을 일괄 삭제하려면 값을 수동으로 편집하거나 '레코드 편집' 워크플로 작업을 사용할 수 있습니다 .거래 공동 작업
자 가져오기를 통해 거래에 공동 작업자를 추가하는 경우, 거래 공동 작업자 헤더를 포함하세요. 각 셀에는 세미콜론(;)으로 구분된 두 명 이상의 사용자를 반드시 포함해야 합니다(예: user1@example.com;user2@example.com).제품 기간 및 청구 주기
기간 속성 값을 가져오는 경우, 기간 열의 값을 월 단위 숫자(예: 10개월인 경우 10 ), X가 월 수인 PXM (예: 6개월인 경우 P6M), X가 년 수인 PXY(예: 1년인 경우 P1Y) 형식으로 지정할 수 있습니다.
청구 주기 속성 값을 가져오는 경우, 제품에 반복 가격 유형이 있는 경우 monthly, annually 또는 quarterly를 사용하십시오. 제품에 일회성 가격이 있는 경우 해당 셀을 비워 두십시오.
필수 속성
가져오는 개체 또는 활동에 따라 레코드 생성에 필요한 다음 속성은 파일의 열 머리글로 반드시 포함되어야 합니다. 레코드를 업데이트하는 경우 고유 식별자 (예: 레코드 ID, 이메일, 회사 도메인 이름)를 반드시 포함해야 합니다
.
필수사항은 아니지만,각 개체에 대해 사용자 정의 속성 및 기본 속성을 포함한 추가 속성을 가져올 수 있습니다. 연락처, 회사, 거래, 티켓, 통화, 이메일, 회의, 메모 및 작업에 대한 기본 속성을 참조하십시오. 속성 설정에서 모든 속성과 해당 값을 확인할 수도 있습니다.
- 연락처: 이름, 성 또는 이메일 중 최소 하나 .
- 회사: 이름 또는 회사 도메인 이름 중 하나이상 .
참고: 회사 도메인 이름 속성은 최상위 도메인(예: .com, .edu)까지만 값을 허용합니다. 그 뒤에 문자열이 붙은 값(예: .edu/home)은 가져올 때 자동으로 제거됩니다.
- 거래: 새 거래를 생성하는 경우거래명, 파이프라인, 거래 단계.
- 티켓: 새 티켓을 생성하는경우 티켓 이름, 파이프라인, 티켓 상태.
- 약속: 약속 시작. 약속 시작은날짜-시간 속성으로 형식화되어야 합니다.
- 코스: 코스 이름.
- 리스팅: 이름.
- 서비스: 이름, 파이프라인, 파이프라인 단계.
- 제품: 제품을 업데이트하는 경우 레코드 ID 또는 SKU.
- 주문: 이름, 파이프라인, 파이프라인 단계.
- 장바구니: 이름.
- 라인 항목: 이름, 수량, 가격 및관련 거래의 레코드 ID 또는 거래 이름. 라인 항목을 제품과도 연결하는 경우 제품의 제품 ID를 포함하세요. 이는 가져오기 과정에서 라인 항목 속성으로 매핑됩니다.
참고: 거래와 함께 품목을 가져올 경우, 가져오기 과정에서 거래 금액은 업데이트 되지 않습니다. 연관된 거래 금액을 업데이트하려면 품목을 수동으로 편집하거나 HubSpot에서 품목을 거래와 연결할 수 있습니다.
- 통화: 통화 메모. 새 통화를 가져올 때는 다음 정보도 포함하는 것이 좋습니다. 활동 날짜을 포함하는 것이 좋습니다.
- 이메일: 이메일 본문및 이메일 발신자.
- 회의:회의 설명, 회의 시작 시간 및 회의 종료 시간. 새 회의를 가져올 때 다음 정보도 포함하는 것이 좋습니다. 활동 날짜를 포함하는 것이 좋습니다. 시작 시간, 종료 시간 및 활동 날짜 값은 날짜-시간 속성으로 형식화해야 합니다.
- 메모: 메모 본문.
- 작업:작업 제목및마감일. 마감일은 날짜-시간 속성으로 형식화해야 합니다.
참고: 필수 사항은 아니지만, 새 활동을 가져올 때 활동 발생 날짜와 시간을 지정하기 위해 활동 날짜를 포함하는 것이 좋습니다. 이 속성을 포함하지 않으면 활동 날짜 값이 가져오기 날짜와 시간으로 자동 설정됩니다.
기존 레코드 업데이트 또는 중복 방지 요구사항
기존 레코드를 업데이트하고 중복 레코드를 방지하려면 파일마다 각 개체에 대한 고유 식별자 속성이 포함되어야 합니다. 모든 개체의 경우 기존 레코드를 내보내레코드 ID를 고유 식별자로 사용하거나 고유 값이 필요한 사용자 정의 속성을 사용할 수 있습니다 . 연락처의 경우 이메일도 사용할 수 있습니다 . 회사의 경우 회사 도메인 이름도 사용할 수 있습니다.
여러 개체를 가져오면서 레코드 ID를 포함하는 경우, ID를 올바른 개체와 연결할 수 있도록 파일 열 헤더를 구분하는 것이 좋습니다(예: 한 열은 '레코드 ID - 연락처', 다른 열은 '레코드 ID - 회사'로 명명).
참고:파일에 이메일 또는 회사 도메인 이름이 포함된 경우 다음동작이적용됩니다:
- 연락처 중복 제거를 위해 사용자 정의 고유 값 속성을 사용하는 경우에도 이메일 속성은 여전히 고유 값을 요구합니다.
- 사용자 정의 고유 값 속성을 사용하여 회사를 중복 제거하는 경우 회사 도메인 이름 속성은 고유 값을 요구하지 않습니다. 즉, 중복된 회사 도메인을 가져올 수 있습니다. 동일한 도메인을 가진 여러 회사를 원하지 않는다면 가져오기 전에 파일에서 중복 도메인을 제거하거나 대신 회사 도메인 이름을 고유 식별자로 사용해야 합니다.
- HubSpot에 보조 이메일 주소가 등록된 기존 연락처의 고유 식별자로 보조 이메일을 사용할 수 있습니다. 보조 이메일을 사용하고 파일에 레코드ID 열을 포함하지 않으면 보조 이메일이 기본 이메일을 대체하지 않습니다. 그러나 파일에 보조 이메일과 레코드 ID를 모두 열로 포함하면 보조 이메일이 기본 이메일을 대체합니다.
레코드 연결 요구 사항
하나의 파일로 연결 정보 가져오기
하나의 파일에서 행당 두 개 이상의 레코드를 연결할 수 있습니다. 연결된 레코드 및/또는 활동에 대한 정보를 동일한 행에 포함하고 각 개체에 대한 고유 식별자를 포함하세요. 하나의 레코드를 여러 활동 또는 다른 개체의 레코드와 연결하려면 연결하려는 각 레코드에 대해 해당 레코드의 고유 식별자를 여러 행에 포함하세요.
예를 들어, Luke Danes는 Luke's Diner의 매니저이지만 The Dragonfly Inn의 계약직 직원입니다. 그를 두 회사와 모두 연결하려면 Luke Danes에 대해 두 개의 행을 포함해야 하며, 각 회사별로 이메일 (또는 레코드 ID)과 회사 도메인 이름 (또는 레코드 ID) 열을 포함해야 합니다.
참고: 고유 식별자(예: 이메일, 회사 도메인 이름, 레코드 ID)를 포함하지않으면 , 가져오기 과정에서 중복 레코드가 생성되며 동일한 레코드에 연결되지 않습니다.
동일 객체 연결을 가져오는 경우 추가 요구 사항이 있습니다.
두 파일로 연결 가져오기
두 파일의 서로 다른 객체 레코드를 연결하려면 각 파일의 레코드를 연결하는 공통 열을 사용하세요. 레코드 가져오기 및 연결에 대한 자세한 도움말은 예제 파일을 참조하세요.
동일 객체 연결
동일 객체의 레코드를 일괄 연결하려면 하나의 파일을 가져오면 됩니다. 가져오기 과정에서 동일 객체 연결을 포함하도록 체크박스를 선택해야 합니다.
파일을 설정할 때 연결된 레코드에 대한 정보를 동일한 행에 포함하고 각 레코드에 고유 식별자를포함하세요. 동일 객체 가져오기에 특화된 추가 요구 사항은 다음과 같습니다:
- 레코드 쌍 중 최소 한 레코드는 가져오기 전에 HubSpot에 이미 존재해야 합니다. 예를 들어, 새 연락처를 가져와 기존 연락처와 연결할 수는 있지만, 두 개의 새 연락처를 생성하고 연결하기 위해 가져올수는 없습니다.
- 기존 연락처/기업을 연결할 때는 고유 식별자로 기본이메일/기업 도메인만 사용할 수 있습니다. 보조 이메일이나 도메인은 지원되지 않습니다.
- 하나의 레코드에 여러 레코드를 연결하는 경우, 동일한 셀 내에서 레코드의 고유 식별자 값을 세미콜론(;)으로 구분하십시오(예:luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com).
아래 예시 파일에서 Rory와 Jackson은이메일값을 고유 식별자로 사용하여 기존 연락처에 고유 레이블을 연결하는 새 연락처입니다. Sookie는 동일한 레이블로 두 기존 연락처에 연결되는 기존 연락처입니다. 첫 번째 행에서 연결 레이블은 레이블 쌍의 일부이므로, 가져오기가 완료되면 연결된 레코드에는'Parent'레이블이, Rory에는쌍을 이루는'Child' 레이블이 부여됩니다.
부모/자식 연결
가져오기를 통해 자회사-모회사 연결을 생성하려면 자회사 가져오기에 대해 자세히 알아보세요 .
사용자 정의 연결 레이블
구독 필요 사용자 지정 연결 레이블을 사용하려면 Professional 또는 Enterprise 구독이 필요합니다.
연관 레이블을 가져오려면 '연관 레이블'열을포함하세요. 이 열은 연관 관계를 설명하는 레이블을 추가하려는 경우에만 추가해야 합니다. 연관 레이블이 필요하지 않다면 이 열은 필수 사항이 아닙니다.
- 가져오기 전에 HubSpot에서 연결 레이블을 생성해야 합니다.
- 회사 연결을 기본으로 설정하려면 해당 행의 연결 레이블 열에 값 '기본'을 포함하세요.
- 두 레코드 간의 관계를 설명하기 위해 여러 레이블을 설정하려면 하나의 셀에 세미콜론(;)으로 구분된 여러 연관 레이블 값을 포함할 수 있습니다(예: Manager; Billing contact).
- 여러 파일을 가져와 연관 레이블을 가져오는 경우, 연관 레이블 열과 연관 대상 개체의 고유 식별자를 동일한 파일에 포함해야 합니다 .
- 쌍으로 된 레이블을 가져오는 경우:
- 크로스 객체 연관 관계의 경우, 연관 레이블 열에는 레이블 중 하나만 포함하세요. 레이블은 가져오기 과정에서 올바른 객체에 할당됩니다.
- 동일 개체 간 연관 관계의 경우,'연관된 [고유 식별자]' 열의 레코드는 가져오기 과정에서 추가되거나파일의 레이블 열에 포함된 레이블을 받게 됩니다. 행의 다른 레코드는 쌍의 다른 레이블을 받게 됩니다.
예제 파일
가져오기 프로세스 시작 시 선택한 개체 및 활동에 필요한 속성이 포함된 예제 파일을 생성할 수 있습니다. 추가 속성이 포함된 더 많은 예제를 확인하려면 샘플 파일이 포함된 이 문서를 참조하십시오.
