과거 이벤트 데이터를 수동으로 가져오는 방법

학습 내용

과거 이벤트 데이터를 Klaviyo로 수동으로 가져오는 방법을 알아보세요. Shopify, Magento, BigCommerce 같은 플랫폼의 Klaviyo 기본 연동과 맞춤 연동을 위한 API 사용을 권장하지만, 이 데이터를 수동으로 추가할 수도 있어요. 흔한 예로, Klaviyo에 사전 구축된 연동이 없는 이전 전자상거래 플랫폼의 과거 구매 데이터를 추가하는 경우가 있어요.

CSV 업로드는 50MB로 제한되어 있어요.

데이터 형식 지정

첫 번째 단계는 CSV 파일에서 데이터를 올바르게 형식화하는 거예요. 아래는 주문 완료(Placed Order) 데이터 예시와 아래 필드에 대한 설명이에요. CSV 파일의 각 행은 “제품 구매” 또는 “웨비나 신청”처럼 누군가 수행한 작업이나 활동을 나타내야 해요. 추적할 작업이 여러 개라면, 각각을 별도의 CSV 파일로 업로드해야 해요. CSV를 업로드할 때 이메일 주소가 맨 앞에 와야 해요.

데이터를 형식에 맞게 준비할 때 참고할 수 있는 이벤트 CSV 예시가 여기 있어요.

필수 필드

필수 필드 2개는 이벤트가 발생한 시점을 식별하기 위한 타임스탬프와 작업을 수행한 주체를 식별하기 위한 고객 속성(이메일 또는 고유 ID)입니다.

• 타임스탬프: 이벤트의 날짜와 시간을 표시하는 타임스탬프입니다. 형식은 YYYY-MM-DD HH:MM:SS입니다. 예를 들어, 2012년 11월 14일 오후 1:30은 다음과 같습니다: 2012-11-14 13:30:00.

• 사람//이메일 또는 사람//ID: 대부분 고객을 식별하는 데 이메일을 사용하게 될 거예요. 일부 고객은 고유 ID도 사용합니다. 원하신다면 둘 다 사용할 수 있어요.

선택 필드

유의해야 할 특별 필드가 2개 있어요.

• $event_id: 이벤트의 고유 식별자입니다. 실제로 각 이벤트에 대한 고유 식별자(예: 주문 ID)가 있다면 $event_id을(를) 전송해야 합니다. 특정 이벤트가 같은 시점에 발생할 것으로 예상된다면 $event_id도 설정해야 합니다. 이는 한 번의 작업을 여러 이벤트로 분할할 때 발생할 수 있습니다. 예를 들어 여러 개의 항목을 구매하는 경우, 구매한 각 항목에 대해 이벤트 1개씩을 기록할 수 있습니다.
  
  아래의 2개 샘플 데이터 세트에는 주문 완료 이벤트 1개와 함께 주문한 제품 이벤트 3개(주문 완료에 포함된 각 제품당 1개)가 있습니다. 이러한 이벤트는 모두 동일한 타임스탬프를 갖지만, 각 이벤트에 고유한 $event_id가 있으므로 모두 가져오기됩니다. $event_id가 동일하거나 없으면 이벤트 중 1개만 가져오기되고 나머지는 건너뜁니다.
  

• $value: 가져오는 이벤트에 값이 포함되어 있는 경우 이 필드를 사용하세요. 예를 들어 Placed Order 이벤트 데이터를 가져오는 경우 각 주문에는 값이 있어요. 값 앞에 $ 또는 다른 통화 기호를 붙일 필요가 없어요.

누군가가 어떤 작업을 수행한 사람에 대한 추가 데이터가 있다면 Person//로 시작하는 레이블과 해당 열에 포함된 데이터 유형을 이어서 표시한 열에 넣어야 해요. 예를 들어 각 사람이 소속된 회사 또는 조직이 있다면 해당 열의 레이블을 Person//Organization으로 지정하는 것이 좋아요. 특수 접두사는 해당 열의 데이터를 활동이 아니라 각 사람과 연결해야 한다는 것을 알려줘요. 다음은 사람을 식별하는 데 도움이 되는 특별 열이에요:

• Person//First Name: 이름
• Person//Last Name: 성
• Person//Phone: 전화번호
• 개인//조직: 조직
• Person//Title: 직책

각 작업에 대한 추가 데이터가 있으면 원하는 라벨로 추가 열에 포함할 수 있어요. 예를 들어, 누군가가 상품을 구매했고 어떤 상품을 구매했는지 포함하고 싶다면 구매한 상품이라는 열에 해당 데이터를 포함할 수 있어요. 아래는 몇 가지 예시예요.

• 구매한 항목
• 항목 카테고리
• 제품
• 위치

