- 기술 자료
- CRM
- 가져오기 및 내보내기
- 가져오기 도구 이해
가져오기 도구 이해
마지막 업데이트 날짜: 2025년 12월 11일
HubSpot에 연락처, 회사, 거래, 서비스, 활동 등의 개체를 추가하려면 가져오기를 사용하세요. 스프레드시트를 업로드하고 해당 열을 HubSpot 속성에 매핑하면 새 레코드를 생성하고 기존 레코드를 업데이트하며 이들 간의 관계를 정의할 수 있습니다. 파일을 업로드하기 전에 데이터 형식이 올바른지 확인하려면 아래의 가져오기 프로세스와 용어를 검토하세요.
HubSpot을 처음 사용하며 기존 CRM 데이터를 HubSpot CRM으로 이전하려는 경우 HubSpot의 리플랫폼 팀에 데이터 마이그레이션을 요청할 수 있습니다.
용어집
-
CRM 개체: 연락처, 회사, 거래, 티켓 등 고객 및 비즈니스 프로세스 정보입니다. 가져올 때 개체는 HubSpot으로 가져오는 데이터 세트의 유형을 의미합니다.
-
레코드: 개체의 개별 인스턴스(예: "Neal Caffrey"는 연락처 레코드). 단일 개체 가져오기 파일에서 파일의 각 행은 하나의 개체 레코드를 나타냅니다. 하나의 파일로 여러 개체를 가져오는 경우 각 행은 서로 연관된 레코드를 나타냅니다.
- 활동: 레코드와 연결될 수 있는 상호작용으로, 연락처에 보낸 이메일이나 티켓 레코드에 기록된 메모 등이 해당됩니다. 가져오기 도구에서 지원하는 활동에는 통화, 이메일, 회의, 메모, 작업이 포함됩니다.
- 속성: 레코드 및 활동에 대한 정보를 저장하기 위해 생성된 필드입니다. 가져오기 시 속성은 파일의 열 헤더와 매칭됩니다.
다음 예시에서 가져오는 개체는 연락처입니다. 각 행은 연락처 레코드를 나타내며, 각 정보 열은 연락처 속성(이름, 성, 이메일 주소)을 나타냅니다.
지원되는 개체 및 활동
다음은 완료할 수 있는 가져오기 유형과 각 유형에서 지원되는 개체 및 활동입니다.
단일 개체 또는 활동 가져오기
한 번에 하나의 개체 또는 활동을 생성 및/또는 업데이트하기 위해 가져올 수 있습니다. 단일 개체 가져오기에서는:
- 연락처, 회사, 거래, 티켓, 약속, 과정, 리스팅, 서비스, 통화, 제품, 프로젝트, 주문, 장바구니, 구독 및 사용자 정의 개체 레코드를 생성 및/또는 업데이트할 수 있습니다.
- 작업은 생성만 가능하며 업데이트는 불가능합니다.
다중 객체 및 활동 가져오기
여러 객체와 활동을 한 번에 생성, 업데이트 및/또는 연결하기 위해 가져올 수 있습니다. 하나의 파일로 여러 객체와 활동을 가져오거나, 두 개의 별도 파일로 두 객체/하나의 객체와 하나의 활동을 가져올 수 있습니다. 두 개의 별도 파일을 사용할 경우, 파일에는 공통 열이 포함되어야 합니다.
다중 객체 가져오기 시:
- 연락처, 회사, 거래, 티켓, 약속, 코스, 리스팅, 서비스, 통화, 주문, 프로젝트, 장바구니 및 사용자 정의 개체 레코드를 생성 및/또는 업데이트할 수 있습니다.
- 라인 항목을 생성 및/또는 업데이트할 수 있지만, 반드시 거래와 연관되어야 합니다.
- 이메일, 회의, 메모, 작업은 생성할 수 있지만 업데이트할 수 없습니다. 이메일, 회의, 메모는 반드시 개체와 연결되어야 합니다.
예시: 두 개 객체 가져오기 위해 두 파일 사용
다른 데이터베이스에서 가져올 두 개의 파일이 있습니다. 하나는 연락처, 다른 하나는 거래를 포함합니다. 두 파일 모두'거래 이름' 열을 공유하며, 이는 연락처 파일의 관련 연락처와 일치합니다. 가져오기 과정에서거래명을 공통 열이자 연락처 파일의 고유 키로 사용하세요. 이렇게 하면 해당 열이 거래명 속성을 채우면서 HubSpot 내 거래를 연락처와 연결할 수 있습니다.
기타 가져오기 유형
가져오기 페이지에서 다른 도구의 가져오기 프로세스에도 접근할 수 있지만, 객체 또는 활동 가져오기와는 다른 단계를 따릅니다.
가져오기 파일 설정
가져오기 도구에 파일을 업로드하기 전에 데이터가 계정에 올바르게 추가되도록 파일을 적절히 설정하는 것이 중요합니다. 다음 섹션에는 파일을 올바르게 설정하기 위한 중요한 개념과 요구 사항이 포함되어 있습니다.
사전 구축된 샘플 파일은 이 문서를 참조하십시오.
요구
사항기술적 제한 사항 및 일반 요구 사항은 가져오기 파일 설정 문서를 참조하십시오.
고유 식별자
고유 식별자는 HubSpot이 각 레코드를 고유한 것으로 인식하는 데 사용하는 속성 값입니다. 가져오기 시 레코드 업데이트, 중복 레코드 생성 방지 (예: "Tom Smith"에 대한 두 개의 레코드), 레코드 간 연관 설정 (예: "Tom Smith" 가져오기 후 그의 회사 "Smith Inc."와 연관)을 위해 고유 식별자가 필요합니다. 연락처 및 회사의 경우, 가져오기 시 각각의 고유 식별자(이메일,회사 도메인 이름)를 사용하는 것이 좋습니다.
가져오기 시 사용할 수 있는 고유 식별자는 다음과 같습니다:
- 이메일: 연락처의 이메일 주소입니다. 중복을 방지하거나 연락처를 다른 개체와 연결하기 위해 연락처 가져올 때 필수입니다. 연락처 이메일 주소가 없는 경우 레코드 ID 를 사용하여 기존 연락처 레코드를 업데이트하고 연결하십시오.
- 회사 도메인 이름: 회사의 웹사이트 도메인(예: example.com). 회사 중복을 방지하거나 다른 개체와 연결하기 위해 회사 가져오기 시 필수입니다. 회사 도메인 이름이 없는 경우 레코드 ID 를 사용하여 기존 회사 레코드를 업데이트하고 연결하십시오.
- 레코드 ID: HubSpot이 각 레코드에 부여하는 고유 속성 값입니다. HubSpot에서 기존 레코드를 내보낼 경우 각 레코드에 레코드 ID가 할당됩니다. 이는 거래, 티켓, 약속, 코스, 리스팅, 서비스, 활동 및 사용자 정의 개체의 기본 고유 식별자이지만, 이메일이나 회사 도메인 이름이 없는 경우 연락처 및 회사의 고유 식별자로도 사용할 수 있습니다. 가져오기에 레코드 ID가 포함된 경우 다른 모든 고유 식별자를 대체합니다.
- 고유 값이 필요한 사용자 정의 속성: 고유 값이 필요한 속성을 생성한 경우, 해당 속성을 가져오기 파일의 고유 식별자로 사용할 수 있습니다. 이는 연락처, 회사, 거래, 티켓, 약속, 코스, 리스팅, 서비스 및 사용자 정의 개체에서 지원됩니다.
연락처 및 회사의 경우, 데이터 품질 유지를 위해 가져올 때 각각의 고유 식별자(이메일,회사 도메인 이름)를 사용하는 것이 좋습니다.
예시: 기존 거래 업데이트 시레코드 ID 사용
파이프라인 내 모든 기존 거래의 여러 속성을 업데이트하려는 경우, 해당 거래를 내보내면서 수정할 속성과 레코드 ID만 포함하세요. 스프레드시트에서 원하는 업데이트를 수행하되레코드 ID 열은 그대로 둡니다. 거래 가져오기를 실행하고 프로세스 중 열 매핑 부분에서레코드 ID를 고유 식별자로 사용하세요.
연관 관계
구독 필요 연관 레이블을 추가하려면 Professional 또는 Enterprise 구독이 필요합니다.
레코드 간 관계를 지정하기 위해 레코드를 서로 연관시키고 연관 레이블을 추가하기 위해 가져오기를 수행할 수도 있습니다. 여기에는 거래와 연락처 간의 교차 개체 연관 관계나 연락처와 연락처 간의 동일 개체 연관 관계가 포함됩니다
.
가져오기 파일에 연관 관계를 올바르게 포함하는 방법에 대해 자세히 알아보세요.
예시: 동일 개체 연락처 연관 관계 가져오기
귀사는 연락처 개체를 사용하여 관리자(Manager)와 개별 기여자(IC) 간의 관계를 추적합니다. 관리자는 이미 HubSpot에 존재합니다. 단일 가져오기 파일에 두 연락처의 기본 이메일을 별도 열(예: 관리자이메일, IC 이메일)로 포함하도록 구성합니다. 관리자 이메일 속성 값은 HubSpot에 이미 존재하는 값과 일치해야 합니다. 연락처 가져오기를 시작한 후 동일 객체 연관 생성 옵션을 선택하고 나머지 세부 정보를 구성한 후 가져오기를 완료합니다. 사용자 정의 연관 레이블을 사용하여 관계에 레이블을 지정할 수도 있습니다.

