목록 가져오기 문제 해결

학습 내용

클라비요에서 연락처의 CSV를 새 목록이나 기존 목록에 업로드할 때 발생하는 오류를 해결하는 방법을 알아보세요. 리뷰를 업로드하시나요? 리뷰를 가져오는 방법에 대한 글을 참조하세요.

시작하기 전에

파일을 가져올 수 있는지 확인하고 싶으신가요? 목록을 가져오기 전에 아래 요구 사항 목록을 확인하세요.

• CSV 파일(다른 형식이 아님)
• 파일 크기가 50MB 이하인 경우
• 첫 번째 행은 헤더
• 모든 행에는 이메일 주소 또는 전화번호가 연결되어 있습니다.
• 중복되는 이메일 주소나 전화번호가 없습니다.

지원팀은 사용자를 대신하여 CSV를 클라비요로 가져올 수 없습니다. 가져오기와 관련하여 도움이 필요한 경우 아래의 문제 해결 섹션에서 목록 가져오기 문제를 성공적으로 해결하는 방법에 대한 팁을 확인하세요.

목차

• 가져오기 지연
• 가져오기 문제 해결
• 단일 필드로 가져온 모든 열 
• 잘못된 형식 오류 메시지 
• 날짜 또는 타임스탬프 형식이 잘못되었습니다.
• 중복되거나 누락된 고유 식별자 오류 메시지
• 필수 필드에 누락된 값
• 전화 번호 서식 지정 문제

가져오기 지연

상당한 양의 데이터가 포함된 대용량 파일을 가져오면 가져오기 프로세스를 완료하는 데 몇 시간이 걸릴 수 있습니다. 안타깝게도 이 프로세스가 시작된 후에는 속도를 높일 수 있는 방법이 없습니다. 그러나 가져오기 프로세스를 선제적으로 신속하게 처리하는 한 가지 방법은 가져오기 전에 CSV에서 중복된 이메일을 모두 제거하는 것입니다. 목록에 있는 연락처에게 이메일을 보내려면 적어도 하루 전에 새 목록을 가져올 계획을 세우는 것이 좋습니다.

가져오기가 시작되면 처음에는 상태 표시줄이 표시됩니다. 클릭해도 시간이 지남에 따라 목록 수가 증가하는 것을 보면서 가져오기 진행 상황을 추적할 수 있습니다. 목록 가져오기가 완료되는 즉시 이메일을 보내드립니다.

가져오기 문제 해결

목록 업로드에 실패하는 경우, 이 장애를 일으킬 수 있는 CSV 파일에서 다음과 같은 일반적인 오류를 찾아보세요:

단일 필드로 가져온 모든 열 

영어를 기본 언어로 사용하지 않는 Excel 버전을 사용하는 경우, 소프트웨어에서 파일의 구분 기호로 쉼표가 아닌 세미콜론을 사용할 수 있습니다. 이 경우 파일을 가져올 때 파일은 다음과 같이 보일 수 있습니다:

이 문제를 해결하려면 컴퓨터의 숫자 형식 또는 목록(또는 숫자) 구분 기호 설정으로 이동하세요. 이 설정은 언어 & 지역 설정에 있을 가능성이 높으며, 고급 설정 섹션에 있을 수 있습니다. 세미콜론을 쉼표로 바꾸고 저장합니다. 이제 파일을 CSV로 내보낼 때 쉼표 형식을 사용합니다. 이 설정의 정확한 위치는 운영 체제마다 다를 수 있습니다.

또한 CSV가 클라비요의 서식 요구사항에 맞는지 확인하세요. 아직 해보지 않았다면 데이터 서식 지정에 대한 문서를 참조하세요. 예를 들어 필수 입력란 중 하나는 이메일 주소입니다. 

잘못된 형식 오류 메시지 문제 해결하기 

목록을 클라비요로 가져오면 필드 매핑 페이지에서 모든 속성을 클라비요의 해당 데이터 유형에 일치시킬 수 있습니다. 예를 들어 이메일은 항상 텍스트 데이터 유형을 사용하지만 생일에 대한 사용자 지정 속성을 업로드하는 경우 데이터 유형을 날짜로 설정할 수 있습니다.

아래에서 데이터 유형, 허용되는 형식 및 예시를 검토하세요. 

