콘텐츠로 건너뛰기

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

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

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

모든 제품 및 플랜

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

가져오기를 시작하거나 오류가 있는 파일을 수정하기 전에 HubSpot으로 가져오기에 대한 관련 용어 및 요구 사항을 알아보세요.

가져오기 중 오류 수정하기

가져오기를 완료하기 전에 HubSpot은 파일의 처음 1,000개 행에서 특정 오류를 확인합니다. 다음 오류 중 하나라도 발견되면 가져오기 프로세스에서 속성을 매핑하는 동안 해당 오류가 표시됩니다:

파일의 맵 열에서 HubSpot 속성 화면으로 이러한 오류를 해결하려면 다음과 같이 하세요:

  • X] 오류를 클릭합니다.

  • 오른쪽 패널에서 영향을 받는 열 및 행을 포함하여 오류 유형에 대한 자세한 내용을 확인합니다.
  • 매핑 중인 속성을 보려면 오른쪽 상단의 속성 이름을 클릭합니다.
  • 특정 오류에 대해 자세히 알아보려면 오류 이름을 클릭합니다.
  • 파일에서 영향을 받는 행을 보려면 오류가 있는 값 보기를 클릭합니다.
  • 권장 해결 방법이 있는 경우 오류 수정 섹션이 나타납니다. 권장 해결 방법을 확인한 다음 오류에 따라 다음을 수행할 수 있습니다:
    • 속성을 편집하려면 [이름] 속성 편집을 클릭합니다. 오른쪽 패널에 속성 편집기가 나타납니다. 권장 사항에 따라 속성을 업데이트한 다음(예: 속성 이름 또는 옵션 편집) 저장을 클릭합니다.
    • 열거형 속성 또는 연결 레이블의 값을 기존 옵션에 다시 매핑하려면 다음과 같이 하세요:
      • 수동으로 다시 매핑하려면 영향을 받는 행에서 선택 옵션을 클릭한 다음 값을 업데이트하는 옵션을 선택하거나 오류 무시를 선택하여 값을 무시합니다. 값을 무시하면 해당 속성에 대한 값 없이 행을 가져옵니다.
      • 자동으로 다시 매핑하려면 오류 자동 수정을 클릭합니다. 명확한 대체 항목이 없는 경우 자동 수정이 성공하지 못할 수 있습니다.
      • 개별 변경 사항을 재설정하려면 업데이트된 옵션을 클릭한 다음 변경 사항 재설정을 클릭합니다. 모든 변경 사항을 실행 취소하려면 모든 변경 사항 재설정을 클릭합니다.
    • 값의 서식을 업데이트하려면(예: 잘못된 날짜 형식) 드롭다운 메뉴를 클릭하고 값의 서식 지정 방식을 업데이트합니다.
    • 속성이 읽기 전용인 경우(예: 특정 기본 HubSpot 속성), [이름] 속성 보기를 클릭하여 속성 세부 정보를 봅니다. 읽기 전용 속성은 편집할 수 없으므로 오류를 해결하려면 파일을 업데이트하고 다시 가져와야 합니다.
  • 기타 옵션 섹션에서 right 을 클릭하여 각 추가 옵션을 확장하고 확인합니다.
  • 오류를 해결하면 매핑됨 열에 success 확인 표시가 나타납니다.

참고: 파일에 1000개 이상의 행이 포함되어 있는 경우 해결되지 않은 오류가 추가로 있을 수 있습니다.

가져오기 검토하기

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

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

  • 특정 오류에 대한 자세한 정보를 보려면 해당 행을 마우스로 가리킨 다음 세부 정보 보기를 클릭합니다.
  • 오류가 있는 모든 행을 보려면 오류가 있는 행 보기를 클릭합니다. 오류가 있는 행 페이지로 이동합니다:
    • 표에서 행과 해당 행에 포함된 오류를 검토합니다. 오류의 영향을 받는 열에는 exclamation 경고 아이콘이 표시됩니다. 가장 왼쪽 열에서 오류의 이름을 클릭하여 오류의 원인과 해결 방법을 확인합니다.
    • 오류가 있는 행을 파일로 다운로드를 클릭하여 영향을 받는 행과 해당 오류를 다운로드합니다. 다운로드한 zip 파일을 클릭하여 CSV 파일을 추출한 다음 파일을 엽니다.
  • 오류 목록을 파일로 다운로드하려면 표 위의 오류를 파일로 다운로드를 클릭합니다.
    • 다운로드한 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

