Spree와 통합하는 방법

학습 내용

Spree와 클라비요를 통합하는 방법을 알아보세요. 이 단계를 완료하면 각 고객의 구매 및 웹사이트 활동을 기반으로 이메일을 개인화 및 타겟팅할 수 있습니다. 다음은 Spree에서 동기화하는 데이터입니다:

• 구매한 제품, 제품 이미지, 이형 상품 세부 정보 및 적용된 할인을 포함한 판매 및 주문 데이터
• 이름과 성, 위치, 스토어를 찾은 방법 등의 고객 정보
• 주문 처리 데이터

클라비요에 Spree 통합 추가하기

1. Spree를 계정에 연결하려면 클라비요로 이동하여 왼쪽 하단에 있는 계정 이름을 클릭한 다음 연동을 선택합니다.
2. 연동 서비스 추가를 클릭하고Spree를 검색한 다음 카드를 클릭합니다. 그런 다음 설치를 클릭합니다.
3. 다음 페이지에서 스토어 URL과 Spree API 키/암호화된 비밀번호를 입력해야 합니다. Spree 관리자에서 사용자로 이동하여 계정을 선택한 다음 API 키 생성을 선택하면 이 API 키를 생성할 수 있습니다.
4. 클라비요로 돌아가서 스토어 URL과 API 키/암호화된 비밀번호를 상자에 붙여넣습니다.
   
5. 버전이 있는 Spree API(v1)를 사용하는 경우 해당 확인란을 선택합니다.
6. Spree에 연결을 클릭합니다. 
7. Spree 스토어에서 이메일 수신을 옵트인한 고객을 클라비요의 목록에 추가하려면 다음 페이지에서 클라비요 목록에 새 Spree 고객 추가 확인란을 선택합니다. 이 확인란을 선택한 후 새 옵트인 목록을 추가할 목록을 선택합니다.
8. 준비가 완료되면 설정 완료를 클릭합니다. 그러면 통합에 성공했음을 나타내는 성공 메시지가 표시됩니다.

클라비요 현장 추적 설치

사이트 내 활성 및 조회된 제품이라는 두 가지 이벤트로 구성된 사이트 내 추적을 설치하려면 먼저 공개 API 키를 찾아야 합니다. 클라비요 계정에 로그인하고 계정 이름 > 설정 > API 키로 이동합니다. 공개 키는 6자 길이입니다. 다음 단계에서 사용할 수 있도록 이 키를 안전하게 복사합니다. 

활용할 수 있는 현장 추적에는 두 가지 유형이 있습니다:

• 사이트에서 활성상태
  이 지표는 식별 가능한 브라우저가 귀하의 웹사이트를 방문할 때마다 추적됩니다.
• 조회된 제품
  이 지표는 식별 가능한 브라우저가 웹사이트의 제품 페이지를 볼 때마다 추적됩니다.

"사이트에서 활성화됨" 추적

이 지표는 식별 가능한 브라우저가 웹사이트를 방문할 때마다 추적됩니다.

1. 사이트 내 활성 활동 추적을 시작하려면 모든 페이지에 포함되도록 기본 스토어 템플릿에 다음 코드 스니펫을 추가합니다. 이 스니펫은 사용하는 다른 분석 스크립트와 함께 배치하거나 </body > 태그를 </body> 닫는 바로 앞에 배치해야 합니다.
2. 공개 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>

3. 웹사이트에 사용하는 템플릿 유형에 따라 {% if user.is_logged_in %} 및 {{ user.email }} 구문은 다를 수 있습니다. 사용 가능한 템플릿 언어를 사용하여 현재 페이지를 보고 있는 사람이 로그인했는지 확인하려고 합니다. 그렇다면 가능한 경우 이메일과 이름을 출력해야 합니다. 이름 정보가 없는 경우에는 이 두 줄과 이메일 $email 줄 뒤에 오는 쉼표를 제거합니다.
4. 이 클라비요 추적 코드를 사용하면 사이트 방문 및 방문자 행동과 관련된 데이터를 보고 활용할 수 있도록 사이트 측정지표에서 액티브(Active)를 추적할 수 있습니다. 이 지표를 통해 클라비요는 알려진 브라우저에 대한 현장 활동을 추적합니다.
5. 사이트 추적이 제대로 설정되었는지 테스트하려면 스토어의 페이지로 이동하여 이메일 주소( email@example.com )를 대체하는 URL 끝에 ?utm_email=email@example.com 을 추가합니다. 페이지를 새로고침한 후 클라비요에서 이메일 주소를 검색합니다. 프로필이 생성되고 사이트 활동이 추적된 것을 확인할 수 있습니다. 

