Spree와 연동하는 방법
학습 내용
Spree를 Klaviyo에 연동하는 방법을 알아보세요. 이 단계를 완료하면 각 고객의 구매 및 웹사이트 활동을 기반으로 이메일을 맞춤 설정하고 타겟팅할 수 있어요. Spree에서 동기화하는 데이터는 다음과 같아요:
- 구매한 제품, 제품 이미지, 같은 이메일의 다른 버전 세부정보, 적용된 모든 할인 등을 포함한 판매 및 주문 데이터
- 이름과 성, 위치, 스토어를 알게 된 경로를 포함한 고객 정보
- 처리된 주문 데이터
Spree 2.2.14, 2.3.13 버전에 적용된 보안 패치가 2.4.10 및 3.0.4에서 검색 가능한 파라미터를 허용 목록에 추가하도록 강제합니다. 기본 허용 목록에 제품 및 주문의 updated_at 속성이 포함되지 않았습니다. Klaviyo의 연동은 이 파라미터에 의존하므로, 연동이 원활하게 실행되도록 이 속성을 허용 목록에 추가하는 업데이트를 푸시해야 합니다. 주문의 updated_at 속성을 허용 목록에 추가하지 않으면, 주문이 생성될 때까지 체크아웃 시작 이벤트가 동기화되지 않을 수 있습니다.
Klaviyo에서 Spree 연동 추가
- Klaviyo에서 연동 탭을 선택합니다.
- 앱 살펴보기를 클릭하고 Spree를 검색한 다음 카드를 클릭하세요. 그런 다음 설치를 클릭합니다.
- 다음 페이지에서 스토어 URL과 Spree API 키/암호화된 비밀번호를 제공해야 해요. Spree 관리자에서 사용자로 이동해 계정을 선택한 다음 API 키 생성을 선택하면 이 API 키를 생성할 수 있어요.
- Klaviyo로 돌아가 스토어 URL과 API 키/암호화된 비밀번호를 상자에 붙여넣어 주세요.
- 버전이 지정된 Spree API(v1)를 사용 중인 경우 해당 확인란을 선택합니다.
- Spree에 연결을 클릭합니다.
- Spree 스토어에서 이메일 수신에 옵트인한 고객을 Klaviyo의 목록에 추가하려면, 다음 페이지에서 새 Spree 고객을 Klaviyo 목록에 추가 확인란을 선택해 주세요. 이 확인란을 선택한 후, 새 옵트인이 추가될 목록을 선택해 주세요.
- 준비가 완료되면 설정 완료를 클릭합니다. 그런 다음, 성공적으로 통합되었음을 나타내는 성공 메시지가 표시될 거예요.
Klaviyo 온사이트 트래킹 설치
사이트에서 활성 및 조회한 제품의 2개 이벤트로 구성된 온사이트 트래킹을 설치하려면 먼저 공개 API 키를 찾으세요. Klaviyo 계정에 로그인한 다음 계정 이름 > 설정 > API 키로 이동하세요. 공개 키는 6자 길이예요. 다음 단계에서 사용할 수 있도록 이 키를 안전하게 복사하세요.
활용할 수 있는 온사이트 트래킹에는 두 가지 유형이 있어요:
- 사이트에서 활성
이 지표는 식별 가능한 브라우저가 웹사이트를 방문할 때마다 추적됩니다. - 조회된 제품
이 지표는 식별 가능한 브라우저가 웹사이트의 제품 페이지를 볼 때마다 추적됩니다.
"사이트 내 활성 상태" 트래킹
이 지표는 식별 가능한 브라우저가 웹사이트를 방문할 때마다 추적됩니다.
- 사이트에서 활성 활동 트래킹을 시작하려면 모든 페이지에 포함되도록 기본 스토어 템플릿에 다음 코드 스니펫을 추가해 주세요. 이 스니펫은 사용하는 다른 애널리틱스 스크립트와 함께 넣거나, 닫는 </body> 태그 바로 앞에 배치해 주세요.
Public API Key을(를) Klaviyo 계정의 공개 API 키로 바꿔 주세요.
<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=PUBLIC_API_KEY"></script>
<script type="text/javascript">
//Initialize the Klaviyo object on page load
!function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=new Proxy({},{get:function(n,i){return"push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))}));return e}}})}catch(n){window.klaviyo=window.klaviyo||[],window.klaviyo.push=function(){var n;(n=window._klOnsite).push.apply(n,arguments)}}}}(); </script> - 웹사이트에 사용하는 템플릿 유형에 따라 {% if user.is_logged_in %} 및 {{ user.email }} 구문이 다를 수 있어요. 사용 가능한 템플릿 언어를 사용해 현재 페이지를 보고 있는 사람이 로그인했는지 확인하려고 해요. 로그인했다면 가능할 경우 이메일과 이름을 출력해야 해요. 이름 정보가 없다면 해당 두 줄과 이메일 $email 줄 뒤의 후행 쉼표를 제거해 주세요.
- 이 Klaviyo 트래킹 코드를 사용하면 사이트에서 활성지표를 트래킹할 수 있어 사이트 방문 및 방문자 행동과 관련된 데이터를 확인하고 활용할 수 있어요. 이 지표를 통해 Klaviyo는 식별된 브라우저의 사이트 내 활동을 추적해요.
- 온사이트 트래킹이 제대로 설정되었는지 테스트하려면 스토어의 페이지로 이동한 다음 email@example.com을 이메일 주소로 바꿔 URL 끝에
?utm_email=email@example.com을(를) 추가하세요. 페이지를 다시 로드한 후 Klaviyo에서 이메일 주소를 검색하세요. 프로필이 생성되고 사이트 활동이 트래킹된 것을 확인할 수 있어야 해요.
“제품 조회” 트래킹
탐색 이탈 플로우를 설정하거나 제품 탐색 데이터를 기반으로 세그먼트를 만들려면 Viewed Product 지표에 대한 JavaScript 이벤트 트래킹을 추가해야 합니다.
- 제품 페이지 템플릿에 다음 스니펫을 추가해 주세요:
<script type="text/javascript">
var klaviyo = window.klaviyo || [];
klaviyo.track("Viewed Product", {
Title: '{{ product.name }}',
ItemId: {{ product.id }},
Categories: {{ category in product.categories|json }}, // The list of categories is an array of strings.
ImageUrl: '{{ product.image_url }}',
Url: '{{ product.permalink }}',
Metadata: {
Brand: '{{ product.brand }}',
Price: {{ product.price }},
OnSale: {{ product.on_sale }},
RegularPrice: {{ product.regular_price }},
SalePrice: {{ product.sale_price }}
}
});
</script> - 위 스니펫은
{{ }}플레이스홀더 구문을 사용하며, Spree 스토어에서는 다를 수 있어요. 중요한 점은 어떤 제품 페이지를 보고 있는지에 따라 제품 필드가 동적으로 렌더링된다는 거예요. - 사이트에 Viewed Product 트래킹이 구성되면, 알려진 방문자가 제품 페이지를 둘러보는 동안 Viewed Product 데이터가 Klaviyo 계정에 채워지기 시작해야 해요.
온사이트 트래킹 작동 방식
Klaviyo 온사이트 트래킹을 사이트에 추가하면 “알려진 브라우저”, 즉 이전에 최소 1회 방문하고 참여한 적이 있는 브라우저의 탐색 활동만 추적할 수 있습니다. 온사이트 트래킹 목적상 사이트 방문자를 식별하는 주요 방법은 2가지입니다.
- 누군가 어느 시점에서 Klaviyo 이메일을 통해 귀하의 웹사이트로 이동한 경우
- 누군가 어느 시점에서 Klaviyo 양식을 통해 구독/옵트인한 경우
Klaviyo는 익명 브라우저를 추적하지 않아요.
Klaviyo 동기화 모니터링
연동을 확인하려면:
- Klaviyo에서 분석 드롭다운을 클릭하고 지표를 선택하세요. 여기에서 필터를 적용해 모든 Spree 지표를 볼 수 있어요.
- Spree의 Placed Order지표를 찾은 다음 활동 피드 아이콘을 클릭해 주세요. 연동에서 데이터 동기화가 시작되었다면, 여기에서 Placed Order 이벤트가 채워지는 것을 보기 시작할 거예요.
- 모든 과거 주문 데이터를 자동으로 동기화해요. 이를 확인하려면 Klaviyo에서 특정 날짜의 이벤트 수를 Spree 인터페이스의 수치와 비교하고, 서로 일치하는지 확인해 보세요. 예를 들어 주문 완료 지표를 살펴볼 때는 어제 데이터 포인트에 마우스를 올리거나 차트 아래의 데이터 표를 확인해 어제 보고된 주문 수를 확인할 수 있어요.
- 그 숫자를 어제 Spree에 저장된 값과 비교해 보면 정확히 일치하는 것을 확인할 수 있을 거예요. 일치하지 않는다면 문제는 대부분 Klaviyo 계정의 시간대가 설정된 Spree 시간대와 일치하지 않기 때문이에요.
- Klaviyo에서 표준 시간대 설정을 확인하려면:
- 왼쪽 하단에서 계정 이름을 클릭합니다.
- 설정 > 조직을 선택한 다음 클릭하세요.
- 아래로 스크롤하여 시간대로 이동합니다.
- 이 기록 동기화가 완료되면 연동 탭에서 Spree 연동 주위에 연두색 테두리가 표시됩니다.
Spree에서 동기화된 데이터
Spree 연동은 매시간 Klaviyo와 동기화돼요.
아래는 Spree에서 Klaviyo로 동기화되는 지표 목록이에요. 분석 > 지표에서 계정으로 동기화되는 모든 Spree 지표를 확인할 수 있어요.
'완료된 주문'
이 지표는 누군가 주문을 하고 결제를 성공적으로 완료할 때마다 이벤트를 기록해요. 이는 Spree에서 완료된 주문에 해당하며, 즉 고객이 전체 결제 프로세스를 완료했음을 의미해요. 이 지표를 사용하면 주문 횟수나 생애 가치를 기반으로 사람들의 동적 목록을 쉽게 만들 수 있어요. 또한 과거 고객의 재참여를 유도하는 이메일을 만들거나 첫 구매 고객에게 감사 이메일을 보낼 수도 있어요. 다음 기준에 따라 주문 완료 이벤트를 필터링하고 타기팅할 수 있습니다:
- IsDiscounted
주문에 할인이 적용된 경우(예: true 또는 false)예요. - ItemNames
이 이벤트에서 구매한 제품의 이름입니다.
'주문한 제품'
이 지표는 Placed Order 지표와 비슷하지만, 누군가가 주문한 각 항목에 대해 이벤트가 기록돼요. 예를 들어 누군가 티셔츠 1개와 반바지 1개를 구매했다면, Klaviyo에는 Placed Order 이벤트 1개와 Ordered Product 이벤트 2개(티셔츠 1개, 반바지 1개)가 표시돼요. 이 지표는 특정 항목 또는 특정 카테고리의 항목을 구매한(또는 구매하지 않은) 고객을 타겟팅하는 리스트를 구축하는 데 유용해요. 또한 Ordered Product 지표를 플로우의 트리거로 사용해 자연스럽게 함께 구매되는 관련 제품에 대한 이메일을 보낼 수 있지만, 일부 고객은 아직 이미 구매하지 않았을 수도 있어요.
- Categories
주문한 제품이 속한 카테고리(예: Shirts, Mens 또는 Sale)입니다. - 이름
구매한 제품의 이름(예: 남성용 빨간색 티셔츠)입니다. - ProductId
스토어에 설정된 제품의 ID로, 예: 2022, 2023, 2024. - Quantity
주문한 제품의 수량입니다. - SKU
스토어에서 설정된 그대로의 제품 SKU예요. - 같은 이메일의 다른 버전 옵션: 색상
가능한 경우 제품의 색상(예: 빨간색 또는 파란색)입니다. - 같은 이메일의 다른 버전 옵션: 사이즈
가능한 경우 제품의 사이즈(예: Medium 또는 Large)예요.
'처리된 주문'
이 지표는 고객의 주문이 배송될 때 이벤트를 기록해요. Klaviyo의 이벤트에는 모든 배송의 트래킹 번호가 포함되므로, 이 지표를 배송 확인 이메일의 트리거로 사용할 수 있어요. Fulfilled Order 지표를 기반으로 하는 또 다른 일반적인 이메일로는 제품 리뷰 이메일이 있는데, 최근에 구매한 상품에 대해 고객에게 리뷰를 남겨 달라고 요청하는 이메일이에요. Fulfilled Order 지표를 사용하면 누군가 주문을 수령한 시점을 기준으로 이러한 이메일의 발송 시점을 정할 수 있으므로, 패키지를 받기 전에 이메일을 보내는 일을 걱정할 필요가 없어요. 다음 기준에 따라 Fulfilled Order 이벤트를 필터링하고 타기팅할 수 있어요:
- IsDiscounted
주문에 할인이 적용된 경우(예: true 또는 false)예요. - ItemNames
이 이벤트에서 구매한 항목의 이름입니다.
결제 시작
이 지표는 누군가가 결제를 시작하고 이메일 주소를 입력할 때마다 이벤트를 기록해요. 이 지표의 주요 용도는 장바구니 이탈 이메일을 보내는 것이에요. Klaviyo를 사용하면 누군가 결제를 시작했지만 몇 시간 후에도 주문을 완료하지 않은 경우 장바구니 알림을 보내는 이메일 플로우를 쉽게 설정할 수 있어요. Started Checkout 이벤트에는 누군가의 장바구니에 대한 모든 정보가 포함되어 있어, 장바구니에 담긴 제품과 해당 제품 이미지를 표시할 수 있어요. 고급 사용자의 경우 장바구니 이탈 플로우를 2개 설정할 수 있어요. 하나는 할인 코드를 포함한 첫 구매 고객용이고, 다른 하나는 할인 코드를 포함하지 않은 재구매자용이에요. 다음 기준에 따라 결제 시작 이벤트를 필터링하고 타기팅할 수 있습니다:
- IsDiscounted
주문에 할인이 적용된 경우(예: true 또는 false)예요. - ItemNames
이 이벤트에서 구매한 항목의 이름입니다.
고객 데이터
Klaviyo가 Spree에서 동기화하는 지표 외에도, 각 Klaviyo 프로필에 추가되는 고객 속성도 있어요. 이러한 속성은 세그먼트와 플로우에서 사용할 수 있어요. 다음은 Spree에서 자동으로 동기화되는 속성입니다:
- 이메일
- 이름
- 성
- 도시
- 주/도
- 우편번호
- 국가
- 전화번호
결과
이제 Spree와 Klaviyo 계정을 연동하고, 온사이트 트래킹을 설치했으며, 동기화된 데이터를 검토했어요.