오류의 의미

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

오류를 해결하는 방법

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

중복 행 콘텐츠

오류의 의미

가져오기 파일에 중복 레코드가 포함되어 있음을 HubSpot에서 감지했습니다. 가져오기가 새 레코드를 만들지 못했습니다.

오류를 해결하는 방법

가져오기 파일에서 중복을 제거하고 다시 가져오세요.

중복된 고유 속성 값

오류의 의미

HubSpot의 고유 식별자 속성은 모든 레코드에서 해당 속성 값의 고유성을 적용합니다. 고유 식별자 속성에 매핑된 열의 일부 값이 파일의 다른 행이나 CRM의 다른 레코드와 비교할 때 고유하지 않습니다. 이 속성이 파일에서 고유하지 않은 경우 이 속성에서 참조하는 행 하나만 가져온 것입니다. 이 속성 값이 CRM의 다른 레코드와 충돌하는 경우 레코드를 가져오지 않았습니다.

오류를 해결하는 방법

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

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

  • 충돌하는 고유 값이 있을 수 있습니다(예: 이메일과 사용자 지정 고유 속성에 고유 값이 있지만 중복된 이메일이 있는 사용자 지정 고유 속성). 충돌하는 고유 값을 제거한 다음 다시 가져오세요.
  • 고유 값 속성 중 하나를 업데이트하려는 경우 가져오기 중에 기존 [개체]를 찾는 데 사용할 속성으로 업데이트하지 않으려는 속성을 선택합니다.

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


연결을 만들지 못했습니다.

오류의 의미

HubSpot이 현재 형식으로 레코드를 연결할 수 없습니다. 레코드를 가져왔지만 연결되지 않았습니다.

오류를 해결하는 방법

기록을 연결하기 위한 파일 요구 사항을 충족했는지 확인합니다. 하나의 파일로 가져오는 경우 각 객체에 대해 고유 식별자를 추가해야 할 수 있습니다. 두 개의 파일로 가져오는 경우 제대로 연결하려면 다른 공통 열을 선택해야 할 수 있습니다. 파일을 변경한 후 다시 가져오거나 수동으로 기록을 연결하세요.

연락처를 선택 해제하지 못함

오류의 의미

HubSpot에서 옵트아웃 파일에서 특정 연락처를 옵트아웃할 수 없습니다.

오류를 해결하는 방법

수신 거부 목록에 있는 모든 연락처에 대한 이메일 값이 있는지 확인합니다. 누락된 이메일이 있는 경우 해당 이메일 주소를 파일에 추가하여 연락처의 이메일 수신을 올바르게 옵트아웃합니다. 연락처를 수동으로 만들어 연락처 기록에서 수신 거부할 수도 있습니다.

속성 값이 비어 있는 개체를 처리하지 못함

이 오류의 의미

파일에 여러 열에 대한 빈 값이 포함되어 있으며 HubSpot에서 해당 레코드를 처리할 수 없습니다. 해당 행의 데이터를 가져오지 못했습니다.

오류를 해결하는 방법

가져오기 파일의 누락된 속성 값을 채운 다음 파일을 다시 가져옵니다.

이메일, 거래/티켓 단계 또는 거래/티켓 파이프라인의 유효성 검사에 실패했습니다.

오류의 의미

가져오기 파일에 일반적인 이메일 주소 형식에 맞지 않는 이메일 주소(예: name@domain.com )가 포함되어 있거나 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"라는 이름이 포함되어 있는 경우). 영향을 받는 레코드를 가져왔지만 소유자 속성에 값이 포함되어 있지 않습니다.

오류를 해결하는 방법

가져오기 파일에서 소유자의 이름을 이메일 주소로 바꾼 다음 파일을 다시 가져옵니다. 영향을 받는 레코드에서소유자 속성 값을 수동으로 업데이트할 수도 있습니다.

유효한 기간 범위를 벗어남

오류의 의미

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

오류를 해결하는 방법

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

유효한 시간 범위를 벗어남

