레코드 가져오기 오류 검토 및 문제 해결

HubSpot으로 레코드나 활동을 가져올 때 오류가 발생할 수 있습니다. 아래에서 가져오기 중 감지된 오류 해결 방법, 오류 파일 다운로드, 오류 세부 정보 확인, 가져오기 파일 또는 Salesforce의 문제 수정 방법을 알아보세요.

가져오기를 시작하거나 오류가 있는 파일을 수정하기 전에 HubSpot으로 가져오기에 필요한 관련 용어와 요구 사항을 숙지하세요.

참고: 계정마다 개체에 대해 맞춤화된 이름 (예: company 대신 account)을 사용할 수 있습니다. 본 문서에서는 HubSpot 기본 이름으로 개체를 지칭합니다.

가져오기 중 오류 수정

가져오기 과정에서 파일 열을 HubSpot 속성에 매핑합니다. 매핑 중 잘못된 값이나 누락된 값을 발견하면 파일을 편집하여 다시 업로드할 필요 없이 가져오기 도구 내에서 값을 업데이트할 수 있습니다. 예를 들어, 맞춤법 오류를 찾아 수정하거나 빈 셀에 값을 추가할 수 있습니다.

'파일 열을 HubSpot 속성에 매핑' 화면에서 오류를 해결하려면:

1. 발견된 오류에 대한 자세한 정보를 보려면 오류가 있는 행 위에 마우스를 올린 후 [x]개의 오류를 클릭하세요. 오른쪽 패널에서 영향을 받은 열 및 행을 포함한 오류 유형에 대한 자세한 내용을 확인할 수 있습니다.
   
   • 매핑 대상 속성을 보려면 오른쪽 상단의 속성 이름을 클릭하세요.
   • 특정 오류에 대한 자세한 내용을 보려면 오류 이름을 클릭하세요.
   • 파일에서 영향을 받은 행을 보려면 '오류 값 보기'를 클릭하세요.
   • 권장 해결책이 있는 경우 '오류 수정' 섹션이 표시됩니다. 권장 해결책을 확인한 후 오류 유형에 따라 '오류 값 편집'을 클릭하여 값을 수정하고 오류를 해결하세요.
2. 오류가 있는 행의 값을 편집하려면, 편집하려는 값이 있는 행 위에 마우스를 올린 후 '열 값 편집'을 클릭하세요. 오른쪽 패널에서:
   
   • 바꿀 열 값을 선택하세요. 패널을 처음 열 때 오류가 감지되면 오류를 일으킨 값이 자동으로 미리 로드되어 수정할 수 있습니다. 오류가 없거나 해당 열의 값을 이미 편집한 경우, 원하는 값을 선택하여 바꿀 수 있습니다.
   • 값을 대체하려면 대체값 입력란에 새 값을 입력하거나 선택하세요. 이 값은 해당 열에 나타나는 모든 행의 열값을 대체합니다(예: 열의 여러 행에 나타나는 철자 오류는 모든 경우에 수정됨).

   

   참고: 파일의 첫 1,000개 행에 나타나는 열 값만 선택할 수 있습니다. 그러나 대체값을 설정하면 1,000행 이후의 값을 포함해 해당되는 모든 값이 대체됩니다.

   • 선택한 열 값을 대체하지 않고 가져오지 않으려면 수직 메뉴 아이콘을 클릭한 후 '이 값 가져오기 차단'을 클릭하세요. 해당 열에 나타나는 모든 행에서 이 값이 가져오지 않습니다.
   • 다른 대체 값을 추가하려면 '다른 값 대체'를 클릭 한 후 열 값을 선택하고 대체 값을 설정하세요.
   • 대체 값을 제거하려면 수직 메뉴 아이콘을 클릭한 후 '대체 제거'를 클릭하세요. 오류가 발생한 값은 삭제할 수 없습니다.
     
   • 모든 대체값을 재설정하려면 '모든 변경 사항 재설정'을 클릭하세요. 선택한 각 열 값에 대한 대체값이 제거됩니다.
   • 패널을 닫으려면 '완료'를 클릭하세요.
3. 오류가 해결되면 매핑됨 열에 성공 표시가 나타납니다. 열 값이 수정된 경우 해당 행에 수정됨이 표시됩니다.

참고: 파일에 1,000개 이상의 행이 포함된 경우 해결되지 않은 추가 오류가 있을 수 있습니다

.

가져오기 검토

가져오기를 완료하면 오류 개요를 포함한 가져오기 요약 화면으로 자동 이동됩니다. 이전에 완료된 가져오기의 요약도 검토할 수 있습니다 .

