기록 가져오기 오류 검토 및 문제 해결

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

가져오기를 시작하거나 오류가 있는 파일을 수정하기 전에, HubSpot으로 가져오기와 관련된 용어 및 요구 사항을 확인하세요.

참고: 계정에 따라 각 개체에 대해 맞춤화된 이름이 사용될 수 있습니다(예: ‘회사’ 대신 ‘계정’). 이 문서에서는 개체를 HubSpot의 기본 이름으로 지칭합니다.

가져오기 중 오류 수정

가져오기 과정에서 파일의 열을 HubSpot의

속성에

매핑합니다. 매핑 중에 잘못된 값이나 누락된 값을 발견한 경우, 파일을 편집하여 다시 업로드할 필요 없이 가져오기 도구 내에서 직접 값을 업데이트할 수 있습니다. 예를 들어, 철자 오류를 찾아 수정하거나 빈 셀에 값을 추가할 수 있습니다.

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

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

   

   참고: 파일의 처음 1,000개 행에 나타나는 열 값만 선택할 수 있습니다. 하지만 대체 값을 설정하면 1,000개 행을 초과하는 값을 포함하여 해당 열의 모든 값이 대체됩니다.

   • 선택한 열 값을 대체하지 않고 가져오지 않으려면, 수직 메뉴 아이콘을 클릭한 다음 ‘이 값 가져오지 않기 ’를 클릭하십시오. 이 값은 해당 열에 나타나는 모든 행에서 가져오지 않게 됩니다.
   • 다른 대체 값을 추가하려면 ‘다른 값 대체’를 클릭한 다음, 열 값을 선택하고 대체 값을 설정하십시오.
   • 대체 값을 제거하려면 수직 메뉴 아이콘을 클릭한 다음 '대체 값 제거'를 클릭하십시오. 오류가 있는 값은 삭제할 수 없습니다.
     
   • 모든 대체 설정을 초기화하려면 ‘모든 변경 사항 초기화’를 클릭하십시오. 선택한 각 열 값에 대한 대체 값이 제거됩니다.
   • 패널을 닫으려면 ‘완료’를 클릭하십시오.
3. 오류를 해결하면 ‘매핑됨’ 열에 성공 표시(체크 표시) 가 나타납니다. 열의 값이 수정된 경우, 해당 행에 ‘수정됨’이 표시됩니다.

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

가져오기 검토

가져오기가 완료되면 오류 개요를 포함한 가져오기 요약 페이지로 자동으로 이동합니다. 이전에 완료된 가져오기에 대한 요약도 검토할 수 있습니다 .

1. '요약' 카드에서 가져온 행 수, 새로 생성된 레코드 수, 업데이트된 기존 레코드 수를 확인할 수 있습니다. 가져오기 분석에 대해 자세히 알아보세요 .
   • 경우에 따라 새로 생성되거나 업데이트된 레코드 수가 가져오기 행 수와 일치하지 않을 수 있습니다.
   • 예를 들어, 가져오기에 단일 레코드와 연결된 여러 개의 이메일이 포함된 경우, 보조 이메일은 새로운 레코드를 생성하는 대신 기존 레코드를 업데이트합니다. 이 경우 새로 생성되거나 업데이트된 레코드 수는 가져오기 행 수보다 적게 나타납니다. 
2. 가져오기 과정에서 열거형 속성 값이나 연관 레이블 관련 오류를 수정한 경우, 해당 값에 적용한 변경 사항을 보여주는 섹션이 표시됩니다.

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에서 레코드를 연결할 수 없습니다.

오류 해결 방법

스프레드시트의 각 고유 식별자 행에 고유한 값이 포함되어 있는지 확인하십시오.'업데이트 전용' 가져오기를 수행하는 경우, 고유 식별자 값이 CRM에 존재하는지 확인하십시오. 예를 들어,이메일과회사 도메인 이름을 각각의 고유 식별자로 사용하여 연락처와 회사를 가져오는 경우를 가정해 보겠습니다. 스프레드시트에 12개의 행이 있고 모든 이메일 행에 nick.halden@gmail.com이 포함되어 있습니다. 나머지 11개의 행을 수정하여 각 행에 고유한 이메일 주소가 포함되도록 하십시오.

연락처 수신 거부 실패

오류 의미:

오류 해결 방법:

속성 값이 비어 있는 개체 처리 실패

오류 의미

파일에 여러 열의 값이 비어 있어 HubSpot에서 레코드를 처리할 수 없었습니다. 해당 행의 데이터는 가져오지 못했습니다.

오류 해결 방법

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

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

오류 의미:

오류 해결 방법

파일을 찾을 수 없음

오류 의미

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

오류 해결 방법

파일이 컴퓨터에 저장되어 있는지, 그리고 파일 형식이 올바른지 확인하십시오. 확인이 완료되면 파일을 다시 업로드하십시오.

GDPR 차단 목록에 포함된 이메일

오류 의미

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

오류 해결 방법

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

열 수 오류

오류 의미

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

오류 해결 방법

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

유효하지 않은 추가 이메일

오류 의미

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

오류 해결 방법

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

잘못된 대체 ID

오류 의미