오류의 의미

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

오류를 해결하는 방법

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

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

이 오류의 의미

해당 사용자 지정 개체에 대해 저장할 수 있는 레코드 수에 대한 제한에 도달했기 때문에 HubSpot에서 레코드를 만들 수 없습니다. 데이터를 가져오지 못했습니다.

오류를 해결하는 방법

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

속성 정의를 찾을 수 없습니다.

이 오류의 의미

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

오류를 해결하는 방법

가져오는 동안 기존 속성을 선택하거나 파일의 [개체] 속성 페이지에 있는 맵 열에서 새 속성을 만들어 열을 올바르게 일치시키세요. 일치하지 않는 열 가져오기를 건너뛰도록 선택할 수도 있습니다.

속성 유효성 검사 규칙 오류

오류의 의미

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

오류 해결 방법

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

속성 값을 찾을 수 없음

이 오류의 의미

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

오류를 해결하는 방법

필수 속성 값을 포함하도록 가져오기 파일을 업데이트한 다음 파일을 다시 가져옵니다.

행 데이터가 너무 큼

오류의 의미

파일에 1MB가 넘는 데이터가 포함된 셀 또는 행이 포함되어 있어 가져오기 도구에서 처리하기에는 너무 큽니다. 해당 행의 데이터를 가져오지 못했습니다.

오류 해결 방법

파일에서 영향을 받는 셀 또는 행의 크기를 줄인 다음 파일을 다시 가져옵니다.

알 수 없는 잘못된 요청

오류의 의미

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

오류를 해결하는 방법

올바른 레코드 ID를 가지고 있는지 확인합니다. 잘못된 ID를 찾은 경우 가져오기 파일을 올바른 레코드 ID로 업데이트한 다음 파일을 다시 가져옵니다.

알 수 없는 오류

오류의 의미

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

오류를 해결하는 방법

파일이 모든 요구 사항을 충족하는지 확인합니다. 브라우저 캐시를 지우거나 다른 브라우저를 사용한 후 다시 가져오기를 시도해 보세요. 그래도 오류가 계속 발생하면 커뮤니티 (모든 사용자)에 게시하거나 지원팀에 문의하세요(스타터, 프로페셔널엔터프라이즈 계정만 해당).

업데이트만 가져오기

오류의 의미

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

오류 해결 방법

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

새 레코드를 만들지 않고 기존 레코드만 업데이트하는 것이 목표였다면 아무런 조치를 취할 필요가 없습니다. 영향을 받는 행이 대신 새 레코드를 생성하도록 하려면 파일을 다시 가져오고 가져오기 프로세스에서 새 레코드 생성 및 기존 레코드 업데이트를 선택합니다.

Salesforce 가져오기 오류

  • 레코드로 이동합니다:
    • 연락처 HubSpot 계정에서 CRM > 연락처로 이동합니다.
    • 회사: HubSpot 계정에서 CRM > 회사로 이동합니다.
    • 거래: HubSpot 계정에서 CRM > 거래로 이동합니다.
    • 티켓: HubSpot 계정에서 CRM > 티켓으로 이동합니다.
    • 사용자 지정 개체: HubSpot 계정에서 연락처 > 연락처로 이동한 다음 왼쪽 상단의 드롭다운 메뉴를 클릭하고 사용자 지정 개체의 이름을 선택합니다.
    • 제품: HubSpot 계정의 상단 탐색 모음에서 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 개체 > 제품으로 이동합니다.
  • 오른쪽 상단에서 가져오기를 클릭합니다. 제품 색인 페이지에 있는 경우 작업 드롭다운 메뉴를 클릭한 다음 가져오기를 선택합니다 .
  • 오류가 있는 Salesforce 가져오기 위에 마우스를 갖다 댄 다음 가져오기 오류 보기를 클릭합니다.
  • 가져오기 오류 테이블에서 오류를 마우스오버하고 세부 정보 보기를 클릭하여 자세한 정보를 확인합니다.

  • 오른쪽 패널에 오류에 대한 설명과 함께 해결 정보가 표시됩니다. 오류의 영향을 받은 레코드 목록도 볼 수 있습니다. 레코드 링크를 클릭하여 레코드에 액세스하고 필요에 따라 변경합니다.
이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.