가져오기 파일 설정
마지막 업데이트 날짜: 2월 12, 2025
명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.
|
HubSpot으로 데이터를 가져오기 전에 다음 제한 사항 및 요구 사항을 검토하세요. 샘플 파일에 액세스하거나 예제 파일을 생성하여 시작할 수도 있습니다.
가져오기 도구에 대해 자세히 알아보려면 이 문서를 참조하세요. 파일이 준비되면 가져오기 방법을 알아보세요.
기술 요구 사항 및 제한 사항
HubSpot으로 가져오는 모든 파일은 반드시 최신 파일이어야 합니다:- .csv, .xlsx 또는 .xls 파일이어야 합니다.
- 한 장만 있어야 합니다.
- 각 열 헤더가 HubSpot의 속성에 해당하는 헤더 행을 포함해야 합니다. 열 머리글은 가져오기에 영향을 주지 않고 어떤 순서로든 구성할 수 있습니다. 헤더와 일치하는 기본 속성이 이미 있는지 확인하거나 가져오기 전에 사용자 지정 속성을 만들 수 있습니다. 속성 요구 사항에 대해 자세히 알아보세요.
- 1000개 미만의 열을 포함해야 합니다.
- 외국어 문자가 포함된 경우 UTF-8로 인코딩해야 합니다.
- Excel 파일을 가져오는 경우:
- Excel의 워크시트 및 통합 문서 최대 한도를 넘지 않는 데이터를 포함해야 합니다.
- 날짜 및 시간 선택기 속성을 가져올 때는 숫자 형식의 셀을 포함해야 합니다.
HubSpot 구독에 따라 가져오기 도구에 대한 추가적인 기술적 제한이 있습니다. 이러한 제한에는 가져오기 파일의 크기 및 행 제한과 하루에 가져올 수 있는 파일 및 행 수 제한이 포함됩니다.
- HubSpot의 무료 도구를 사용하는 경우에는 가능합니다:
- 최대 20MB까지 파일 가져오기.
- 하루에 최대 50개의 가져오기를 완료할 수 있습니다.
- 하루에 최대 500,000개의 행을 가져올 수 있습니다. 500,000개 이상의 행이 포함된 파일을 가져오면 완료하는 데 며칠이 걸립니다.
- 계정에 스타터, 프로페셔널 또는 엔터프라이즈 구독이 있는 경우 가능합니다:
- 최대 512MB까지 파일을 가져올 수 있습니다.
- 하루에 최대 500개까지 가져오기를 완료할 수 있습니다.
- 파일당 1,048,576행으로 제한하여 하루에 최대 10,000,000행까지 가져오기. 가져오기 API를 통해 가져오는 경우, 하루에 최대 80,000,000개의 행을 가져올 수 있습니다.
이러한 제한은 24시간 단위로 적용되며 하루 중 특정 시간대에 재설정되지 않습니다. HubSpot 구독 및 제한 사항에 대해 자세히 알아보세요.
값 서식 지정
가져오기 파일의 각 행에 대해 속성 열에 값을 추가할 수 있습니다. 값의 서식은 가져오기의 속성 필드 유형 및 목표에 따라 달라집니다.
속성 필드 유형에 따른 값 서식 지정
속성 필드 유형에 따라 특정 서식 지정 요구 사항이 있습니다:
필드 유형 | 요구 사항 |
날짜 선택기 날짜 및 시간 선택기 |
월은 숫자, 세 글자 또는 전체 이름(10, OCT, Oct, 10월, 10월), 연도는 두 자리 또는 네 자리(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에서 예 또는 체크된 것으로 표시하거나 False또는No로 설정하여 HubSpot에서 아니오 또는 체크되지 않은 것으로 표시합니다. |
학기 속성 |
줄 항목 속성 Term은 ISO-8601 기간 형식인 PnYnMnD 또는 PnW로 추가해야 합니다. 예를 들어, 연간 기간의 경우 P12M 또는 P24M입니다. 비워두면 기본 기간이 설정됩니다. |
텍스트 |
유효성 검사 규칙을설정한 경우 가져온 값이 규칙을 따라야 하며 그렇지 않으면 가져오지 않습니다. |
사용자(소유자) |
가져오기 중에 레코드 또는 활동에 소유자를 할당합니다:
|
추가 연락처 이메일 또는 회사 도메인
이메일 주소가 두 개 이상인 연락처를 가져오는 경우에는 추가 이메일 주소 열에 보조 이메일을 포함하세요. 도메인 이름이 두 개 이상인 회사를 가져오는 경우에는 추가 도메인 열에 보조 도메인을 포함하세요. 한 셀에 여러 개의 이메일 또는 도메인을 포함하려면 세미콜론(예: email@email.com, emailtwo@email.com)으로 값을 구분하세요.
연락처나 회사를 만들기 위해 가져오기하는 경우에는 새 연락처의 이메일이나 새 회사의 회사 도메인 이름을 다른 레코드의 기존 추가 이메일/도메인인 이메일이나 도메인으로 설정할 수 없습니다.
빈 셀
가져오기 도구는 스프레드시트에서 빈 셀을 무시하므로 새 속성 데이터를 가져올 때는 해당 속성의 값이 없는 레코드의 셀을 비워 두세요. 기존 레코드에 이미 HubSpot 내의 속성 값이 있는 경우 빈 셀을 비워도 기존 속성 값은 지워지지 않습니다. 기존 속성 값을 일괄적으로 지우려면 값을 수동으로 편집하거나 속성 값 지우기 워크플로 작업을 사용할 수 있습니다 .거래 공동 작업자
가져오기를 통해 거래에 공동 작업자를 추가하는 경우 거래 공동 작업자 헤더를 포함하세요. 각 셀에 두 명 이상의 사용자를 세미콜론으로 구분하여 포함해야 합니다(예: user1@example.com;user2@example.com).제품 기간 및 청구 주기
기간 속성 값을 가져오는 경우 기간 열의 값을 월 단위 숫자(예: 10개월의 경우 10 ), X가 개월 수(예: 6개월의 경우 P6M) 또는 X가 년 수(예: 1년의 경우 P1Y)인 PXM으로 형식화할 수 있습니다.
청구 빈도 속성 값을 가져오는 경우 제품에 정기결제 가격 유형이 있는 경우 월별, 연간 또는 분기별을 사용합니다. 제품에 일회성 가격이 있는 경우 셀을 비워 둡니다.
필수 속성
가져오려는 개체 또는 활동에 따라 레코드를 만드는 데 필요한 속성은 다음과 같으며 파일에 열 헤더로 포함되어야 합니다. 레코드를 업데이트하는 경우에는 고유 식별자 (예: 레코드 ID, 이메일, 회사 도메인 이름)를 포함해야 합니다.
필수는아니지만사용자 지정 및 기본 속성을 포함하여 각 개체에 대한 추가 속성을 가져올 수 있습니다. 연락처, 회사, 거래, 티켓, 통화, 이메일, 회의, 노트, 작업에 대한 기본 속성을 참조하세요. 속성 설정에서 모든 속성과 해당 값을 볼 수도 있습니다.
- 연락처: 이름, 성, 이메일 중 하나 이상 .
- 회사: 이름 또는 회사 도메인 이름 중 하나 이상 .
- 거래: 새 거래를 만드는 경우 거래 이름, 파이프라인, 거래 단계 중 하나입니다.
- 티켓: 새 티켓을 만드는 경우에는 티켓 이름, 파이프라인 및 티켓 상태입니다.
- 약속: 약속 시작. 약속 시작은 날짜 시간 속성으로 형식이 지정되어야 합니다.
- 코스: 코스 이름입니다.
- 목록: 이름.
- 서비스: 이름, 파이프라인 및 파이프라인 단계.
- 제품: 제품을 생성하는 경우 단가 및 이름.
- 주문: 이름, 파이프라인 및 파이프라인 단계.
- 품목: 이름, 수량, 가격 및 연결된 거래의 레코드 ID 또는 거래 이름. 품목을 제품과 연결하는 경우 제품의 제품 ID도 포함하면 가져오기 중에 품목 속성으로 매핑됩니다.
참고: 거래와 함께 품목을 가져올 때 품목을 가져오면 거래 금액은 업데이트되지 않습니다. 연결된 거래 금액을 업데이트하려면 품목을 수동으로 편집하거나 HubSpot에서 품목을 거래와 연결할 수 있습니다.
- 통화: 통화: 통화 메모. 새 통화를 가져올 때는 활동 날짜도 포함하는 것이 좋습니다.
- 이메일: 이메일 본문 및 이메일 방향.
- 회의: 회의 설명, 회의 시작 시간, 회의 종료 시간. 새 회의를 가져올 때 활동 날짜도 포함하는 것이 좋습니다. 시작 시간, 종료 시간 및 활동 날짜 값은 날짜-시간 속성으로 서식을 지정해야 합니다.
- 노트: 노트 본문.
- 작업: 작업 제목과 마감일. 마감일은 날짜-시간 속성으로 서식을 지정해야 합니다.
참고: 필수는 아니지만 새 활동을 가져올 때 활동이 발생한 날짜와 시간을 지정하려면 활동 날짜를 포함하는 것이 좋습니다. 이 속성을 포함하지 않으면 활동 날짜 값이 가져오기 날짜와 시간으로 자동 설정됩니다.
기존 레코드를 업데이트하거나 중복을 피하기 위한 요구 사항
기존 레코드를 업데이트하고 레코드 중복을 방지하려면 파일에 각 개체에 대한 고유 식별자 속성을 포함해야 합니다. 모든 개체의 경우 기존 레코드를 내보내고 레코드 ID를 고유 식별자로 사용하거나 고유 값이 필요한 사용자 지정 속성을 사용할 수 있습니다 . 연락처의 경우 이메일도 사용할 수 있습니다. 회사의 경우 회사 도메인 이름을 사용할 수도 있습니다.
여러 개체를 가져오면서 레코드 ID를 포함하는 경우에는 파일 열 헤더를 구분하여 ID를 올바른 개체와 일치시키는 것이 좋습니다(예: 한 열은 레코드 ID - 연락처, 다른 열은 레코드 ID - 회사로 구분하는 것이 좋습니다).
참고: 이메일 또는 회사 도메인 이름이 파일에 포함된 경우 다음 동작이 적용됩니다:
- 사용자 지정 고유값 속성을 사용하여 연락처를 중복 제거하는 경우 이메일 속성에는 여전히 고유값이 필요합니다.
- 사용자 지정 고유값 속성을 사용하여 회사를 중복 제거하는 경우 회사 도메인 이름 속성에는 고유값이 필요하지 않습니다. 즉, 중복된 회사 도메인을 가져올 수 있습니다. 동일한 도메인을 가진 여러 회사를 가져오지 않으려면 가져오기 전에 파일에서 중복 도메인을 제거하거나 회사 도메인 이름을 고유 식별자로 대신 사용해야 합니다.
- HubSpot에 등록된 보조 이메일 주소가 있는 기존 연락처의 고유 식별자로 보조 이메일을 사용할 수 있습니다. 보조 이메일을 사용하고 파일에 레코드 ID 열을 포함하지 않으면 보조 이메일이 기본 이메일을 대체하지 않습니다 . 그러나 파일에 보조 이메일과 레코드 ID를 모두 열로 포함하면 보조 이메일이 기본 이메일을 대체합니다.
레코드를 연결하기 위한 요구 사항
하나의 파일에서 연결 가져오기
하나의 파일에서 행당 두 개 이상의 레코드를 연결할 수 있습니다. 연결된 레코드 및/또는 활동에 대한 정보를 같은 행에 포함시키고 각 개체에 대한 고유 식별자를 포함하세요. 하나의 레코드를 여러 활동 또는 다른 객체의 레코드와 연결하려면 연결하려는 각 레코드에 대해 레코드의 고유 식별자를 여러 행에 포함하세요.
예를 들어 루크 데인즈는 루크스 다이너의 매니저이지만 더 드래곤플라이 인의 계약자입니다. 그를 두 회사에 연결하려면 각 회사의 이메일 (또는 레코드 ID) 및 회사 도메인 이름 (또는 레코드 ID) 열과 함께 Luke Danes에 대한 두 행을 포함해야 합니다.
참고: 고유 식별자(예: 이메일, 회사 도메인 이름, 레코드 ID)를 포함하지 않으면 가져오기 시 각각을 동일한 레코드에 연결하는 대신 중복 레코드가 생성됩니다.
동일한 개체 연결을 가져오는 경우에는 추가 요구 사항이 있습니다.
두 파일에서 연결 가져오기
두 파일에 있는 두 개체의 레코드를 연결하려면 공통 열을 사용하여 각 파일에 있는 레코드를 연결합니다. 레코드 가져오기 및 연결에 대한 자세한 도움말은 예제 파일을 참조하세요.
동일한 객체 연결
하나의 파일을 가져와서 동일한 객체의 레코드를 일괄적으로 연결할 수 있습니다. 가져오기 프로세스 중에 동일한 객체 연결을 포함하려면 확인란을 선택해야 합니다.
파일을 설정할 때 동일한 행에 연결된 레코드에 대한 정보를 포함하고 각 레코드에 고유 식별자를 포함하세요. 다음 추가 요구 사항은 동일한 객체 가져오기에만 해당됩니다:
- 가져오기 전에 레코드 쌍의 레코드가 하나 이상 HubSpot에 이미 존재해야 합니다. 예를 들어 새 연락처를 가져와서 기존 연락처와 연결할 수는 있지만 두 개의 새 연락처를 만들어 연결하기 위해 가져올 수는 없습니다.
- 기존 연락처/회사를 연결할 때는 기본 이메일/회사도메인만 고유 식별자로 사용할 수 있습니다. 보조 이메일이나 도메인은 지원되지 않습니다.
- 여러 개의 레코드를 하나의 레코드에 연결하는 경우에는 같은 셀에서 레코드의 고유 식별자 값을 세미콜론으로 구분하세요(예: luke@lukesdiner.com; rory@yale.edu; sookie@dragonfly.com).
아래 예제 파일에서 Rory와 Jackson은 이메일 값을 고유 식별자로 사용하여 기존 연락처에 고유 레이블로 연결되는 새 연락처입니다. Sookie는 동일한 레이블을 사용하여 두 개의 기존 연락처에 연결되는 기존 연락처입니다. 첫 번째 행에서 연결 레이블은 레이블 쌍의 일부이므로 가져오기가 완료되면 연결된 레코드에는 Parent 레이블이, Rory에는 쌍으로 연결된 레이블인 Child 레이블이 지정됩니다.
부모/자식 연결
가져오기를 통해 자식-부모 회사 연결을 만들려면 자식 회사 가져오기에 대해 자세히 알아보세요.
사용자 지정 연결 레이블(Professional 및 Enterprise만 해당)
연결 레이블을 가져오려면 연결 레이블 열을 포함하세요. 가져오기 전에 HubSpot에서 연결 레이블을 만들어야 합니다.
- 회사 연결을 기본으로 설정하려면 해당 행의 연결 레이블 열에 기본값을 포함하세요.
- 두 레코드 간의 관계를 설명하는 여러 레이블을 설정하려면 하나의 셀에 여러 개의 연결 레이블 값을 세미콜론으로 구분하여 포함할 수 있습니다(예: 관리자; 청구 연락처).
- 여러 파일 가져오기에서 연결 레이블을 가져오는 경우에는 연결 레이블 열과 연결하려는 개체에 대한 고유 식별자를 같은 파일에 포함해야 합니다.
- 페어링된 레이블을 가져오는 경우:
- 교차 객체 연결의 경우, 연결 레이블 열에 레이블 중 하나만 포함하세요. 레이블은 가져오기 프로세스 중에 올바른 개체에 할당됩니다.
- 동일한 객체 연결의 경우,연결된 [고유 식별자] 열의 레코드는 가져오기 프로세스에서 추가되거나 파일의 레이블 열에 포함된 레이블을 받게 됩니다. 행의 다른 레코드는 쌍의 다른 레이블을 받게 됩니다.
파일 예시
가져오기 프로세스를 시작할 때 선택한 개체 및 활동에 필요한 속성이 포함된 예제 파일을 생성할 수 있습니다. 추가 속성이 포함된 더 많은 예제를 검토하려면 샘플 파일이 포함된 이 문서를 참조하세요.