과거 이벤트 데이터를 수동으로 가져오는 방법
학습 내용
과거 이벤트 데이터를 Klaviyo로 수동으로 가져오는 방법을 알아보세요. Shopify, Magento, BigCommerce 같은 플랫폼의 Klaviyo 기본 연동과 맞춤 연동을 위한 API 사용을 권장하지만, 이 데이터를 수동으로 추가할 수도 있어요. 흔한 예로, Klaviyo에 사전 구축된 연동이 없는 이전 전자상거래 플랫폼의 과거 구매 데이터를 추가하는 경우가 있어요.
CSV 업로드는 50MB로 제한되어 있어요.
데이터 형식 지정
첫 번째 단계는 CSV 파일에서 데이터를 올바르게 형식화하는 거예요. 첫 번째 행을 열 머리글에 사용해 주세요. 남은 각 행은 "Purchased product" 또는 "Signed up for webinar."처럼 누군가가 수행한 작업이나 활동을 나타내야 해요. 추적할 작업 유형이 여러 가지라면, 각각을 별도의 CSV 파일로 업로드해 주세요. 열은 어떤 순서로 배치되어도 괜찮아요.
데이터를 형식에 맞게 준비할 때 참고할 수 있는 이벤트 CSV 예시가 여기 있어요.
필수 필드
필수 필드 2개는 이벤트가 발생한 시점을 식별하기 위한 타임스탬프와 작업을 수행한 주체를 식별하기 위한 고객 속성(이메일 또는 고유 ID)입니다.
- 타임스탬프: 이벤트가 발생한 날짜와 시간을 표시하는 타임스탬프예요. YYYY-MM-DD HH:MM:SS 형식을 사용하세요. 예를 들어, 2012년 11월 14일 오후 1:30은 다음과 같아요: 2012-11-14 13:30:00.
동일한 사람과 지표에 대해 이벤트가 2개 이상 있고 타임스탬프가 동일한 경우, 각 이벤트에 대해 서로 다른 $event_id을(를) 포함해 주세요. 그렇지 않으면 1개만 가져오고 나머지는 건너뛰어요. 아래의 $event_id 섹션을 확인해 주세요.
- Person//Email 또는 Person//ID: 대부분은 이메일을 사용해 고객을 식별할 가능성이 높아요. 일부 고객은 고유 ID도 사용해요. 원하시면 둘 다 사용할 수도 있어요.
선택 필드
유의해야 할 특별 필드가 2개 있어요.
- $event_id: 이는 이벤트의 고유 식별자입니다. 실제로는 각 이벤트에 대한 고유 식별자(예: 주문 ID)가 있는 경우
$event_id을(를) 전송해야 해요. 또한 같은 사람과 지표에 대해 동시에 여러 이벤트가 발생할 것으로 예상된다면$event_id도 설정해야 해요. 이는 누군가가 한 가지 작업을 수행했는데, 이를 여러 이벤트로 분할하는 경우에 발생할 수 있어요. 예를 들어 누군가가 여러 상품을 구매하는 경우, 구매한 각 상품에 대해 이벤트 1개를 기록하고 싶을 수 있어요.
아래의 2개 샘플 데이터 세트에는 Placed Order 이벤트 1개와 Ordered Product 이벤트 3개(주문된 각 상품당 1개)가 있어요. 이 이벤트들은 모두 동일한 타임스탬프를 가지지만, 각각 고유한 $event_id를 가지고 있기 때문에 모두 가져와요. Ordered Product 이벤트 3개의 $event_id 값이 동일하거나, $event_id 값이 없다면 Ordered Product 이벤트 1개만 가져와요. Placed Order 이벤트는 다른 지표에 속하므로 별도로 가져와요.