1. 요약 카드에서 가져온 행 수, 새로 생성된 레코드 수, 업데이트된 기존 레코드 수를 확인할 수 있습니다. 가져오기 분석에 대해 자세히 알아보세요 .
   • 경우에 따라 새로 생성되거나 업데이트된 레코드 수가 가져온 행 수와 일치하지 않을 수 있습니다.
   • 예를 들어, 단일 레코드에 연결된 여러 이메일 주소가 포함된 경우, 보조 이메일 주소는 새 레코드를 생성하지 않고 기존 레코드를 업데이트합니다. 이 경우 새로 생성되거나 업데이트된 레코드 수는 가져온 행 수보다 적습니다. 

1. 가져오기 과정에서 열거형 속성 값이나 연관 레이블의 오류를 수정한 경우, 해당 값에 대한 수정 내용을 보여주는 섹션이 표시됩니다.

3. 가져오기 과정에서 오류가 발생한 경우 '가져오기 오류' 섹션이 표시됩니다. 표에서 다음 정보를 확인하세요:
   • 파일에서 가져온 열: 오류의 영향을 받은 파일의 열 머리글입니다. 
   • 개체 유형: 영향을 받은 열에 할당된 CRM 개체 또는 활동.
   • HubSpot 속성: 영향을 받은 열과 매칭된 HubSpot 속성입니다.
   • 오류 유형: 영향을 받은 열의 오류 유형입니다. 모든 가져오기 오류에 대해 자세히 알아보세요.
   • 오류 영향: 오류로 인해 가져오지 못한 행 또는 속성 값의 수. 행이 가져오지 못한 경우, 해당 행의 모든 열이 가져오지 못한 것을 의미합니다. 값이 가져오지 못한 경우, 해당 특정 속성 열의 값만 가져오지 못한 것이며 행의 다른 열은 가져올 수 있었음을 의미합니다.

4. 특정 오류에 대한 자세한 정보를 보려면 행 위에 마우스를 올린 후 '상세 정보 보기'를 클릭하세요.
5. 오류가 포함된 모든 행을 보려면 '오류가 있는 행 보기'를 클릭하세요. '오류가 있는 행' 페이지에서:
   • 테이블에서 해당 행과 포함된 오류를 검토하세요. 오류가 발생한 열에는 느낌표 경고 아이콘이 표시됩니다. 가장 왼쪽 열의 오류 이름을 클릭하면 오류 원인과 해결 방법을 확인할 수 있습니다.
   • 오류가 있는 행을 파일로 다운로드를 클릭하면 영향을 받은 행과 해당 오류가 포함된 파일을 다운로드할 수 있습니다. 다운로드한 zip 파일을 클릭하여 CSV 파일을 추출한 후 파일을 엽니다.
6. 오류 목록을 파일로 다운로드하려면 테이블 상단의 [ 오류를 파일로 다운로드]를 클릭하세요. 
   • 다운로드한 zip 파일을 클릭하여 CSV 파일을 추출한 후 파일을 엽니다.
   • 파일에서 오류 코드 열의 오류 코드, 개체 유형 열의 영향을 받은 레코드의 개체, 이유 열의 오류 원인, 추가 열의 레코드 속성 값을 확인하십시오.

참고:가져오기 오류에 포함된민감한 데이터는 가져오기 후 화면과 다운로드한 오류 파일에서 'REDACTED'로대체됩니다. 실제 값을 확인하려면 원본 가져오기 파일을 참조하세요

.

가져오기 오류를 확인한 후에는 특정 오류 해결 방법을 알아보세요 .

가져오기 파일 오류

다음은 오류 코드별 알파벳순 목록으로, 각 오류에 대한 세부 정보와 가능한 해결 단계를 포함합니다. 경우에 따라 오류가 있는 레코드나 활동이 임포트될 수 있으며, HubSpot 내에서 수정하거나 임포트 파일을 수정 후 재임포트하여 수정할 수 있습니다. 다른 경우에는 레코드나 활동이 임포트되지 않으며, 재임포트 전에 임포트 파일을 수정해야 합니다.

참고: 다운로드한 파일의오류 코드에는 대문자와 밑줄 문자가 포함되지만, 본 문서 내에서는 일반 텍스트로 표기됩니다. 예를 들어, 파일에서는 AMBIGUOUS_ENUMERATION_OPTION으로 표시되지만 아래 목록에서는 '모호한 열거형 옵션'으로 확인됩니다.

모호한 열거형 옵션

오류 의미

동일한 레코드가 열거형 속성에 정의된 기존 옵션 중 두 개 이상과 일치합니다 . 이 오류는 다중 선택, 드롭다운 선택, 라디오 선택, 체크박스 유형 속성에 적용됩니다.

또한 파일의 값이 속성 옵션의 내부 값이 아닌 레이블인 경우에도 이 오류가 발생할 수 있습니다. 이는 레이블과 내부 값이 다른 열거형 속성 옵션에 적용됩니다

.

영향을 받은 레코드는 가져오기되었지만 열거형 속성에 값이 포함되어 있지 않습니다.

오류 해결 방법