• 텍스트
  모든 텍스트 또는 텍스트와 숫자의 조합입니다. 데이터의 형식이 확실하지 않은 경우 이 옵션을 선택하세요. 
  • 예시: 
    예: email@example.com
    안녕하세요, 세상
    $5.00
• 숫자
  모든 숫자. 숫자 필드에 통화 기호를 포함하지 마세요. 
  • 예시:
    2
    5.0031
    130.0
• 부울
  참 또는 거짓 값입니다.
  • 예시:
    true
    false
• 날짜
  프로필 및 이벤트 속성에 허용되는 날짜 및 타임스탬프 형식에 대한 가이드를 참조하여 허용되는 날짜 형식에 대해 알아보세요.
  • 예시:
    2014-09-01 13:34:08
• 목록
  데이터 형식은 JSON 배열로 지정해야 합니다. 
  • 예시
    ["사과","바나나","오렌지"]
    ["사과"]
• 동의
  동의는 프로필이 이메일 마케팅에 동의했는지 여부를 나타냅니다. 업로드의 동의 데이터 유형에 대한 값은 "이메일" 이어야 합니다.

다양한 데이터 유형에 수반되는 사항과 목록을 가져올 때 선택할 수 있는 데이터 유형에 대한 자세한 내용은 데이터 유형 이해 가이드를 참조하세요.

'[데이터 유형] 형식이 잘못되었습니다' 오류 메시지(예: '잘못된 리스트 형식')에 대해 자세히 알아보려면 잘못된 형식 오류 메시지에 대한 문제 해결 가이드를 참조하세요. 

날짜 또는 타임스탬프 형식이 잘못되었습니다.

날짜 또는 타임스탬프에 잘못된 형식을 사용하고 있을 수 있습니다. 둘 중 하나를 포함했지만 클라비요에서 허용되는 형식이 확실하지 않은 경우 프로필 및 이벤트 속성에 허용되는 날짜 및 타임스탬프 형식에 대한 가이드를 참조하세요.

중복되거나 누락된 고유 식별자 오류 메시지 문제 해결

중복 식별자

"중복 고유 ID" 로 인해 건너뛴 기록은 파일에서 이메일 주소 또는 전화번호가 반복되었음을 의미합니다. 이러한 경우 클라비요는 반복되는 식별자가 포함된 첫 번째 행의 데이터를 처리하고 처리되지 않은 모든 레코드를 다운로드 가능한 파일로 제공합니다. 

건너뛴 레코드 다운로드를 클릭하여 중복 식별자로 인해 건너뛴 연락처를 확인하고 필요한 경우 건너뛴 레코드를 다시 업로드할 수 있습니다. 

누락된 고유 식별자

'고유 ID 누락'으로 인해 건너뛴 레코드는 건너뛴 행에 이메일 주소, 전화번호 또는 기타 허용된 고유 식별자가 포함되어 있지 않음을 의미합니다. 

건너뛴 기록 다운로드를 클릭하여 식별자가 누락되어 건너뛴 연락처를 확인하고, 각 연락처에 이메일 주소나 전화번호를 추가한 다음 새 파일을 다시 업로드하세요. 

필수 필드에 누락된 값

모든 필수 필드에 연결된 값이 있는지 확인합니다. 예를 들어, 나열된 연락처 중 이메일 열 아래에 이메일 주소가 누락된 경우 업로드할 때 오류가 표시됩니다. 업로드하려는 각 연락처에 모든 필수 필드에 대한 값이 있는지 확인하세요. 비어 있으면 다음 업로드를 시도하기 전에 채우세요. 

잘못된 이메일 주소 또는 인식할 수 없는 문자

이 오류 메시지가 표시되면 파일에 있는 이메일 주소에 잘못된 문자가 있는지 확인하세요. 유효하지 않은 문자에는 ( ) , :; [ / ]와 공백이 포함됩니다. 

전화 번호 서식 지정 문제

전화번호에는 국가 코드 또는 국가를 나타내는 별도의 열이 포함되어야 하며, 허용되는 전화번호 형식을 따라야 합니다. 전화번호를 올바르게 포맷하고 업로드하는 방법을 알아보세요. 

추가 리소스

• 기존 목록에 구독자 추가
• 새 목록에 연락처 만들기 및 추가
• 허용되는 날짜 및 타임스탬프 형식