"조회한 제품" 추적

검색 이탈 흐름을 설정하거나 제품 검색 데이터를 기반으로 세그먼트를 구축하려는 경우, 조회한 제품 지표에 JavaScript 이벤트 추적을 추가할 수 있습니다.

1. 제품 페이지 템플릿에 다음 코드 조각을 추가합니다:

   <스크립트 유형="텍스트/자바스크립트">
    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>

2. 위의 코드 조각은 {{ }} 자리 표시자 구문을 사용하며, 이는 Spree 스토어에 따라 다를 수 있습니다. 중요한 부분은 제품 필드가 현재 보고 있는 제품 페이지에 따라 동적으로 렌더링된다는 점입니다.
3. 사이트에 대해 조회된 제품 추적을 구성한 후에는 알려진 방문자가 제품 페이지를 탐색할 때 조회된 제품 데이터가 클라비요 계정에 채워지기 시작합니다.

현장 추적 작동 방식

클라비요 현장 추적을 사이트에 추가하면 "알려진 브라우저(" ), 즉 이전에 한 번 이상 방문하고 참여한 적이 있는 브라우저의 브라우징 활동만 추적할 수 있습니다. 현장 추적 목적으로 사이트 방문자를 식별할 수 있는 두 가지 주요 방법이 있습니다:

• 누군가 클라비요 이메일을 통해 웹사이트에 접속한 적이 있는 경우
• 누군가 어느 시점에서 클라비요 양식을 통해 구독/동의한 경우

클라비요는 익명의 브라우저를 추적하지 않습니다.

클라비요 동기화 모니터링 

통합을 확인하려면:

1. 클라비요에서 애널리틱스 드롭다운을 클릭하고 메트릭을 선택합니다. 여기에서 필터링하여 모든 스프레 메트릭을 볼 수 있습니다.
2. Spree의 배치된 오르에르메트릭을찾아 활동 피드 아이콘을 클릭합니다. 통합에서 데이터 동기화가 시작되면 주문 완료 이벤트가 여기에 채워지기 시작합니다.
3. 모든 과거 주문 데이터를 자동으로 동기화합니다. 이를 확인하려면 클라비요에서 특정 날짜의 이벤트 수를 Spree 인터페이스의 이벤트 수와 비교하여 일치하는지 확인하면 됩니다. 예를 들어, 주문 접수됨 메트릭을 탐색할 때 어제 데이터 포인트에 마우스를 올리거나 차트 아래의 데이터 표를 확인하여 어제 보고된 주문 수를 확인할 수 있습니다.
4. 이 숫자를 어제부터 Spree에 저장된 숫자와 비교하면 정확히 일치하는 것을 확인할 수 있습니다. 그렇지 않은 경우, 클라비요 계정의 시간대가 설정한 스프레 시간대와 일치하지 않는 문제일 가능성이 높습니다.
5. 클라비요에서 시간대 설정을 확인하려면 다음과 같이 하세요:
   • 왼쪽 하단에서 계정 이름을 클릭합니다.
   • 설정을클릭한 다음 > 조직을 선택합니다.
   • 시간대까지 아래로 스크롤합니다.
6. 이 기록 동기화가 완료되면 연동 탭에서 Spree 연동 주위에 연한 녹색 테두리가 표시됩니다.

Spree에서 동기화된 데이터

다음은 Spree가 클라비요에 동기화하는 메트릭 목록입니다. 애널리틱스 > 지표에서 계정에 동기화되는 모든 Spree 지표를 확인할 수 있습니다. 

주문하기 

이 메트릭은 누군가 주문을 하고 성공적으로 결제할 때마다 이벤트를 기록합니다. 이는 고객이 전체 결제 프로세스를 완료했음을 의미하는 Spree에서 완료된 주문에 해당합니다. 이 지표를 사용하면 주문 수 또는 평생 가치에 따라 동적 고객 목록을 쉽게 만들 수 있습니다. 과거 고객의 재참여를 유도하는 이메일을 만들거나 처음 구매하는 고객에게 감사 이메일을 보낼 수도 있습니다. 다음 기준에 따라 주문 완료 이벤트를 필터링하고 타겟팅할 수 있습니다:

• IsDiscounted
  주문에 할인이 적용된 경우(예: 참 또는 거짓).
