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

예상 5 읽은 시간(분)

업데이트 2024년 10월 17일 오후 4:03 EST

과거 이벤트 데이터를 Klaviyo 로 수동으로 가져오는 방법을 알아보세요. ,, 과 Klaviyo같은 플랫폼과 -구축된 통합을 사용하는 Shopify Magento BigCommerce API 것이 좋지만, 사용자 지정 통합의 경우 을 통해 수동으로 데이터를 추가할 수도 있습니다. 일반적인 예로 Klaviyo 통합이 미리 구축되어 있지 않은 이전 전자상거래 플랫폼의 과거 구매 데이터를 추가하는 것이 있습니다.

CSV 업로드의 경우 50MB로 제한되어 있다는 점에 유의하세요.

데이터 포맷

첫 번째 단계는 CSV 파일에서 데이터를 올바르게 포맷하는 것입니다. 다음은 주문 처리된 데이터의 예시이며, 아래 필드에 대한 설명도 함께 제공됩니다. CSV 파일의 각 행은 누군가가 수행한 작업 또는 활동을 나타내야 합니다. 예: "제품 구매" 또는 "웨비나 등록" 추적할 작업이 여러 개 있는 경우 별도의 CSV 파일로 업로드해야 합니다. CSV를 업로드할 때 이메일 주소가 가장 먼저 입력되어야 합니다.

다음은 데이터 서식을 지정할 때 참조할 수 있는 몇 가지 예제 이벤트 CSV입니다.

필수 필드

두 가지 필수 필드는 이벤트 발생 시점을 식별하는 타임스탬프와 작업을 수행한 사람을 식별하는 고객 속성(이메일 또는 고유 ID)입니다.

타임스탬프: 타임스탬프: 이벤트의 날짜와 시간을 보여주는 타임스탬프입니다. 형식은 YYYY-MM-DD HH:MM:SS입니다. 예를 들어 2012년 11월 14일 오후 1시 30분이 됩니다: 2012-11-14 13:30:00.

CSV 파일에 두 개 이상의 이벤트에 동일한 타임스탬프가 있는 경우 고유한 $event_id를 포함해야 하며, 그렇지 않으면 이벤트 중 하나만 가져오기되고 나머지는 건너뛰게 됩니다. 아래 $event_id 섹션을 참조하세요.
사람//이메일 또는 사람//ID: 대부분 이메일을 사용하여 고객을 식별할 것입니다. 일부 고객은 고유 ID를 사용하기도 합니다. 원하는 경우 둘 다 사용할 수 있습니다.

선택 필드

주목해야 할 두 가지 특별한 필드가 있습니다.

이벤트_ID: 이벤트의 고유 식별자입니다. 실제로는 각 이벤트에 대한 고유 식별자(예: 주문 ID)가 있는 경우 $event_id를 보내야 합니다. 또한 특정 이벤트가 같은 시점에 발생할 것으로 예상되는 경우 $event_id를 설정해야 합니다. 이는 누군가가 하나의 작업을 수행하면 여러 개의 이벤트로 분할할 때 발생할 수 있습니다. 예를 들어, 누군가가 여러 개의 아이템을 구매했는데 구매한 각 아이템에 대해 하나의 이벤트를 기록하려는 경우입니다.

아래의 두 샘플 데이터 세트에는 하나의 주문 이벤트와 3개의 주문한 제품 이벤트(주문한 각 제품에 대해 하나씩)가 있습니다. 이러한 모든 이벤트의 타임스탬프는 동일하지만 각각 고유한 $event_id가 있으므로 모두 가져오기됩니다. 이벤트_아이디가 동일하거나 없는 경우 이벤트 중 하나만 가져오고 다른 이벤트는 건너뜁니다.
값: 가져오려는 이벤트에 값이 포함된 경우 이 필드를 사용합니다. 예를 들어 주문 접수 이벤트 데이터를 가져오는 경우 각 주문에는 값이 있습니다. 값 앞에 $ 또는 기타 통화 기호를 붙일 필요는 없습니다.

어떤 일을 한 사람에 대한 추가 데이터가 있는 경우 레이블이 Person//로 시작하는 열과 해당 열에 있는 데이터 유형에 해당 데이터가 들어가야 합니다. 예를 들어 각 사람이 속한 회사나 조직이 있는 경우 해당 열에 개인//조직이라는 레이블을 지정할 수 있습니다. 특수 접두사를 사용하면 해당 열의 데이터를 활동이 아닌 각 개인과 연결할 수 있습니다. 다음은 사람을 식별하는 데 사용할 수 있는 특수 열입니다:

사람//이름: 이름
사람//성: 성
사람//전화: 전화번호
개인//조직: 조직
사람//직위: 직책

각 작업에 대한 추가 데이터가 있는 경우 원하는 레이블을 사용하여 추가 열에 포함할 수 있습니다. 예를 들어, 누군가가 무언가를 구매했는데 어떤 품목을 구매했는지 포함하려면 해당 데이터를 구매한 품목이라는 열에 포함할 수 있습니다. 다음은 몇 가지 예입니다.

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

특정 열에 대한 데이터가 없는 경우 해당 열을 비워두면 무시됩니다. 예를 들어, 누군가의 조직을 모르는 경우 개인//조직 열을 비워두면 데이터에서 해당 행에 대한 해당 속성 추적을 건너뛸 수 있습니다.

데이터 서식을 지정한 후에는 CSV 파일로 저장합니다.

데이터의 CSV 파일 업로드

데이터 형식이 올바르게 지정되면 클라비요로 이동하여 왼쪽 하단에 있는 계정 이름을 클릭한 다음 통합 > 소스 관리 > CSV를 통해 가져오기를 선택합니다.

CSV 파일을 업로드하라는 메시지가 표시되면 다음을 클릭합니다.

다음으로 이벤트 이름을 지정할 수 있습니다. 가져온 데이터를 계정에 이미 존재하는 이벤트 지표에 매핑하려는 경우 이벤트 이름을 이미 표시된 그대로 정확하게 입력해야 합니다.

이벤트 이름을 지정한 후에는 아래에서 데이터를 미리 볼 수 있습니다. 데이터를 가져올 준비가 되면 다음을 클릭합니다. 파일 처리가 시작되고 페이지에서 다른 곳으로 이동할 수 있습니다.

구매 데이터를 로드하는 전자상거래 스토어를 위한 참고 사항

구매 데이터를 업로드하는 경우 전체 주문에 대한 파일과 품목별 데이터가 포함된 파일 두 개를 업로드해야 합니다. 예를 들어 고객이 여러 제품을 주문할 수 있습니다. 이 경우 배치된 주문에 대해 하나의 이벤트가 발생하고 주문한 각 제품에 대해 별도의 이벤트가 발생합니다. 이러한 파일의 헤더는 일반적으로 다음과 같이 표시되어야 합니다:

주문하기

사람//이메일	사람//이름	사람//성	타임스탬프	이벤트_ID	value	수량	항목
John@gmail.com	John	Smith	2014-03-10 08:55:01	12425	49.00	2	["앵무새를 죽이기 위하여", "사전"]

주문한 제품

사람//이메일	사람//이름	사람//성	타임스탬프	이벤트_ID	value	수량	항목
John@gmail.com	John	Smith	2014-03-10 08:55:01	12425_TKM	24.00	1	앵무새를 죽이기 위해
John@gmail.com	John	Smith	2014-03-10 08:55:01	12425_P	25.00	1	사전

주문 값 접두사로 $를 사용하지 않습니다. 주문의 가격이나 가치를 표시하려면 숫자만 사용하세요. value 헤더를 사용하면 클라비요 계정에 데이터가 올바르게 채워집니다.

두 가지 지표를 포함하는 이유는 나중에 전체 주문과 특정 카테고리/품목 모두에서 이메일을 트리거하기가 더 쉬워지기 때문입니다.

주문한 제품 이벤트의 경우 $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 파일을 저장하거나 내보낼 때 제거되지 않았는지 확인합니다. 스프레드시트에서 데이터로 작업하는 경우 타임스탬프 셀이 올바른 타임스탬프 형식으로 설정되어 있는지 확인하세요.
모든 필수 열에 모든 행에 데이터가 채워져 있나요? 개인//이메일 또는 개인//ID로 레이블이 지정된 열이 있어야 합니다.이러한 열 중 하나에 빈 행이 있으면 가져오기에 실패할 수 있습니다.
개인//이메일 열에 잘못된 이메일 주소가 있나요? 사람//이메일에 유효한 이메일 주소 형식이 아닌 값이 있는 경우 가져오기에 실패할 수 있습니다.
모든 열에 레이블이 올바르게 지정되어 있나요? 공백이 있나요? 모든 열 머리글이 이 가이드에 설명된 내용과 일치하는지 확인하세요. 또한 열 이름에 공백이 없는지 확인해야 합니다.