가져오기 파일을 HubSpot의 속성과 비교하여 잘못된 값을 확인하세요. 가져오기 파일의 값을 기존 옵션 중 하나와 일치하도록 수정하거나, 레이블과 내부 값이 다른 경우 옵션의 내부 값으로 업데이트하세요. 값을 수정한 후 파일을 다시 가져오세요.

영향을 받은 레코드의 속성 값을 수동으로 업데이트할 수도 있습니다. 레코드가 여러 옵션과 일치해야 하는 경우, 여러 체크박스 속성에 데이터를 올바르게 가져오기 위해 파일을 포맷하는 방법을 알아보세요 .

연관 레이블을 찾을 수 없음

오류 의미

가져오기 과정에서 열에 연관 레이블이 포함되었으나 해당 레이블이 HubSpot에 존재하지 않습니다. 데이터는 가져오기되었으나 결과 연관 관계에는 레이블이 지정되지 않았습니다.

오류 해결 방법

가져오기 파일을 HubSpot의 연관 레이블과 비교하여 잘못된 값을 확인하세요. 값이 기존 레이블과 일치하도록 수정하거나 새 레이블을 생성하세요. 쌍을 이루는 레이블을 가져오는 경우, 해당 개체에 올바른 레이블이 사용되었는지 확인하십시오(예: 회사에 적용된 고용주, 연락처에 적용된 직원). 완료 후 파일을 다시 가져오거나 영향을 받은 레코드의 레이블을 수동으로 업데이트하십시오 .

연관성 제한 초과

오류 의미

레코드 간 허용되는 총 연관성 또는 레이블 지정 연관성 수에 대한 연관성 제한을 이전에 설정했지만, 가져오기에 제한을 초과하는 연관성이 포함되었습니다. 데이터는 가져왔지만, 결과 레코드는 HubSpot에서 연결되지 않습니다.

오류 해결 방법

레코드를 연결해야 하거나 연결을 정의하는 특정 레이블이 필요한 경우, 연결 제한을 업데이트한 후 파일을 다시 가져오거나 HubSpot에서 수동으로 연결을 업데이트하세요.

연관 레코드 미검출

오류 설명

가져오기 과정에서 레코드 연관을 위한 고유 식별자 속성(예: 레코드 ID, 이메일, 회사 도메인 이름 또는 사용자 정의 고유 값 속성)에 매핑된 열이 있었습니다. 그러나 필수 고유 값 이 파일에 포함되지 않았습니다. 줄바꿈이 포함되거나 100자 이상의 값을 가진 고유 식별자를 사용하는 경우에도 발생할 수 있습니다. 데이터는 가져왔지만, 결과 레코드가 HubSpot에서 연결되지 않았습니다.

오류 해결 방법

가져오기 파일에 올바른 값을 포함하도록 업데이트한 후 파일을 다시 가져오세요. 기존 레코드의 올바른 레코드 ID를 확인하려면 기존 레코드를 내보내야 할 수도 있으며, 기존 레코드에 대해 다른 고유 식별자를 사용할 수도 있습니다. 여러 개체를 가져오고 연결하기 위해 파일을 올바르게 설정하는 방법을 알아보세요 .

소유자를 찾을 수 없음

오류 의미

가져오기 파일에 포함된 레코드 소유자가 HubSpot의 사용자와 일치하지 않습니다. 해당 레코드는 가져오기되었으나 소유자 필드에 값이 포함되어 있지 않습니다.

오류 해결 방법

레코드를 할당하려는 대상이 계정의 활성 사용자인지 확인한 후, 가져오기 파일의 소유자 열에 사용자의 이름, 성 또는 이메일을 포함하도록 데이터를 업데이트하세요.

• 레코드를 할당하려는 대상이 아직 계정의 사용자가 아닌 경우, 사용자로 추가한 후 계정에 표시된 이름 또는 이메일로 재가져오기하십시오.
• 할당하려는 대상이 비활성화된 사용자인 경우, 사용자를 재활성화한 후 계정에 표시된 이름 또는 이메일로 재가져오기하십시오.

날짜 구문 분석 실패

오류 의미

가져오기 파일의 날짜 값이 가져오기 과정에서 선택한 형식과 일치하지 않습니다. 해당 레코드는 가져오기되었으나 날짜 속성에는 값이 포함되지 않았습니다.

오류 해결 방법

가져오기 파일을 올바른 값으로 업데이트한 후 다시 가져오거나, 영향을 받은 레코드의 속성 값을 수동으로 업데이트하십시오.

숫자 구문 분석 실패

오류 의미

가져오기 파일에 숫자 속성에 대한 값이 포함되어 있으나 숫자가 아닌 문자가 포함되어 있습니다. 영향을 받은 레코드는 가져오기되었으나 숫자 속성에는 값이 포함되어 있지 않습니다.

오류 해결 방법

가져오기 파일을 올바른 숫자 값으로 업데이트한 후 다시 가져오거나, 영향을 받은 레코드의 속성 값을 수동으로 업데이트하십시오 .

행 구문 분석 실패

오류 의미