특정 열에 대한 데이터가 없으면 비워 두시면, 해당 항목은 무시할게요. 예를 들어, 누군가의 조직을 모르는 경우 Person//Organization 열을 비워 두시면, 데이터에서 해당 행에 대한 그 속성 트래킹은 건너뛰어요.

데이터 서식 지정이 끝나면 CSV 파일로 저장해 주세요.

CSV 파일 업로드

데이터 형식이 올바르게 지정되면 Klaviyo로 이동하세요.

1. Klaviyo에서 연동 탭을 선택합니다.
2. 데이터 관리 > CSV를 통해 가져오기를 선택합니다.
3. CSV 파일을 업로드하라는 메시지가 표시되면 업로드한 다음 다음을 클릭하세요.
4. 이벤트 이름을 지정할 수 있습니다. 가져온 데이터를 계정에 이미 존재하는 이벤트 지표에 매핑하려는 경우, 이벤트 이름이 기존에 표시된 것과 정확히 일치하도록 입력하세요.

5. 이벤트 이름을 지정하면 아래에서 데이터를 미리 볼 수 있어요.
6. 데이터를 가져올 준비가 되면 다음을 클릭하세요. 파일 처리가 시작되며, 페이지에서 나가도 됩니다.

구매 데이터 로딩 중인 전자상거래 스토어 참고 사항

구매 데이터를 업로드하는 경우, 파일 2개를 업로드하는 것이 좋아요. 하나는 전체 주문용이고, 다른 하나는 품목별 데이터가 포함된 파일이에요.  예를 들어, 고객이 여러 제품을 주문할 수 있어요. 이 경우 '주문 완료(Placed Order)'에 대한 이벤트 1개가 있고, 각 '주문한 제품(Ordered Products)'에 대해 별도의 이벤트가 있어요. 일반적으로 해당 파일의 헤더는 다음과 같은 형태예요:

'완료된 주문'

'주문한 제품'

주문 값을 접두사로 붙이는 데 $을(를) 사용하지 않아요. 주문 가격 또는 값을 표시할 때는 숫자만 사용해 주세요. $value 헤더를 사용하면 Klaviyo 계정에서 데이터가 올바르게 채워져요.

지표를 2개 포함하는 이유는 나중에 전체 주문과 특정 카테고리/항목 모두를 기반으로 이메일을 더 쉽게 트리거할 수 있기 때문이에요.

주문한 제품 이벤트의 경우, $event_id는 주문과 주문한 제품의 각 조합마다 고유 식별자여야 해요. 고유 식별자를 만드는 한 가지 쉬운 방법은 위 예시처럼 주문 ID와 제품 ID를 결합하는 거예요.

가져오기 문제 해결

아래는 과거 이벤트 데이터를 수동으로 가져올 때 자주 발생하는 문제와 해결 방법이에요.

내 가져오기가 시간이 오래 걸려요

목록 크기에 따라 가져오기는 5분에서 24시간까지 걸릴 수 있어요. 가져오기 프로세스가 발송을 지연시키지 않도록, 특정 캠페인에 필요하기 최소 24시간 전에 모든 목록 가져오기를 시작하는 것을 강력히 권장해요.

가져오기가 계속 실패해요

가져오기에 실패했다면, 다음 이유 중 하나 때문일 가능성이 높아요:

• 파일이 .csv 파일인가요? 파일은 .csv 형식이어야 합니다. Excel 파일이나 .txt 파일이 없으면 가져오기에 실패해요.
• 타임스탬프 열을 올바르게 서식 지정했나요? 날짜와 시간은 YYYY-MM-DD HH:MM:SS 형식으로 서식 지정해야 해요. 예를 들어 11월 14일 오후 1:30은 2012-11-14 13:30:00.처럼 표시돼요. 두 번째 확인 단계로, CSV를 텍스트 편집기에서 열어 타임스탬프의 끝에 붙은 0이 CSV 파일을 저장하거나 내보낼 때 제거되지 않는지 확인하세요. 스프레드시트에서 데이터를 작업하는 경우, Timestamp 셀이 올바른 타임스탬프 형식으로 설정되어 있는지 확인해 주세요.
  

• 필수 열에 모든 행의 데이터가 입력되어 있나요? Person//Email 또는 Person//ID로 레이블이 지정된 열이 있어야 합니다.이 두 열 중 하나에 빈 행이 있으면 가져오기가 실패할 수 있어요.
• 사람//이메일 열에 유효하지 않은 이메일 주소가 있나요? Person//Email에 유효한 이메일 주소 형식이 아닌 값이 있으면 가져오기에 실패할 수 있어요.
• 모든 열에 올바르게 레이블이 지정되어 있나요? 공백이 있나요? 모든 열 헤더가 이 가이드에 설명된 내용과 일치하는지 확인해 주세요. 또한 열 이름에 공백이 없는지도 확인해 주세요.

추가 자료