잘못된 형식 오류 메시지 문제 해결
학습 내용
CSV 파일을 사용해 리스트를 업로드할 때 Invalid _ format 오류 메시지가 의미하는 바와 이러한 메시지를 방지하는 방법을 알아보세요.
데이터 유형 불일치에 대하여
Klaviyo로 목록을 가져오면, 필드 매핑 페이지에서 속성을 Klaviyo의 해당 데이터 유형과 일치시킬 수 있어요. 예를 들어 이메일은 항상 텍스트 데이터 유형이에요. 반면 생일에 대한 사용자 지정 속성을 업로드하는 경우 데이터 유형을 날짜로 설정하는 것이 좋아요.
아래에서 데이터 유형, 동의 필드, 허용되는 형식 및 예시를 확인해 주세요.
- 텍스트
모든 텍스트 또는 텍스트와 숫자의 조합이에요. 데이터 형식이 무엇인지 확실하지 않다면 이 옵션을 선택하세요.- 예:
email@example.com
안녕하세요, 세계
$5.00
- 예:
- 숫자
정수와 소수입니다. 숫자 필드에는 통화 기호나 천 단위 구분 기호를 포함하지 마세요.- 예:
2
5.0031
130.0
- 예:
- Boolean
True 또는 false 값입니다.- 예:
참
거짓
- 예:
- 날짜
허용되는 날짜 형식을 알아보려면 프로필 및 이벤트 속성에 허용되는 날짜 및 타임스탬프 형식 가이드를 참고해 주세요.- 예:
2014-09-01 13:34:08
- 예:
- 목록
데이터는 JSON 배열로 포맷되어야 해요.- 예:
["apples","bananas","oranges"]
["apples"]
- 예:
- 동의 필드
각 동의 열을 이메일 마케팅 동의, SMS 마케팅 동의 또는 SMS 거래 동의와 같은 적절한 Klaviyo 속성에 매핑해 주세요. 이 필드는 텍스트 데이터 유형을 사용해요. 각 셀의 값으로Subscribe,Never Subscribed또는Unsubscribed를 사용하세요.
서로 다른 데이터 유형에 어떤 내용이 포함되는지, 그리고 목록을 가져올 때 무엇을 선택해야 하는지에 대한 자세한 내용은 데이터 유형 이해하기 가이드를 참고하세요.
오류: 잘못된 리스트 형식
List 데이터 유형을 사용하려면 데이터가 JSON 배열로 형식화되어 있어야 해요. JSON 배열은 항상 대괄호로 둘러싸여 있고, 각 텍스트 항목은 큰따옴표로 둘러싸여 있어요. 마지막 항목을 제외한 모든 리스트 항목 뒤에는 쉼표가 와야 해요. 항목이 1개만 있더라도 전체 배열을 한 셀에 넣어 주세요.
구부러진 따옴표(“ ”)가 아니라 직선 따옴표(" ")를 사용해 주세요.
아래는 올바른 형식의 JSON 배열이에요:
- ["apples","bananas","oranges"]
- ["apples"]
오류: 잘못된 불리언 형식
부울 값에는 true 또는 false을(를) 사용하세요. Klaviyo는 참(true)의 경우 1, t, yes, y도 허용하고, 거짓(false)의 경우 0, f, no, n도 허용해요. 이 값은 대소문자를 구분하지 않습니다. 인식되지 않는 값을 바꾸거나, 텍스트로 저장하려면 데이터 유형으로 텍스트를 선택해 주세요.
오류: 잘못된 숫자 형식이에요
숫자 데이터 유형은 정수(예: 1, 63)와 소수(예: 1.5, 233.018)를 허용해요. -5와 같은 음수 값도 허용돼요. 통화 기호와 천 단위 구분 기호를 제거해 주세요(예: 1,000 대신 1000 사용).
오류: 유효하지 않은 이메일 형식
Klaviyo는 유효한 형식이 아닌 이메일 주소 항목은 자동으로 건너뛰어요. jane@example.com 같은 유효한 이메일 주소는 로컬 파트(jane), @ 기호, 대소문자를 구분하지 않는 도메인 파트(example.com)로 구성돼요. 이 필수 요소 중 하나라도 누락되면 이메일이 유효하지 않은 것으로 간주해요. 이메일 주소 안에 공백이 있으면 유효하지 않아요, 가져오기 중에는 앞뒤 공백이 제거돼요.
스프레드시트의 필터를 사용해 도메인에 "@" 기호 또는 "."가 누락된 이메일 주소가 있는지 찾아보세요. 이는 초기 점검이며, 주소를 완전히 검증하는 것은 아니에요. 가져오기를 다시 시도하기 전에 유효하지 않은 이메일을 수정하거나 삭제하세요.
이메일 주소가 모두 올바르게 형식이 지정되어 있는데도 이 오류 메시지가 계속 표시되면, 셀 안에 줄바꿈이 있는지 확인하고 제거해 주세요. 셀 안의 줄바꿈은 파싱 오류를 일으키거나 데이터와 제목 간의 정렬이 어긋나게 만들 수 있어요.
오류: 전화번호 형식 문제
전화번호는 +(예: +1) 및 국가 코드로 시작하거나, 별도의 국가 열에 해당 국가가 표시되어 있어야 하며, 허용되는 전화번호 형식을 따라야 해요. 전화번호를 올바르게 형식 지정하고 업로드하는 방법을 알아보세요.
오류를 수정하고 가져오기를 다시 시도해 주세요
다시 가져오기 전에 목록에 구독자를 가져오는 방법에서 사전 요구 사항을 확인해 주세요.
- 가져온 목록을 열고 가져오기 탭을 선택해 주세요.
- 완료된 가져오기에서 오류 파일 다운로드가 표시되면 이를 클릭하고 오류 열을 확인해 주세요. 버튼이 표시되지 않으면 위의 형식 안내에 따라 원본 CSV를 확인해 주세요.
- 위의 안내에 따라 CSV에서 영향을 받은 값을 수정해 주세요. 다운로드한 오류 파일을 다시 사용하는 경우, 업로드하기 전에 오류 및 경고 열을 삭제해 주세요.
- 새 파일 업로드를 클릭한 다음 수정된 CSV를 업로드하세요.
- 열 매핑과 데이터 유형을 검토하고, 연락처의 실제 동의 상태에 따라 모든 동의 프롬프트를 완료한 다음 가져오기를 클릭해 주세요.
가져오기가 완료되면 가져오기 탭을 다시 확인해 결과를 확인하고, 아직 조치가 필요한 행이 있는지도 확인해 주세요.
추가 자료
- Troubleshooting list imports
Learn how to troubleshoot errors that occur when uploading a CSV of contacts to a new or existing list in Klaviyo. Uploading reviews? Head to our article on how to import reviews.
- Understanding data types
Learn about the different options available for storing your data in Klaviyo, and how to use each one. Klaviyo allows you to harness the data collected about your customers to power data-driven marketing choices that will grow your brand. That being said, it's important to understand the data that's being pulled into your account.