가져오기 파일에 처리할 수 없는 데이터가 포함된 행이 있습니다. 필수 속성인 경우 해당 레코드는 가져오지 않았습니다. 필수 속성이 아닌 경우 레코드는 가져왔지만 해당 속성에는 값이 포함되어 있지 않습니다.

오류 해결 방법

가져오는 속성에 맞는 올바른 형식으로 데이터 값이 입력되었는지 확인하고 오류를 수정한 후 파일을 다시 가져오십시오. 영향을 받은 레코드의 속성 값을 수동으로 업데이트할 수도 있습니다.

기간

해석 실패

오류 의미

가져오기 파일에 허용되는 기간 형식과 일치하지 않는 기간 값이 포함되어 있습니다. 영향을 받은 레코드는 가져오기되었지만 기간 속성에는 값이 포함되어 있지 않습니다. 

오류 해결 방법

파일 내 기간 값을 정수 월 단위 또는 ISO8601 기간 형식 (예: 3년 6개월 4일의 기간은 P3Y6M4D)으로 업데이트한 후 파일을 다시 가져오세요. 영향을 받은 레코드의 속성 값을 수동으로 업데이트할 수도 있습니다.

새 레코드

생성만

오류 의미

가져오기 시 새 레코드만 생성하도록 선택했으나, 가져오기 파일에 HubSpot 내 기존 레코드와 일치하는 고유 식별자 값이 포함되었습니다. 예를 들어 기존 연락처 이메일( 추가 이메일 포함)과 일치하는 이메일 값을 가져오거나, 기존 회사 도메인( 추가 도메인 포함)과 일치하는 회사 도메인 이름 값을 가져온 경우입니다. 영향을 받은 행은 가져오지 않았으므로 기존 레코드는 업데이트되지 않았지만, 새 정보가 포함된 행은 새 레코드를 생성했습니다.

오류 해결 방법

새 레코드만 생성하고 기존 레코드 업데이트를 피하려는 목적이었다면 별도의 조치가 필요하지 않습니다. 파일 내 기존 레코드를 업데이트하려 했다면 파일을 다시 가져온 후 가져오기 프로세스에서 새 레코드 생성 및 기존 레코드 업데이트를 선택하세요.

중복 대체 ID

오류 의미

파일 내에서 동일한 대체 ID가 여러 번 사용되었습니다. 데이터는 가져왔지만 HubSpot에 동일한 레코드가 중복될 수 있습니다. 레코드 연동을 시도한 경우, 레코드가 연동되지 않았습니다.

오류 해결 방법

• 중복을 방지하려면 연락처에는 이메일, 회사에는 회사 도메인 이름, 모든 개체에는 레코드 ID를 사용하세요. 
• 레코드 연결을 위해 이메일, 회사 도메인 이름, 레코드 ID를 사용하거나 , 하나의 값이 연결된 다수의 레코드에 대해 고유한 일대다 속성을 선택하세요(예: 회사 이름은 하나의 값으로, 동일 회사에 근무하는 다수의 연락처와 연결됨). 자세한 안내는 샘플 가져오기 파일을 참조하세요 .

것을

중복 연결 ID

오류 의미

레코드 연결에 선택한 연결 ID가 고유하지 않습니다.

오류 해결 방법

두 파일 간 공통 열로 사용할 다른 열 헤더를 선택하세요. 최상의 결과를 위해, 하나의 값이 다수의 관련 레코드에 대해 고유한 일대다 속성을 선택하세요(예: 회사 이름은 동일한 회사에 근무하는 다수의 연락처와 연결됩니다). 자세한 안내는 샘플 가져오기 파일을 참조하세요. 새 연관 ID를 선택한 후 파일을 다시 가져오세요.

중복 레코드 ID

오류 의미

파일 내에서 동일한 레코드 ID가 여러 번 사용되었습니다. 해당 레코드는 HubSpot에서 업데이트되거나 연결되지 않았습니다.

오류 해결 방법

해당 레코드 ID가 포함된 행이 하나만 있도록 가져오기 파일을 업데이트하세요. HubSpot에 포함할 최신 정보가 있는 행을 유지하세요. 중복을 제거한 후 파일을 다시 가져오세요.

중복 행 내용

오류 의미

HubSpot이 가져오기 파일에 중복 레코드가 포함된 것을 감지했습니다. 가져오기 과정에서 새 레코드가 생성되지 않았습니다.

오류 해결 방법

가져오기 파일에서 중복 항목을 제거한 후 다시 가져오기하십시오.

중복 고유 속성 값

오류 의미

HubSpot의 고유 식별자 속성은 모든 레코드에서 해당 속성 값의 고유성을 강제 적용합니다. 고유 식별자 속성에 매핑된 열의 일부 값이 파일 내 다른 행 또는 CRM의 다른 레코드와 비교 시 고유하지 않았습니다. 파일에서 이 속성이 고유하지 않은 경우, 해당 속성으로 참조된 행 중 하나만 가져왔습니다. 이 속성 값이 CRM의 다른 레코드와 충돌하는 경우 해당 레코드는 가져오지 않았습니다.

