리스트 가져오기 문제 해결

학습 내용

Klaviyo에서 연락처 CSV를 새 목록 또는 기존 목록에 업로드할 때 발생하는 오류를 해결하는 방법을 알아보세요. 리뷰를 업로드하시나요? 리뷰 가져오는 방법 문서를 참조하세요.

시작하기 전에 알아야 할 것

파일을 문제없이 가져올 수 있는지 확인하고 싶으신가요? 리스트를 가져오기 전에 아래 요구사항 목록을 확인해 주세요.

• CSV 파일(다른 형식은 안 됨)
• 파일 크기는 50MB 이하여야 해요.
• 첫 번째 행은 헤더예요.
• 모든 행에는 연결된 이메일 주소 또는 전화번호가 있어요.
• 중복된 이메일 주소 또는 전화번호가 없어요.

지원팀에서는 대신 Klaviyo로 CSV를 가져올 수 없어요. 가져오기와 관련해 도움이 필요하면, 목록 가져오기 문제를 성공적으로 해결하는 방법에 대한 팁을 아래 문제 해결 섹션에서 확인해 주세요.

목차

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

가져오기 지연

많은 양의 데이터가 포함된 대용량 파일을 가져오면 가져오기 프로세스가 완료되는 데 몇 시간이 걸릴 수 있어요. 안타깝게도 프로세스가 시작된 후에는 속도를 높일 방법이 없어요. 하지만 가져오기 전에 CSV에서 중복 이메일을 모두 제거하면 가져오기 프로세스를 사전에 더 빠르게 진행할 수 있는 한 가지 방법이 돼요. 리스트의 연락처에 이메일을 보내려는 시점보다 최소 하루 전에 새 리스트를 가져오도록 계획하는 것을 적극 권장해요.

가져오기가 시작되면 처음에는 상태 표시줄이 표시돼요. 다른 화면으로 이동하더라도 목록 수가 시간이 지남에 따라 증가하는 것을 확인하면서 가져오기 진행 상황을 계속 추적할 수 있어요. 목록 가져오기가 완료되는 즉시 이메일을 보내드릴게요.

가져오기 문제 해결

목록이 업로드되지 않으면, CSV 파일에서 다음과 같은 일반적인 오류가 이 문제를 일으키고 있을 수 있으니 확인해 보세요:

단일 필드로 가져온 모든 열

기본 언어로 영어를 사용하지 않는 버전의 Excel을 사용 중이라면, 소프트웨어에서 파일의 구분 기호로 쉼표(,) 대신 세미콜론(;)을 사용할 수 있어요. 해당되는 경우, 가져오기 시 파일이 다음과 같이 보일 수 있어요:

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

또한 CSV가 Klaviyo의 형식 요구 사항과 일치하는지 확인해 주세요. 아직 확인하지 않았다면 데이터 형식 지정에 대한 문서를 확인해 주세요. 예를 들어, 필수 필드 중 하나는 이메일 주소 필드예요.

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

Klaviyo로 목록을 가져오면, 필드 매핑 페이지에서 속성을 Klaviyo의 해당 데이터 유형과 일치시킬 수 있어요. 예를 들어 이메일은 항상 텍스트 데이터 유형이에요. 반면 생일에 대한 사용자 지정 속성을 업로드하는 경우 데이터 유형을 날짜로 설정하는 것이 좋아요.

아래에서 데이터 유형, 허용되는 형식 및 예시를 확인해 주세요.

• 텍스트
  모든 텍스트 또는 텍스트와 숫자의 조합이에요. 데이터 형식이 무엇인지 확실하지 않다면 이 옵션을 선택하세요.
  • 예:
    email@example.com
    안녕하세요, 세계
    $5.00
• Numeric
  모든 번호. 숫자 필드에는 통화 기호를 포함하지 마세요.
  • 예:
    2
    5.0031
    130.0
• Boolean
  True 또는 false 값입니다.
  • 예:
    참
    거짓
• 날짜
  허용되는 날짜 형식을 알아보려면 프로필 및 이벤트 속성에 허용되는 날짜 및 타임스탬프 형식 가이드를 참고하세요.
  • 예:
    2014-09-01 13:34:08
• 목록
  데이터는 JSON 배열로 포맷되어야 해요.
  • 예:
    ["apples","bananas","oranges"]
    ["apples"]
• 동의
  동의는 채널(이메일, SMS 등)과 동의 유형(Klaviyo에서 여러 유형을 사용할 수 있는 경우) 형식으로 지정돼요. 이메일 옵션은 이메일 마케팅 동의만 있어요. SMS의 경우 SMS 마케팅 동의 또는 SMS 거래 동의 중 하나예요. 이 필드의 값은 "구독하다", "Never Subscribed" 또는 "구독 취소"여야 해요. 

각 데이터 유형에 무엇이 포함되는지와 리스트를 가져올 때 어떤 항목을 선택해야 하는지에 대한 자세한 내용은 데이터 유형 이해하기 가이드를 참고해 주세요.

“잘못된 [데이터 유형] 형식” 오류 메시지(예: “잘못된 리스트 형식”)에 대해 자세히 알아보려면 잘못된 형식 오류 메시지 문제 해결 가이드를 확인하세요.

잘못된 날짜 또는 타임스탬프 형식

날짜 또는 타임스탬프 형식을 잘못 사용하고 있을 수 있어요. 둘 중 하나라도 포함했고 Klaviyo에서 허용하는 형식이 확실하지 않다면, 프로필 및 이벤트 속성에 대해 허용되는 날짜 및 타임스탬프 형식 가이드를 확인해 주세요.

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

중복 식별자

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

중복 식별자로 인해 건너뛴 연락처를 확인하려면 건너뛴 레코드 다운로드를 클릭하고, 필요하다면 이 건너뛴 레코드를 다시 업로드하세요.

누락된 고유 식별자

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

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

필수 필드에 값이 누락되었습니다.

필수 필드에 연결된 값이 모두 있는지 확인해 주세요. 예를 들어, 나열된 연락처 중 하나의 이메일 열에 이메일 주소가 누락되어 있으면 업로드할 때 오류가 표시됩니다. 업로드하려는 각 연락처에 모든 필수 필드의 값이 있는지 확인해 주세요. 비어 있다면, 다음 업로드 시도 전에 값을 입력해 주세요.

유효하지 않은 이메일 주소 또는 인식할 수 없는 문자

이 오류 메시지가 표시되면 파일의 이메일 주소에서 유효하지 않은 문자가 있는지 확인해 주세요. 유효하지 않은 문자에는 ( ) , : ; [ / ] 및 공백이 포함돼요.

계정 간 프로필 이전

한 계정에서 다른 계정으로 프로필을 이전할 때, 다른 계정에 업로드할 수 없는 속성이 일부 있어요.

예를 들어 프로필 생성일은 계정에서 프로필이 생성되는 날짜로 설정되므로 이전할 수 없어요. 또 다른 예로는 최초 활성 및 마지막 활성이 있는데, 이는 계정에서의 프로필 활동을 기준으로 자동 설정돼요.

전화번호 형식 문제

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