- $value: 가져오는 이벤트에 값이 포함되어 있다면 이 필드를 사용해 주세요. 예를 들어 Placed Order 이벤트 데이터를 가져오는 경우, 각 주문에는 값이 있어요. $ 또는 다른 통화 기호 없이 숫자만 사용해 주세요.
누군가가 어떤 작업을 수행한 사람에 대한 추가 데이터가 있다면 Person//로 시작하는 레이블과 해당 열에 포함된 데이터 유형을 이어서 표시한 열에 넣어야 해요. 예를 들어 각 사람이 소속된 회사 또는 조직이 있다면 해당 열의 레이블을 Person//Organization으로 지정하는 것이 좋아요. 특수 접두사는 해당 열의 데이터를 활동이 아니라 각 사람과 연결해야 한다는 것을 알려줘요. 다음은 사람을 식별하는 데 도움이 되는 특별 열이에요:
- Person//First Name: 이름
- Person//Last Name: 성
- Person//Phone: 전화번호
- 개인//조직: 조직
- Person//Title: 직책
각 작업에 대한 추가 데이터가 있으면 원하는 라벨로 추가 열에 포함할 수 있어요. 예를 들어, 누군가가 상품을 구매했고 어떤 상품을 구매했는지 포함하고 싶다면 구매한 상품이라는 열에 해당 데이터를 포함할 수 있어요. 아래는 몇 가지 예시예요.
- 구매한 항목
- 항목 카테고리
- 제품
- 위치
특정 선택 열에 대한 데이터가 없다면 비워 두시면 되고, 저희가 해당 항목은 무시할게요. 예를 들어 누군가의 조직을 모르는 경우 Person//Organization 열을 비워 두시면 되고, 저희가 데이터의 해당 행에서는 그 속성에 대한 트래킹을 건너뛸게요.
데이터 서식 지정이 끝나면 CSV 파일로 저장해 주세요.
CSV 파일 업로드
데이터를 가져오려면 사용자 역할에 연동을 관리할 권한이 있어야 해요.
- Klaviyo에서 연동 탭을 선택합니다.
- 데이터 관리 > CSV를 통해 가져오기를 선택합니다.
- CSV 파일을 업로드하라는 메시지가 표시되면 업로드한 다음 다음을 클릭하세요.
- 이벤트/작업 이름에 이름을 입력해 주세요. 이전 CSV 가져오기에서 지표에 이벤트를 추가하려면 해당 이름을 정확히 입력해 주세요. 다른 연동의 지표 이름과 일치한다고 해서 그 자체만으로는 해당 지표에 데이터가 추가되지 않아요.
- 파일의 타임스탬프와 일치하는 시간대를 선택해 주세요. 타임스탬프가 UTC인 경우 UTC를 선택해 주세요.