오류 해결 방법

고유 값으로 사용할 다른 열 헤더를 선택하거나 중복 값을 제거한 후 파일을 다시 가져옵니다.

파일에 여러 고유 식별자 속성이 포함된 경우:

• 충돌하는 고유 값이 존재할 수 있습니다(예: 이메일과 사용자 정의 고유 속성 간 충돌. 사용자 정의 속성은 고유 값을 가졌으나 이메일은 중복됨). 충돌하는 고유 값을 제거한 후 재가져오기하십시오.
• 가져오기 중 고유값 속성 중 하나를 업데이트하려는 경우, 업데이트하지 않을 속성을 기존 [객체]를 찾기 위해 사용할 속성로 선택하십시오.

참고: 레코드 ID를 고유 식별자로 사용하는 경우, 가져오기에 포함된 다른 모든 고유 식별자를 우선합니다. 연락처 속성 이메일도 항상 고유 값이 필요합니다.

연관 생성 실패

오류 의미

HubSpot이 현재 형식의 레코드를 연관시킬 수 없습니다. 레코드는 가져오기되었으나 연관되지 않았습니다.

오류 해결 방법

레코드 연관용 파일 요구 사항을 충족했는지 확인하세요. 하나의 파일로 가져오는 경우 각 개체에 고유 식별자를 추가해야 할 수 있습니다. 두 개의 파일로 가져오는 경우 올바르게 연관시키기 위해 다른 공통 열을 선택해야 할 수 있습니다. 파일을 수정하여 다시 가져오거나 레코드를 수동으로 연결하세요.

연락처 수신 거부 실패

오류 의미

오류 해결 방법

빈 속성 값을 가진 개체 처리 실패

오류 의미

여러 열에 빈 값이 포함된 파일로 인해 HubSpot이 레코드를 처리하지 못했습니다. 해당 행의 데이터는 가져오지않았습니다.

오류 해결 방법

가져오기 파일의 누락된 속성 값을 입력한 후 파일을 다시 가져오십시오.

이메일, 거래/티켓 단계 또는 거래/티켓 파이프라인 유효성 검사 실패

오류 의미

오류 해결 방법

파일을 찾을 수 없음

오류 의미

선택한 파일을 찾을 수 없습니다. 데이터가 가져오지 못했습니다.

오류 해결 방법

파일이 컴퓨터에 저장되었는지, 올바른 파일 형식인지 확인하세요. 확인 후 파일을 다시 업로드하세요.

GDPR 차단 이메일

오류 의미

가져오기 파일에 데이터 개인정보 보호로 인해 통신이 차단된 하나 이상의 이메일이 포함되어 있습니다. 해당 연락처는 가져오지 못했습니다.

오류 해결 방법

가져오기 파일의 다른 연락처는 여전히 가져오기되지만, 차단된 연락처는 가져오기를 통해 추가할 수 없습니다. 영구 삭제된 연락처를 CRM에 다시 추가하는 유일한 방법은 해당 연락처가 양식을 제출하도록 요청하는 것입니다. 연락처가 양식을 제출하면 CRM에 새 연락처로 생성됩니다.

열 수 오류

오류 의미

가져오기 파일에 헤더가 없는 열이 하나 이상 포함되어 있습니다. 헤더가 없는 열의 데이터는 가져오지않았습니다.

오류 해결 방법

해당 열의 데이터를 가져올지 여부를 확인하고, 적절한 헤더를 추가하거나 열을 제거한 후 파일을 다시 가져오십시오.

잘못된 추가 이메일

오류 의미

추가 이메일이 포함된 연락처를 가져올 때, 파일 내에 유효하지 않은 이메일 형식이나 다른 연락처에서 이미 사용 중인 이메일 주소가 포함되어 있습니다. 영향을 받은 레코드는 여전히 가져왔지만, 추가 이메일은 추가되지 않았습니다.

오류 해결 방법

이메일 형식이 잘못된 경우, 올바른 이메일 형식으로 파일을 업데이트한 후 다시 가져오십시오. 이메일이 다른 연락처에서 이미 사용 중이지만 새 연락처에 있어야 하는 경우, 기존 연락처 레코드에서 이메일을 제거한 후 파일을 다시 가져오십시오. 이메일이 다른 연락처에서 이미 사용 중이고 기존 연락처가 해당 이메일을 유지해야 하는 경우, 별도의 조치가 필요하지 않습니다.

잘못된 대체 ID

오류 의미

가져오기 파일에 이메일 주소, 도메인 이름 또는레코드 ID로 가져온 잘못된 값이 포함되어 있습니다. 가져오기 작업으로 레코드가 생성되거나 업데이트되지 않았습니다.

오류 해결 방법

