학습 내용
Spree와 클라비요를 통합하는 방법을 알아보세요. 이 단계를 완료하면 각 고객의 구매 및 웹사이트 활동을 기반으로 이메일을 개인화 및 타겟팅할 수 있습니다. 다음은 Spree에서 동기화하는 데이터입니다:
- 구매한 제품, 제품 이미지, 이형 상품 세부 정보 및 적용된 할인을 포함한 판매 및 주문 데이터
- 이름과 성, 위치, 스토어를 찾은 방법 등의 고객 정보
- 주문 처리 데이터
Spree 버전 2.2.14, 2.3.13에 보안 패치가 적용되었습니다, 2.4.10 및 3.0.4 검색 가능한 매개변수를 강제로 허용 목록에 추가합니다. 제품 및 주문의 updated_at
속성은 기본 허용 목록에 포함되지 않았습니다. 클라비요의 연동은 이 매개변수에 의존하므로 연동이 원활하게 실행되도록 하려면 이 속성을 허용 목록에 추가하는 업데이트를 푸시해야 합니다. 주문에 대해 업데이트된 날짜
속성을 허용 목록에 추가하지 않으면 주문이 완료될 때까지 결제 시작 이벤트가 동기화되지 않을 수 있습니다.
클라비요에 Spree 통합 추가하기
- Spree를 계정에 연결하려면 클라비요로 이동하여 왼쪽 하단에 있는 계정 이름을 클릭한 다음 연동을 선택합니다.
- 연동 서비스 추가를 클릭하고Spree를 검색한 다음 카드를 클릭합니다. 그런 다음 설치를 클릭합니다.
- 다음 페이지에서 스토어 URL과 Spree API 키/암호화된 비밀번호를 입력해야 합니다. Spree 관리자에서 사용자로 이동하여 계정을 선택한 다음 API 키 생성을 선택하면 이 API 키를 생성할 수 있습니다.
- 클라비요로 돌아가서 스토어 URL과 API 키/암호화된 비밀번호를 상자에 붙여넣습니다.
- 버전이 있는 Spree API(v1)를 사용하는 경우 해당 확인란을 선택합니다.
- Spree에 연결을 클릭합니다.
- Spree 스토어에서 이메일 수신을 옵트인한 고객을 클라비요의 목록에 추가하려면 다음 페이지에서 클라비요 목록에 새 Spree 고객 추가 확인란을 선택합니다. 이 확인란을 선택한 후 새 옵트인 목록을 추가할 목록을 선택합니다.
- 준비가 완료되면 설정 완료를 클릭합니다. 그러면 통합에 성공했음을 나타내는 성공 메시지가 표시됩니다.
클라비요 현장 추적 설치
사이트 내 활성 및 조회된 제품이라는 두 가지 이벤트로 구성된 사이트 내 추적을 설치하려면 먼저 공개 API 키를 찾아야 합니다. 클라비요 계정에 로그인하고 계정 이름 > 설정 > API 키로 이동합니다. 공개 키는 6자 길이입니다. 다음 단계에서 사용할 수 있도록 이 키를 안전하게 복사합니다.
활용할 수 있는 현장 추적에는 두 가지 유형이 있습니다:
-
사이트에서 활성상태
이 지표는 식별 가능한 브라우저가 귀하의 웹사이트를 방문할 때마다 추적됩니다. -
조회된 제품
이 지표는 식별 가능한 브라우저가 웹사이트의 제품 페이지를 볼 때마다 추적됩니다.
"사이트에서 활성화됨" 추적
이 지표는 식별 가능한 브라우저가 웹사이트를 방문할 때마다 추적됩니다.
- 사이트 내 활성 활동 추적을 시작하려면 모든 페이지에 포함되도록 기본 스토어 템플릿에 다음 코드 스니펫을 추가합니다. 이 스니펫은 사용하는 다른 분석 스크립트와 함께 배치하거나 </body > 태그를 </body> 닫는 바로 앞에 배치해야 합니다.
-
공개 API 키를
클라비요 계정의 공개 API 키로 교체해야 합니다:<스크립트 유형="텍스트/자바스크립트" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=PUBLIC_API_KEY"></script> <스크립트 유형="텍스트/자바스크립트"> //페이지 로드 시 클라비요 객체를 초기화합니다. !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=새) 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 줄 뒤에 오는 쉼표를 제거합니다.
- 이 클라비요 추적 코드를 사용하면 사이트 방문 및 방문자 행동과 관련된 데이터를 보고 활용할 수 있도록 사이트 측정지표에서 액티브(Active)를 추적할 수 있습니다. 이 지표를 통해 클라비요는 알려진 브라우저에 대한 현장 활동을 추적합니다.
- 사이트 추적이 제대로 설정되었는지 테스트하려면 스토어의 페이지로 이동하여
이메일
주소( email@example.com )를 대체하는 URL 끝에 ?utm_email=email@example.com 을 추가합니다. 페이지를 새로고침한 후 클라비요에서 이메일 주소를 검색합니다. 프로필이 생성되고 사이트 활동이 추적된 것을 확인할 수 있습니다.
"조회한 제품" 추적
검색 이탈 흐름을 설정하거나 제품 검색 데이터를 기반으로 세그먼트를 구축하려는 경우, 조회한 제품 지표에 JavaScript 이벤트 추적을 추가할 수 있습니다.
- 제품 페이지 템플릿에 다음 코드 조각을 추가합니다:
<스크립트 유형="텍스트/자바스크립트"> var klaviyo = window.klaviyo || []; klaviyo.track("조회됨 제품", { 제목: '{{ product.name }}', ItemId: {{ product.id }}, Categories: {{ category in product.categories|json }}, // 카테고리 목록은 문자열 배열입니다. ImageUrl: '{{ product.image_url }}', Url: '{{ product.permalink }}', 메타데이터: { Brand: '{{ product.brand }}', Price: {{ product.price }}, OnSale: {{ product.on_sale }}, RegularPrice: {{ product.regular_price }}, SalePrice: {{ product.sale_price }} } }); </script>
- 위의 코드 조각은
{{ }}
자리 표시자 구문을 사용하며, 이는 Spree 스토어에 따라 다를 수 있습니다. 중요한 부분은 제품 필드가 현재 보고 있는 제품 페이지에 따라 동적으로 렌더링된다는 점입니다. - 사이트에 대해 조회된 제품 추적을 구성한 후에는 알려진 방문자가 제품 페이지를 탐색할 때 조회된 제품 데이터가 클라비요 계정에 채워지기 시작합니다.
현장 추적 작동 방식
클라비요 현장 추적을 사이트에 추가하면 "알려진 브라우저(" ), 즉 이전에 한 번 이상 방문하고 참여한 적이 있는 브라우저의 브라우징 활동만 추적할 수 있습니다. 현장 추적 목적으로 사이트 방문자를 식별할 수 있는 두 가지 주요 방법이 있습니다:
- 누군가 클라비요 이메일을 통해 웹사이트에 접속한 적이 있는 경우
- 누군가 어느 시점에서 클라비요 양식을 통해 구독/동의한 경우
클라비요는 익명의 브라우저를 추적하지 않습니다.
클라비요 동기화 모니터링클라비요 동기화 모니터링
통합을 확인하려면:
- 클라비요에서 애널리틱스 드롭다운을 클릭하고 메트릭을 선택합니다. 여기에서 필터링하여 모든 스프레 메트릭을 볼 수 있습니다.
- Spree의 배치된 오르에르메트릭을찾아 활동 피드 아이콘을 클릭합니다. 통합에서 데이터 동기화가 시작되면 주문 완료 이벤트가 여기에 채워지기 시작합니다.
- 모든 과거 주문 데이터를 자동으로 동기화합니다. 이를 확인하려면 클라비요에서 특정 날짜의 이벤트 수를 Spree 인터페이스의 이벤트 수와 비교하여 일치하는지 확인하면 됩니다. 예를 들어, 주문 접수됨 메트릭을 탐색할 때 어제 데이터 포인트에 마우스를 올리거나 차트 아래의 데이터 표를 확인하여 어제 보고된 주문 수를 확인할 수 있습니다.
- 이 숫자를 어제부터 Spree에 저장된 숫자와 비교하면 정확히 일치하는 것을 확인할 수 있습니다. 그렇지 않은 경우, 클라비요 계정의 시간대가 설정한 스프레 시간대와 일치하지 않는 문제일 가능성이 높습니다.
- 클라비요에서 시간대 설정을 확인하려면 다음과 같이 하세요:
- 왼쪽 하단에서 계정 이름을 클릭합니다.
- 설정을클릭한 다음 > 조직을 선택합니다.
- 시간대까지 아래로 스크롤합니다.
- 이 기록 동기화가 완료되면 연동 탭에서 Spree 연동 주위에 연한 녹색 테두리가 표시됩니다.
Spree에서 동기화된 데이터
Spree 통합은 매 시간마다 클라비요와 동기화됩니다.
다음은 Spree가 클라비요에 동기화하는 메트릭 목록입니다. 애널리틱스 > 지표에서 계정에 동기화되는 모든 Spree 지표를 확인할 수 있습니다.
주문하기
이 메트릭은 누군가 주문을 하고 성공적으로 결제할 때마다 이벤트를 기록합니다. 이는 고객이 전체 결제 프로세스를 완료했음을 의미하는 Spree에서 완료된 주문에 해당합니다. 이 지표를 사용하면 주문 수 또는 평생 가치에 따라 동적 고객 목록을 쉽게 만들 수 있습니다. 과거 고객의 재참여를 유도하는 이메일을 만들거나 처음 구매하는 고객에게 감사 이메일을 보낼 수도 있습니다. 다음 기준에 따라 주문 완료 이벤트를 필터링하고 타겟팅할 수 있습니다:
-
IsDiscounted
주문에 할인이 적용된 경우(예: 참 또는 거짓). -
아이템 이름
이 이벤트에서 구매한 제품의 이름입니다.
주문한 제품
이 지표는 주문 완료 지표와 유사하지만, 주문한 각 품목에 대해 이벤트가 기록됩니다. 예를 들어, 티셔츠와 반바지 한 벌을 구매한 경우 클라비요에서는 주문 이벤트 1개와 주문한 제품 이벤트 2개(티셔츠와 반바지 각각 1개씩)로 표시됩니다. 이 지표는 특정 카테고리에서 특정 품목이나 품목을 구매한(또는 구매하지 않은) 고객을 타겟팅하는 목록을 작성하는 데 유용합니다. 또한 주문한 제품 지표를 흐름의 트리거로 사용하여 자연스럽게 함께 어울리지만 일부 고객이 아직 구매하지 않은 관련 제품에 대한 이메일을 보낼 수도 있습니다.
-
카테고리
주문한 제품이 속한 카테고리(예: 셔츠, 남성 또는 세일). -
이름
구매한 제품 이름(예: 남성용 레드 티셔츠). -
ProductId
스토어에 설정된 제품의 ID(예: 2022, 2023, 2024)입니다. -
수량
주문한 제품의 수량입니다. -
SKU
스토어에 설정된 제품의 SKU입니다. -
변형 옵션: 색상
제품의 색상(예: 빨간색 또는 파란색)입니다. -
변형 옵션: 사이즈
제품의 사이즈(예: 중형 또는 대형)입니다.
주문 처리됨
이 메트릭은 고객의 주문이 배송될 때 이벤트를 기록합니다. 클라비요의 이벤트에는 모든 배송에 대한 추적 번호가 포함되어 있으므로 이 지표를 배송 확인 이메일의 트리거로 사용할 수 있습니다. 주문 처리 메트릭을 기반으로 하는 또 다른 일반적인 이메일은 고객에게 최근에 구매한 품목에 대한 리뷰를 남기도록 요청하는 제품 리뷰 이메일입니다. 주문 처리됨 지표를 사용하면 주문이 접수된 시점을 기준으로 이메일 발송 시간을 지정할 수 있으므로 고객이 패키지를 받기 전에 이메일을 보내지 않아도 됩니다. 다음 기준에 따라 주문 처리됨 이벤트를 필터링하고 타겟팅할 수 있습니다:
-
IsDiscounted
주문에 할인이 적용된 경우(예: 참 또는 거짓). -
아이템 이름
이 이벤트에서 구매한 아이템의 이름입니다.
결제 시작
이 메트릭은 누군가 결제를 시작하고 이메일 주소를 입력할 때마다 이벤트를 기록합니다. 이 메트릭의 주요 용도는 이탈한 장바구니 이메일을 보내는 것입니다. 클라비요를 사용하면 결제를 시작했지만 몇 시간이 지나도 주문이 없는 경우 장바구니 알림을 보내도록 이메일 흐름을 쉽게 설정할 수 있습니다. 결제 시작 이벤트에는 회원의 카트에 대한 모든 정보가 포함되어 있으므로 카트에 있는 제품과 해당 제품의 이미지를 표시할 수 있습니다. 고급 사용자의 경우 할인 코드가 포함된 첫 번째 고객용과 할인 코드가 포함되지 않은 재구매 고객용의 두 가지 중단된 카트 플로우를 설정할 수 있습니다. 다음 기준에 따라 결제 시작 이벤트를 필터링하고 타겟팅할 수 있습니다:
-
IsDiscounted
주문에 할인이 적용된 경우(예: 참 또는 거짓). -
아이템 이름
이 이벤트에서 구매한 아이템의 이름입니다.
고객 데이터
클라비요가 Spree에서 동기화하는 메트릭 외에도 각 클라비요 프로필에 추가되는 고객 속성도 있습니다. 이러한 속성은 세그먼트와 흐름에서 사용할 수 있습니다. 다음은 Spree에서 자동으로 동기화되는 속성입니다:
- 이메일
- 이름
- 성
- 도시
- 주/지역
- 우편 번호
- 국가
- 전화번호
결과
이제 클라비요 계정을 Spree와 통합하고, 현장 추적을 설치하고, 동기화된 데이터를 검토했습니다.
추가 리소스추가 리소스
- 통합 참조 동기화 빈도
- 클라비요와 통합하는 데 도움이 더 필요하신가요? 클라비요의 에이전시 파트너확인