콘텐츠로 건너뛰기

가져오기 파일 설정

마지막 업데이트 날짜: 2월 12, 2025

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

모든 제품 및 플랜

HubSpot으로 데이터를 가져오기 전에 다음 제한 사항 및 요구 사항을 검토하세요. 샘플 파일에 액세스하거나 예제 파일을 생성하여 시작할 수도 있습니다.

가져오기 도구에 대해 자세히 알아보려면 이 문서를 참조하세요. 파일이 준비되면 가져오기 방법을 알아보세요.

기술 요구 사항 및 제한 사항

HubSpot으로 가져오는 모든 파일은 반드시 최신 파일이어야 합니다:
  • .csv, .xlsx 또는 .xls 파일이어야 합니다.
  • 한 장만 있어야 합니다.
  • 각 열 헤더가 HubSpot의 속성에 해당하는 헤더 행을 포함해야 합니다. 열 머리글은 가져오기에 영향을 주지 않고 어떤 순서로든 구성할 수 있습니다. 헤더와 일치하는 기본 속성이 이미 있는지 확인하거나 가져오기 전에 사용자 지정 속성을 만들 수 있습니다. 속성 요구 사항에 대해 자세히 알아보세요.

  • 1000개 미만의 열을 포함해야 합니다.
  • 외국어 문자가 포함된 경우 UTF-8로 인코딩해야 합니다.
  • 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). 이렇게 하면 기존 속성 값을 덮어쓰는 대신 값이 추가됩니다.

숫자

생성된 숫자 속성 유형에 따라 값의 형식을 지정합니다:

  • 통화: 통화 금액 또는 가격이 포함된 속성의 경우 HubSpot에서 허용되는 통화 중 하나를 사용해야 합니다. 허용되는 통화 목록과 해당 통화 코드는 계정 기본 설정의통화 탭에서 확인할 수 있습니다. USD의 경우 통화 데이터는 소수점(예: 123.45)을 사용하여 형식을 지정해야 합니다.
  • 퍼센트: % 퍼센트 기호 또는 소수로 값의 형식을 지정합니다. 예를 들어 25%를 가져오려면 셀에 25% 또는 .25가 포함되어야 합니다.
  • 전화번호: 연락처 속성인 전화번호휴대폰 번호는 국가 코드를 기준으로 전화번호를 가져와 자동으로 서식을 지정하려면 +[국가 코드][번호]로 서식을 지정합니다. 내선 번호가 있는 경우에는 내선[번호]를 추가합니다. 예를 들어 미국 국가 번호가 있는 전화번호는 +11234567890 ext123과 같은 형식입니다.
유효성 검사 규칙을 설정한 경우에는 가져온 값이 규칙을 따라야 하며, 그렇지 않으면 가져오지 않습니다.

단일 확인란

단일 확인란 필드를 위한 열을 만들고 각 줄의 값을 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 레이블이 지정됩니다.

부모/자식 연결

가져오기를 통해 자식-부모 회사 연결을 만들려면 자식 회사 가져오기에 대해 자세히 알아보세요.

사용자 지정 연결 레이블(ProfessionalEnterprise만 해당)

연결 레이블을 가져오려면 연결 레이블 열을 포함하세요. 가져오기 전에 HubSpot에서 연결 레이블을 만들어야 합니다.

  • 회사 연결을 기본으로 설정하려면 해당 행의 연결 레이블 열에 기본값을 포함하세요.
  • 두 레코드 간의 관계를 설명하는 여러 레이블을 설정하려면 하나의 셀에 여러 개의 연결 레이블 값을 세미콜론으로 구분하여 포함할 수 있습니다(예: 관리자; 청구 연락처).
  • 여러 파일 가져오기에서 연결 레이블을 가져오는 경우에는 연결 레이블 열과 연결하려는 개체에 대한 고유 식별자를 같은 파일에 포함해야 합니다.
  • 페어링된 레이블을 가져오는 경우:
    • 교차 객체 연결의 경우, 연결 레이블 열에 레이블 중 하나만 포함하세요. 레이블은 가져오기 프로세스 중에 올바른 개체에 할당됩니다.
    • 동일한 객체 연결의 경우,연결된 [고유 식별자] 열의 레코드는 가져오기 프로세스에서 추가되거나 파일의 레이블 열에 포함된 레이블을 받게 됩니다. 행의 다른 레코드는 쌍의 다른 레이블을 받게 됩니다.

파일 예시

가져오기 프로세스를 시작할 때 선택한 개체 및 활동에 필요한 속성이 포함된 예제 파일을 생성할 수 있습니다. 추가 속성이 포함된 더 많은 예제를 검토하려면 샘플 파일이 포함된 이 문서를 참조하세요.

이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.