가져오기 파일을 올바른 이메일, 도메인 이름 또는 레코드 ID 값으로 업데이트한 후 파일을 다시 가져오십시오.

잘못된 연관 식별자

오류 의미

가져오기 파일에 레코드를 연관시킬 적절한 고유 값이 포함되어 있지 않습니다. 고유하지 않은 속성을 사용했거나 고유 식별자에 줄바꿈 또는 100자 이상의 문자가 포함된 경우 발생할 수 있습니다. 데이터는 가져왔지만 결과 레코드가 HubSpot에서 연결되지 않았습니다.

오류 해결 방법

가져오기 파일에 유효한 연결 식별자 (예: 연락처의 이메일, 회사의 회사 도메인 이름 또는 레코드 ID)를 포함하도록 업데이트한 후 파일을 다시 가져오세요. 여러 개체를 가져오고 연결하기 위해 파일을 올바르게 설정하는 방법을 알아보세요 .

잘못된 열거형 옵션

오류 의미

가져오기 파일에 열거형 속성의 기존 옵션과 일치하지 않는 값이 포함되었습니다. 이 오류는 다중 선택, 드롭다운 선택, 라디오 선택, 체크박스 유형 속성에 적용됩니다. 영향을 받은 레코드는 가져오기되었으나 열거형 속성에 값이 포함되지 않았습니다.

오류 해결 방법

가져오기 파일을 HubSpot의 속성과 비교하여 잘못된 값을 확인하십시오. HubSpot 기본 열거형 속성(예: 라이프사이클 단계, 산업)의 경우, 값이 영어 옵션 레이블 또는 내부 값과 일치하는지 확인하십시오. 가져오기 파일의 값을 기존 옵션과 일치하도록 업데이트하거나 속성에 사용자 지정 옵션으로 값을 추가할 수 있습니다. 완료 후 파일을 다시 가져오거나 영향을 받은 레코드의 속성 값을 수동으로 업데이트하십시오 .

잘못된 이벤트

오류 의미

사용자 정의 이벤트 또는 마케팅 이벤트 가져오기 시, 가져오기 파일에 잘못된 이벤트(예: 종료 시간 이후 시작 시간을 가진 이벤트)가 포함되어 있습니다. 영향을 받은 행은 가져오지 않았습니다.

오류 해결 방법

파일을 수정하여 유효한 이벤트 속성 값을 포함시킨 후 다시 가져오기하십시오.

잘못된 이벤트 타임스탬프

오류 의미

사용자 정의 이벤트 가져오기의 경우 가져오기 파일에 '발생 시간' 속성에 대해 빈 값 또는 유효하지 않은 타임스탬프가 포함되어 있습니다. 영향을 받은 행은 가져오기되었지만 해당 속성에는 값이 포함되지 않았습니다.

오류 해결 방법

허용되는 타임스탬프 범위(2000-01-01 ~ 3000-01-01) 내에서 값을 추가하거나 업데이트한 후 다시 가져오기하십시오.

잘못된 파일 형식

오류 의미

가져오기 파일이 HubSpot으로 가져오기에 적합하지 않은 형식입니다. 데이터가 가져오지않았습니다.

오류 해결 방법

파일을 .csv, .xls 또는 .xlsx 파일로 변환한 후 다시 가져오기하십시오. HubSpot으로 가져오기 위한 추가 파일 요구 사항을 검토하십시오.

잘못된 숫자 크기

오류 의미

가져오기 파일에 너무 작거나 큰 숫자 값이 포함되어 있습니다. 해당 행은 가져오기되었으나 숫자 속성에는 값이 포함되지 않았습니다.

오류 해결 방법

해당 속성 또는 속성 유형의 형식 요구 사항을 확인하고, 파일을 올바른 형식으로 업데이트한 후 다시 가져오기하십시오. 영향을 받은 레코드의 속성 값을 수동으로 업데이트할 수도 있습니다.

잘못된 레코드 ID

오류 의미

가져오기 과정에서 파일의 열 중 하나가 레코드 ID에 매핑되었습니다. 그러나 파일에 기재된 레코드 ID가 HubSpot의 기존 ID와 일치하지 않았습니다. 해당 레코드는 가져오지않았습니다.

오류 해결 방법

레코드 ID가 정확한지 확인하십시오. 기존 레코드를 내보내 정확한 레코드 ID를 확인하거나, 기존 레코드에 대해 다른 고유 식별자를 사용해야 할 수 있습니다. HubSpot의 기존 개체를 업데이트하거나 연결하지 않는 경우, 가져오기 과정에서 해당 확인란을 선택하지 마십시오.

유효하지 않은 필수 속성

오류 의미

가져오기 파일의 필수 속성에 유효하지 않은 값이 포함되어 있습니다. 해당 행의 데이터는 가져오지않았습니다.

오류 해결 방법

해당 속성 또는 속성 유형의 형식 요구 사항을 확인하고, 올바른 형식에 맞게 파일을 업데이트한 후 다시 가져오십시오.