• 아이템 이름
  이 이벤트에서 구매한 제품의 이름입니다.

주문한 제품

이 지표는 주문 완료 지표와 유사하지만, 주문한 각 품목에 대해 이벤트가 기록됩니다. 예를 들어, 티셔츠와 반바지 한 벌을 구매한 경우 클라비요에서는 주문 이벤트 1개와 주문한 제품 이벤트 2개(티셔츠와 반바지 각각 1개씩)로 표시됩니다. 이 지표는 특정 카테고리에서 특정 품목이나 품목을 구매한(또는 구매하지 않은) 고객을 타겟팅하는 목록을 작성하는 데 유용합니다. 또한 주문한 제품 지표를 흐름의 트리거로 사용하여 자연스럽게 함께 어울리지만 일부 고객이 아직 구매하지 않은 관련 제품에 대한 이메일을 보낼 수도 있습니다.

• 카테고리
  주문한 제품이 속한 카테고리(예: 셔츠, 남성 또는 세일).
• 이름
  구매한 제품 이름(예: 남성용 레드 티셔츠).
• ProductId
  스토어에 설정된 제품의 ID(예: 2022, 2023, 2024)입니다.
• 수량
  주문한 제품의 수량입니다.
• SKU
  스토어에 설정된 제품의 SKU입니다.
• 변형 옵션: 색상
  제품의 색상(예: 빨간색 또는 파란색)입니다.
• 변형 옵션: 사이즈
  제품의 사이즈(예: 중형 또는 대형)입니다.

주문 처리됨

이 메트릭은 고객의 주문이 배송될 때 이벤트를 기록합니다. 클라비요의 이벤트에는 모든 배송에 대한 추적 번호가 포함되어 있으므로 이 지표를 배송 확인 이메일의 트리거로 사용할 수 있습니다. 주문 처리 메트릭을 기반으로 하는 또 다른 일반적인 이메일은 고객에게 최근에 구매한 품목에 대한 리뷰를 남기도록 요청하는 제품 리뷰 이메일입니다. 주문 처리됨 지표를 사용하면 주문이 접수된 시점을 기준으로 이메일 발송 시간을 지정할 수 있으므로 고객이 패키지를 받기 전에 이메일을 보내지 않아도 됩니다. 다음 기준에 따라 주문 처리됨 이벤트를 필터링하고 타겟팅할 수 있습니다:

• IsDiscounted
  주문에 할인이 적용된 경우(예: 참 또는 거짓).
• 아이템 이름
  이 이벤트에서 구매한 아이템의 이름입니다.

결제 시작

이 메트릭은 누군가 결제를 시작하고 이메일 주소를 입력할 때마다 이벤트를 기록합니다. 이 메트릭의 주요 용도는 이탈한 장바구니 이메일을 보내는 것입니다. 클라비요를 사용하면 결제를 시작했지만 몇 시간이 지나도 주문이 없는 경우 장바구니 알림을 보내도록 이메일 흐름을 쉽게 설정할 수 있습니다. 결제 시작 이벤트에는 회원의 카트에 대한 모든 정보가 포함되어 있으므로 카트에 있는 제품과 해당 제품의 이미지를 표시할 수 있습니다. 고급 사용자의 경우 할인 코드가 포함된 첫 번째 고객용과 할인 코드가 포함되지 않은 재구매 고객용의 두 가지 중단된 카트 플로우를 설정할 수 있습니다. 다음 기준에 따라 결제 시작 이벤트를 필터링하고 타겟팅할 수 있습니다:

• IsDiscounted
  주문에 할인이 적용된 경우(예: 참 또는 거짓).
• 아이템 이름
  이 이벤트에서 구매한 아이템의 이름입니다.

고객 데이터

클라비요가 Spree에서 동기화하는 메트릭 외에도 각 클라비요 프로필에 추가되는 고객 속성도 있습니다. 이러한 속성은 세그먼트와 흐름에서 사용할 수 있습니다. 다음은 Spree에서 자동으로 동기화되는 속성입니다:

• 이메일
• 이름
• 성
• 도시
• 주/지역
• 우편 번호
• 국가
• 전화번호

결과

이제 클라비요 계정을 Spree와 통합하고, 현장 추적을 설치하고, 동기화된 데이터를 검토했습니다.

추가 리소스

• 통합 참조 동기화 빈도
• 클라비요와 통합하는 데 도움이 더 필요하신가요? 클라비요의 에이전시 파트너확인