- 데이터 미리 보기에서 열 이름과 첫 번째 값 행을 확인해 주세요.
- 데이터를 가져올 준비가 되면 다음을 클릭하세요. 파일 처리가 시작되며, 페이지에서 나가도 됩니다.
- 처리가 완료되면 업로드된 행 수를 확인해 주세요. 완료를 클릭해 연동으로 돌아가세요.
구매 데이터 로딩 중인 전자상거래 스토어 참고 사항
구매 데이터를 업로드하는 경우, 파일 2개를 업로드하는 것이 좋아요. 하나는 전체 주문에 대한 파일이고, 다른 하나는 품목별 데이터를 포함하는 파일이에요. 예를 들어, 고객이 여러 제품을 한 번에 주문할 수도 있어요. 이 경우 Placed Order에 대해 이벤트 1개가 있고, Ordered Products 각각에 대해 별도의 이벤트가 있어요. 일반적으로 해당 파일의 헤더는 다음과 같이 표시돼요:
'완료된 주문'
개인//이메일 | 사람//이름 | 사람//성 | 타임스탬프 | $event_id | $value | 수량 | 품목 |
John@gmail.com | John | Smith | 2014-03-10 08:55:01 | 12,425 | 49.00 | 2 | ["앵무새 죽이기", "픽셔너리"] |
'주문한 제품'
개인//이메일 | 사람//이름 | 사람//성 | 타임스탬프 | $event_id | $value | 수량 | 항목 |
John@gmail.com | John | Smith | 2014-03-10 08:55:01 | 12425_TKM | 24.00 | 1 | To Kill a Mockingbird |
John@gmail.com | John | Smith | 2014-03-10 08:55:01 | 12425_P | 25.00 | 1 | 픽셔너리 |
주문 값을 접두사로 붙이는 데 $을(를) 사용하지 않아요. 주문 가격 또는 값을 표시할 때는 숫자만 사용해 주세요. $value 헤더를 사용하면 Klaviyo 계정에서 데이터가 올바르게 채워져요.
2개의 지표를 포함하는 이유는 나중에 전체 주문과 특정 카테고리/아이템을 모두 기준으로 이메일을 트리거하기가 더 쉬워지기 때문이에요.
주문한 제품 이벤트의 경우, $event_id는 주문과 주문한 제품의 각 조합마다 고유 식별자여야 해요. 고유 식별자를 만드는 한 가지 쉬운 방법은 위 예시처럼 주문 ID와 제품 ID를 결합하는 거예요.
가져오기 문제 해결
아래는 과거 이벤트 데이터를 수동으로 가져올 때 자주 발생하는 문제와 해결 방법이에요.
내 가져오기가 시간이 오래 걸려요
가져오기는 파일 크기에 따라 5분에서 24시간까지 걸릴 수 있습니다. 캠페인에 데이터를 사용해야 하는 시점보다 최소 24시간 전에 가져오기를 시작하실 것을 권장해요. 그래야 가져오기 과정 때문에 발송이 지연되지 않아요.
가져오기에 실패하거나 일부 행이 건너뛰어져요
파일 업로드에 실패하거나 일부 행이 가져와지지 않으면 다음을 확인해 주세요:
- 파일이 .csv 파일인가요? 파일은 .csv 형식이어야 합니다. Excel 파일이나 .txt 파일이 없으면 가져오기에 실패해요.
- Timestamp 열을 올바르게 형식 지정했나요? 날짜 및 시간 형식은 YYYY-MM-DD HH:MM:SS를 사용해 주세요. 예를 들어, 2012년 11월 14일 오후 1:30은 다음과 같습니다: 2012-11-14 13:30:00. 두 번째로 확인하려면 텍스트 편집기에서 CSV를 열어 CSV 파일을 저장하거나 내보낼 때 타임스탬프의 끝에 붙는 0이 삭제되지 않는지 확인해 주세요. 스프레드시트에서 데이터를 작업 중이라면 Timestamp 셀이 올바른 타임스탬프 형식으로 설정되어 있는지 확인해 주세요.

- 모든 필수 열에 모든 행의 데이터가 입력되어 있나요? Timestamp 열과 Person//Email 또는 Person//ID 중 최소 1개를 포함해 주세요. 각 행에는 타임스탬프와 고객 식별자가 필요해요. Person//Email을 포함하는 경우, Person//ID도 함께 있더라도 모든 행에 유효한 이메일 주소가 있어야 해요.
- Person//Email 열에 유효하지 않은 이메일 주소가 있나요? Person//Email 열의 값이 유효한 이메일 주소 형식이 아니면 해당 행은 건너뛰게 돼요.
- 모든 열에 올바르게 레이블이 지정되어 있나요? 대/소문자를 포함해
Timestamp및 선택한 고객 식별자 헤더(Person//Email또는Person//ID)를 정확히 일치시켜 주세요. 이러한 헤더 앞뒤에 있는 불필요한 공백을 제거해 주세요.Person//First Name또는Item Purchased처럼 속성 이름 내 공백은 허용돼요.
추가 자료
- 프로필 및 이벤트 속성 참조를 위한 허용되는 날짜 및 타임스탬프 형식
API를 통해 전송되거나 CSV 업로드로 추가된 이벤트 및 프로필 데이터에서 Klaviyo가 인식하는 날짜 및 시간 형식을 알아보세요. 이벤트 타임스탬프를 Track API를 통해 전송하는 경우에는 적용되지 않으며, 이때는 초 단위의 Unix 시간이어야 해요.
- CSV 파일용 날짜 형식 지정 참조
Excel 및 Google 파일에서 날짜를 편집해 Klaviyo에서 요구하는 날짜 형식과 일치시키는 방법을 알아보세요. 이렇게 하면 고객 데이터가 포함된 CSV를 원활하게 업로드할 수 있고, 업로드 오류를 방지하는 데 도움이 돼요.
- Migrate to Klaviyo