시트 개수 오류

오류 설명

가져오기 파일에 시트가 하나 이상 포함되어 있습니다. 데이터가 가져오지 않았습니다.

오류 해결 방법

가져오기 파일에서 추가 시트를 제거한 후 다시 가져오기하십시오. HubSpot으로 가져오기 위한 추가 파일 요구 사항을 검토하십시오.

스프레드시트 오류

오류 설명

가져오기 파일이 유효한 스프레드시트 파일이 아닙니다. 데이터가 가져오지 않았습니다.

오류 해결 방법

파일을 .csv, .xls 또는 .xlsx 파일로 변환한 후 다시 가져오기하세요. HubSpot으로 가져오기 위한 추가 파일 요구 사항을 확인하세요.

한도 초과

오류 의미

해당 개체에 저장할 수 있는 레코드 수 한도에 도달하여 HubSpot이 레코드를 생성할 수 없습니다. 이 오류는 표준 CRM 개체(연락처, 회사, 거래, 티켓)에 적용됩니다. 데이터가 가져오지 못했습니다.

오류 해결 방법

해당 개체에 더 이상 필요하지 않은레코드를 삭제한 후 파일을 다시 가져와 새 레코드를 생성하세요. HubSpot 구독 및 제한 사항에 대해 자세히 알아보세요 .

한 행에 오류가 너무 많음

오류 의미

가져오기 파일에 10개 이상의 오류가 있는 행이 포함되어 있습니다. 오류 설명에는 해당 행의 모든 오류와 영향을 받은 열이 나열됩니다. 오류 유형에 따라 해당 행이 가져오지 않았거나, 영향을 받은 열의 값 없이 가져온 경우일 수 있습니다.

오류 해결 방법

각 오류를검토한 후 파일을 업데이트하여 다시 가져오거나, HubSpot에서 영향을 받은 레코드/활동을 수동으로 업데이트하세요.

해당 도메인을 가진 여러 회사

오류 의미

가져오기 파일에 포함된 회사 도메인 이름 값이 HubSpot 계정의 여러 회사와 일치합니다. 가져오기 과정에서 회사 레코드가 업데이트되지 않았습니다.

오류 해결 방법

회사 홈에서 특정 회사 도메인 이름 값을 검색하여 중복 도메인을 찾으십시오. 회사 레코드를 병합하거나 하나를 삭제한 후 파일을 다시 가져오십시오.

중복 소유자 발견

오류 의미

가져오기 파일에 계정 내 두 명 이상의 사용자와 일치하는 소유자 값이 포함되어 있습니다. 이는 주로 이름에서 발생합니다(예: HubSpot 계정에 John Doe 사용자가 두 명 있고, 가져오기 파일에 "John Doe"라는 이름이 포함된 경우). 영향을 받은 레코드는 가져오기되었지만 소유자 속성에는 값이 포함되지 않았습니다.

오류 해결 방법

가져오기 파일에서 소유자 이름을 해당 이메일 주소로 대체한 후 파일을 다시 가져오십시오. 영향을 받은 레코드의소유자 속성 값을 수동으로 업데이트할 수도 있습니다.

유효 기간 범위 초과

오류 의미

가져오기 파일에 허용된 기간 범위를 벗어난 기간 값이 포함되어 있습니다. 영향을 받은 레코드는 가져오기되었으나 기간 속성에는 값이 포함되지 않았습니다. 

오류 해결 방법

파일의 기간 값을 허용된 시간 범위(1개월 이상의 정수) 내에 맞게 업데이트한 후 파일을 다시 가져오십시오. 영향을 받은 레코드의 속성 값을 수동으로 업데이트할 수도 있습니다.

유효한 시간 범위 초과

오류 의미

가져오기 파일에 허용된 시간 범위를 벗어난 기간 값이 포함되어 있습니다. 영향을 받은 레코드는 가져오기되었지만, 시간 범위 속성에는 값이 포함되어 있지 않습니다.

오류 해결 방법

파일의 시간 범위 값을 허용된 시간 범위(1000년 미만) 내에 있도록 업데이트한 후 파일을 다시 가져오십시오. 영향을 받은 레코드의 속성 값을 수동으로 업데이트할 수도 있습니다.

포털 전체 사용자 정의 개체 한도 초과

오류 설명

해당 사용자 정의 개체에 저장할 수 있는 레코드 수 한도에 도달하여 HubSpot이 레코드를 생성할 수 없습니다. 데이터가 가져오지 않았습니다.

오류 해결 방법

더 이상 필요하지 않은 레코드가 있는 경우 해당 사용자 정의 개체 내 레코드를 삭제한 후 파일을 다시 가져오십시오. 추가 레코드 저장 공간이 필요한 경우 사용자 정의 개체 레코드 한도 증량을 구매할 수 있습니다. HubSpot 구독 및 제한 사항에 대해 자세히 알아보세요 .

속성 정의가 없습니다

.

오류 의미