가져오기 파일에 이메일 주소, 도메인 이름 또는레코드 ID로 가져온 값 중 유효하지 않은 값이 포함되어 있습니다. 가져오기 과정에서 레코드가 생성되거나 업데이트되지 않았습니다.

오류 해결 방법

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

잘못된 연결 식별자

오류 의미

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

오류 해결 방법

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

잘못된 열거형 옵션

오류 의미

가져오기 파일에 열거형 속성의 기존 옵션과 일치하지 않는 값이 포함되어 있습니다. 이는 다중 선택, 드롭다운 선택, 라디오 버튼 선택 및 체크박스 유형의 속성에 적용됩니다. 해당 레코드는 여전히 가져오기되었지만, 열거형 속성에는 값이 포함되어 있지 않습니다.

오류 해결 방법

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

유효하지

않은

이벤트

오류 의미

사용자 지정 이벤트 또는 마케팅 이벤트 가져오기의 경우, 가져오기 파일에 유효하지 않은 이벤트(예: 종료 시간 이후의 시작 시간을 가진 이벤트)가 포함되어 있습니다. 해당 행은 가져오지 않았습니다.

오류 해결 방법

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

유효하지 않은 이벤트 타임스탬프

오류 의미

사용자 지정 이벤트 가져오기의 경우, 가져오기 파일에 '발생 일시(Occurred at)' 속성에 대한 빈 타임스탬프나 유효하지 않은 타임스탬프가 포함되어 있습니다. 해당 행은 가져오기는 되었으나, 속성에 값이 포함되어 있지 않습니다.

오류 해결 방법

허용되는 타임스탬프 범위(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개월 이상인 정수) 내에 있도록 수정한 후 파일을 다시 가져오십시오. 또한 해당 레코드의 속성 값을 수동으로 업데이트할 수도 있습니다.

유효한 기간 범위 외

오류 의미

가져오기 파일에 허용되는 기간 범위를 벗어난 기간 값이 포함되어 있습니다. 해당 레코드는 가져오기되었으나, '시간 범위' 속성에 값이 포함되어 있지 않습니다.

오류 해결 방법

파일의 시간 범위 값을 허용되는 시간 범위(1,000년 미만) 내에 있도록 수정한 후 파일을 다시 가져오십시오. 또한 해당 레코드의 속성 값을 수동으로 수정할 수도 있습니다.

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

오류 의미

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

오류 해결 방법

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

속성 정의가 없습니다

오류 의미

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

오류 해결 방법

가져오기 과정에서 ‘파일의 열을 [개체] 속성에 매핑’ 페이지에서 기존 속성을 선택하거나 새 속성을 생성하여 열을 올바르게 매핑하십시오. 일치하지 않는 열의 가져오기를 건너뛸 수도 있습니다.

속성 유효성 검사 규칙 오류

오류 의미

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

오류 해결 방법

• 설정에서 해당 속성의 유효성 검사 규칙을 확인하거나 편집하십시오.

• 가져오기 파일을 수정하여 속성 규칙을 준수하는 값을 포함시킨 후, 파일을 다시 가져오십시오.

• 또한 해당 레코드의 속성 값을 수동으로 수정할 수도 있습니다.

필수 속성 누락

오류 의미

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

오류 해결 방법

가져오기 파일을 수정하여 필수 속성의 값을 포함시킨 후, 파일을 다시 가져오십시오.

행 데이터가 너무 큽니다

오류 의미

파일에 1MB 이상의 데이터를 포함하는 셀이나 행이 있어, 가져오기 도구가 처리하기에는 용량이 너무 큽니다. 해당 행의 데이터는 가져오지 못했습니다.

오류 해결 방법

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

알

수 없는 잘못된 요청

오류 설명

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

오류 해결 방법

레코드 ID가 올바른지 확인하십시오. 잘못된 ID가 발견되면, 올바른 레코드 ID로 가져오기 파일을 수정한 후 파일을 다시 가져오십시오.

알 수 없는 오류

오류 의미

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

오류 해결 방법

• 파일이 모든 요구 사항을 충족하는지 확인하십시오.

• 브라우저 캐시를 지우거나 다른 브라우저를 사용하여 다시 가져오기를 시도해 보세요.

• HAR 파일을 수집하면서 다시 가져오기를 시도해 보세요.

• 여전히 오류가 발생하면 커뮤니티 (모든 사용자)에 게시하거나 지원팀에 문의하십시오 (Starter, Professional 및 Enterprise 플랜사용자만 해당).

업데이트 전용 가져오기

오류 의미

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

오류 해결 방법

영향을 받은 값이 기존 레코드와 일치해야 하는 경우, 값의 철자가 올바른지 또는 올바른 레코드 ID 번호가 포함되어 있는지 확인하십시오. 파일의 오류를 수정한 후 다시 가져오기를 실행하십시오.

기존 레코드만 업데이트하고 새 레코드를 생성하지 않으려는 것이 목적이었다면 별도의 조치가 필요하지 않습니다. 해당 행으로 새 레코드를 생성하려면 파일을 다시 가져온 후, 가져오기 과정에서 ‘새 레코드 생성’ 및 ‘기존 레코드 업데이트’ 옵션을 선택하십시오.

Salesforce 가져오기 오류

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