마지막 업데이트 날짜: 2025년 11월 20일
HubSpot에 데이터를 가져오기 전에 다음 제한 사항 및 요구 사항을 검토하십시오. 시작하는 데 도움이 되도록 샘플 파일을 확인하거나 예제 파일을 생성할 수도 있습니다.
가져오기 도구에 대한 자세한 내용은 이 문서를 참조하십시오. 파일이 준비되었다면 가져오기 방법을 알아보세요.
기술적 요구 사항 및 제한 사항
HubSpot으로 가져오는 모든 파일은 다음을 충족해야 합니다:- .csv, .xlsx 또는 .xls 파일이어야 합니다.
- 단일 시트만 포함해야 합니다.
- 헤더 행이 포함되어 있어야 하며, 각 열 헤더는 HubSpot의 속성과 일치해야 합니다. 열 헤더는 가져오기에 영향을 주지 않는 범위 내에서 순서를 자유롭게 구성할 수 있습니다. 가져오기 전에 헤더와 일치하는 기본 속성이 이미 존재하는지 확인하거나 사용자 정의 속성을 생성할 수 있습니다. 속성 요구 사항에 대해 자세히 알아보세요.
- 열 수가 1000개 미만이어야 합니다.
- 외국어 문자가 포함된 경우 UTF-8로 인코딩해야 합니다.
- Excel 파일을 가져오는 경우:
- Excel 워크시트 및 워크북의 최대 제한을 초과하지 않는 데이터를 포함해야 합니다.
- 날짜 및 시간 선택기 속성을 가져올 때 숫자 형식의 셀을 포함해야 합니다.
HubSpot 구독 유형에 따라 가져오기 도구에 적용되는 추가 기술적 제한 사항이 있습니다. 여기에는 가져오기 파일의 크기 및 행 수 제한, 일일 가져오기 가능한 파일 수 및 행 수가 포함됩니다.
- 무료 또는 Smart CRM Professional /Enterprise 도구만 사용하는 경우 다음이 가능합니다:
- 최대 20MB 크기의 파일 가져오기.
- 하루 최대 50회까지 가져오기 완료 가능.
- 하루 최대 500,000개의 행을 가져올 수 있습니다. 500,000개 이상의 행이 포함된 파일을 가져오는 경우 완료까지 여러 날이 소요됩니다.
- 귀하의 계정이 스타터, 프로페셔널 또는 엔터프라이즈 구독을 보유한 경우 다음을 수행할 수 있습니다:
- 최대 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는 파일 세부 정보의 일반 섹션에서 확인할 수 있습니다. |
| 여러 개의 체크박스 |
여러 값을 가져오려면 각 값 사이에 공백 없이 세미콜론을 추가하세요(value 1;value 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를 모두 열로 포함하면 보조 이메일이 기본 이메일을 대체합니다.
레코드 연결을 위한 요구 사항
하나의 파일로 연결 관계 가져오기
하나의 파일에서 행당 두 개 이상의 레코드를 연결할 수 있습니다. 연결된 레코드 및/또는 활동에 대한 정보를 동일한 행에 포함하고 각 개체에 대해 고유 식별자를 포함하십시오. 하나의 레코드를 여러 활동 또는 다른 개체의 레코드와 연결하려면 연결하려는 각 레코드에 대해 해당 레코드의 고유 식별자를 여러 행에 포함하십시오.
예를 들어, 루크 데인스는 루크 다이너의 매니저이지만 드래곤플라이 인의 계약직 직원입니다. 그를 두 회사와 모두 연관시키려면, 각 회사별로 이메일 (또는 레코드 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).
- 다중 파일 가져오기로 연관 레이블을 가져오는 경우, 동일 파일에 '연관 레이블' 열과 연관 대상 개체의 고유 식별자를 포함해야 합니다 .
- 쌍으로 된 레이블을 가져오는 경우:
- 크로스 객체 연관 관계의 경우, 연관 레이블 열에는 레이블 중 하나만 포함하세요. 레이블은 가져오기 과정에서 올바른 객체에 할당됩니다.
- 동일 개체 간 연관 관계의 경우, 의 '연관된 [고유 식별자]' 열에 있는 레코드는 가져오기 과정에서 추가되거나 파일의 레이블 열에 포함된 레이블을 받게 됩니다. 행의 다른 레코드는 쌍의 다른 레이블을 받게 됩니다.
예시 파일
가져오기 프로세스 시작 시 선택한 개체 및 활동에 필요한 속성을 가진 예제 파일을 생성할 수 있습니다. 추가 속성이 포함된 더 많은 예제를 확인하려면 샘플 파일이 포함된 이 문서를 참조하십시오.