열을 속성에 매핑하기
파일을 가져오기 도구로 업로드한 후, 가져오기 과정에서 파일의 열 헤더를 HubSpot 속성과 매칭하라는 안내가 표시됩니다. 올바르게 매핑하면 데이터가 HubSpot에 추가될 때 올바른 위치(즉, 올바른 개체와 올바른 속성)로 이동합니다.
예를 들어, 연락처 파일의 경우 '이름'열을 연락처 속성 '이름'에 매핑합니다.

여러 개체를 연결하는 파일의 경우 각 열에 해당하는 개체와 속성을 선택합니다.

가져오기 오류
매핑 과정에서 가져오기에 오류가 포함된 경우, 데이터가 계정에 추가되기 전에 특정 오류를 관리하여 수정할 수 있습니다. 가져오기 후 오류가 발생한 경우, 오류를 검토하고 문제 해결하여 영향을 받은 데이터를 추가하거나 업데이트할 수 있습니다.
HubSpot에서 데이터를 업데이트하는 추가 방법
가져오기 대신 고려할 수 있는 레코드를 대량 생성, 동기화 또는 연결하는 추가 방법이 있습니다:- 연락처 및 회사에 대해 연락처의 이메일 도메인을 기반으로 회사를 자동 생성하고 연결하는 설정을 활성화할 수 있습니다. 연락처의 이메일 도메인이 소속 회사 도메인과 다른 경우 또는 다른 개체를 가져오는 경우에는 가져오기를 통해 레코드를 연결하는 지침을 따르십시오.
- 다른 시스템에 데이터가 있고 양방향 동기화를 설정하려는 경우, HubSpot 데이터 동기화를 연결하고 사용하는 방법을 알아보세요.