가져오기 파일에 HubSpot 속성과 일치하지 않는 열 헤더가 포함되어 있습니다. 해당 열의 데이터는 가져오지않았습니다.

오류 해결 방법

가져오기 과정에서 [ 파일의 열을 [객체] 속성에 매핑 ] 페이지에서 기존 속성을 선택하거나 새 속성을 생성하여 열을 올바르게 매칭하세요. 일치하지 않는 열의 가져오기를 건너뛰도록 선택할 수도 있습니다.

속성 유효성 검사 규칙 오류

오류 의미

가져오기 파일에 속성의 유효성 검사 규칙 요구 사항을 충족하지 않는 값이 포함되어 있습니다(예: 값에 특수 문자가 포함됨, 너무 길거나 짧음 등). 영향을 받은 레코드는 가져오기되었지만 해당 속성에는 값이 포함되지 않았습니다.

오류 해결 방법

설정에서 속성의 유효성 검사 규칙을 확인하거나 편집하세요. 속성 규칙을 따르는 값을 포함하도록 가져오기 파일을 업데이트한 후 파일을 다시 가져오세요. 영향을 받은 레코드의 속성 값을 수동으로 업데이트할 수도 있습니다.

필수 속성 누락

오류 의미

가져오기 파일에 필수 속성의 값이 누락되었습니다. 해당 행의 데이터는 가져오지않았습니다.

오류 해결 방법

가져오기 파일을 수정하여 필수 속성에 값을 포함시킨 후 파일을 다시 가져오세요.

행 데이터가 너무 큼

오류 의미

파일에 1MB를 초과하는 데이터를 포함하는 셀 또는 행이 있어 가져오기 도구에서 처리할 수 없습니다. 해당 행의 데이터는 가져오지 않았습니다.

오류 해결 방법

파일에서 해당 셀 또는 행의 크기를 줄인 후 파일을 다시 가져오세요.

알 수 없는 잘못된 요청

오류 의미

가져오기 파일에 유효하지 않은 레코드 ID가 포함되어 있으며, 이는 HubSpot 계정의 기존 레코드와 일치하지 않습니다. 데이터가 기존 레코드와 일치하지 않아 가져오기 시 레코드가 업데이트되지 않았습니다.

오류 해결 방법

올바른 레코드 ID를 사용했는지 확인하세요. 잘못된 ID를 발견한 경우, 올바른 레코드 ID로 가져오기 파일을 업데이트한 후 파일을 다시 가져오세요.

알 수 없는 오류

오류 의미

알 수 없는 오류로 인해 HubSpot이 파일을 처리할 수 없습니다. 데이터가 가져오지않았습니다.

오류 해결 방법

파일이 모든 요구 사항을 충족하는지 확인하세요. 브라우저 캐시를 지우거나 다른 브라우저를 사용한 후 다시 가져오기를 시도하세요. 여전히 오류가 발생하면 커뮤니티 (모든 사용자)에 게시하거나 지원팀 (Starter, Professional, Enterprise 계정만 해당) 에 문의하세요.

가져오기 업데이트만

오류 의미

가져오기가 기존 레코드만 업데이트하도록 선택했지만, 가져오기 파일에 HubSpot의 기존 레코드와 일치하지 않는 고유 식별자 값이 포함되어 있습니다. 예를 들어, 기존 연락처 이메일과 일치하지 않는 이메일 값이나 기존 레코드와 일치하지 않는 레코드 ID 값을 가져온 경우입니다. 해당 행은 가져오지 않았으므로 새 레코드는 생성되지 않았지만 기존 레코드는 업데이트되었습니다.

오류 해결 방법

해당 값이 기존 레코드와 일치해야 했다면 값이 올바르게 표기되었는지 또는 올바른 레코드 ID 번호를 포함하는지 확인하십시오. 파일의 오류를 수정한 후 다시 가져오십시오.

기존 레코드만 업데이트하고 새 레코드를 생성하지 않으려는 경우 별도의 조치가 필요하지 않습니다. 영향을 받은 행으로 새 레코드를 생성하려면 파일을 재가동하고, 가동 과정에서 새 레코드 생성 및 기존 레코드 업데이트 옵션을 선택하십시오.

Salesforce 가동 오류

1. HubSpot 계정에서 데이터 관리 > 데이터 통합으로 이동합니다.
2. 오류가 발생한 Salesforce 가져오기 항목 위에 마우스를 올린 후'가져오기 오류 보기'를 클릭하세요. 
3. 가져오기 오류 테이블에서 오류를 마우스로 가리킨 후'상세 정보 보기'를 클릭하면 자세한 내용을 확인할 수 있습니다.
4. 오른쪽 패널에는 오류 설명과 해결 방법이 표시됩니다. 또한 오류의 영향을 받은 레코드 목록도 확인할 수 있습니다. 레코드 링크를 클릭하면 해당 레코드에 접근하여 필요한 변경을 수행할 수 있습니다.