OpenCart와 통합하는 방법

학습 내용

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

시작하기 전 안내 사항 

클라비요는 OpenCart에서 카탈로그를 동기화하지 않는다는 점에 유의하세요.

OpenCart 통합 추가

클라비요의 OpenCart 통합을 추가하는 과정은 여러 단계로 이루어지며 OpenCart와 클라비요 모두 내부에서 작업을 수행해야 합니다.

시작하기 위해 클라비요는 현재 OpenCart 1.4.x 및 1.5.x를 지원합니다. 클라비요 오픈카트 모듈은 여기에서 다운로드하세요: https://www.klaviyo.com/media/downloads/OpenCartKlaviyo-1.1.0.tgz.

1. OpenCart 설치의 루트에 파일의 압축을 풉니다.
2. OpenCart 관리자 섹션에 로그인하고 확장 프로그램 > 모듈 페이지로 이동합니다.
3. 클라비요 모듈을 설치한 다음 클라비요 모듈에 대한 편집을 클릭합니다.
4. OpenCart 설치의 마지막 작업은 `upload/index.php` 끝에 다음 PHP 코드를 복사하여 붙여넣는 것입니다, 응답->getOutput();` 줄 바로 앞에 추가합니다:

   // [클라비요] 고객 장바구니가 있는 경우 저장합니다.
   if ($registry->get('cart')->hasProducts()) {
     $registry->get('load')->model('module/klaviyo');
   
     if ($registry->get('customer')->isLogged()) {
       $registry->get('model_module_klaviyo')->saveCustomerCart(
         session_id(),
         $registry->get('customer')->getId(),
         $session->data['cart']
       );
     } else if (array_key_exists('guest', $session->data)) {
       $registry->get('model_module_klaviyo')->saveGuestCart(
         session_id(),
         $session->data['guest'],
         $session->data['cart']
       );
     }
   }

5. 클라비요 계정에 로그인한 다음 왼쪽 하단에서 계정 이름을 클릭하고 연동을 선택합니다.
6. 연동 추가를 클릭하고 OpenCart을 클릭한 다음 카드를 클릭합니다. 그런 다음 설치를 클릭합니다.
7. 통합 설정 페이지로 이동합니다. 설정 페이지에서 OpenCart 사이트의 URL을 입력하고 OpenCart에 연결을 클릭합니다.
   
8. 다음 페이지에서 클라비요 오픈카트 모듈 아래의 API 키를 복사하여 오픈카트 내 클라비요 모듈 설정에 붙여넣습니다. OpenCart 관리자에서 클라비요 모듈 설정을 저장합니다.
   
9. 원하는 경우 클라비요 목록에 새 OpenCart 고객 추가 설정을 확인한 다음 드롭다운에서 목록을 선택합니다.
10. 클라비요로 돌아와서 설정 완료를 클릭하여 데이터 동기화를 시작합니다.

클라비요 현장 추적 설치

OpenCart에서 현장 활동을 추적하려면 먼저 계정에 로그인하고 왼쪽 하단에서 계정 이름을 클릭한 다음 설정 > API 키로 이동하여 클라비요 공개 API 키를 찾습니다. 공개 키는 6자 길이입니다. 설치할 수 있는 현장 추적에는 두 가지 유형이 있습니다:

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

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

이 지표는 식별 가능한 브라우저가 웹사이트를 방문할 때마다 추적됩니다. 사이트 내 활동 추적을 시작하려면 다음과 같이 하세요:

1. 모든 페이지에 포함되도록 기본 스토어 템플릿에 다음 코드 스니펫을 추가합니다. 이 스니펫은 사용하는 다른 분석 스크립트와 함께 배치하거나 </body > 태그를 닫는 바로 앞에 배치해야 </body>합니다:
   

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

2. PUBLIC_API_KEY를 클라비요 계정의 공개 API 키로 바꿔야 합니다.
3. 방문자나 고객이 스토어 계정을 생성할 수 있는 경우 첫 번째 코드 조각 바로 아래에 다음 코드 조각을 추가합니다:

   <스크립트 유형="텍스트/자바스크립트">
     var klaviyo = window.klaviyo || [];
     {% if user.is_logged_in %}
     klaviyo.identify({
       email: '{{ user.email }}',
       $first_name: '{{ user.first_name }}',
       last_name: '{{ user.last_name }}'
       });
     {% endif %}
   </script>

4. 웹사이트에 사용하는 템플릿 유형에 따라 {% if user.is_logged_in %} 및 {{ user.email }} 구문은 다를 수 있습니다. 사용 가능한 템플릿 언어를 사용하여 현재 페이지를 보고 있는 사람이 로그인했는지 확인하려고 합니다. 그렇다면 가능한 경우 이메일과 이름을 출력해야 합니다. 이름 정보가 없는 경우에는 이 두 줄과 이메일 $email 줄 뒤에 오는 쉼표를 제거합니다.

추가 "조회한 제품" 추적

검색 포기 플로우를 설정하거나 제품 검색 데이터를 기반으로 세그먼트를 구축하려는 경우 "조회한 제품" 메트릭에 대한 JavaScript 이벤트 추적을 추가해야 합니다.

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

   <스크립트 유형="텍스트/자바스크립트">
       var klaviyo = window.klaviyo || [];
       klaviyo.track("조회됨 제품", {
         제목: '{{ product.title }}',
         ItemId: {{ product.id }},
         Categories: {{ category in product.categories|json }}, // 카테고리 목록은 문자열 배열입니다. 
         ImageUrl: '{{ product.image_url }}',
         Url: '{{ product.url }}',
         메타데이터: {
           Brand: '{{ product.brand }}',
           Price: {{ product.price }},
           CompareAtPrice: {{ product.compare_at_price }} // 가격 비교가 있는 경우. 세일이나 특별 가격에 포함할 수도 있습니다.
         }
     });
   </script>

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

현장 추적 작동 방식

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

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

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

클라비요 동기화 모니터링

OpenCart 스토어의 모든 과거 고객 및 주문 데이터를 동기화하는 데 걸리는 시간은 스토어 규모에 따라 다릅니다. 이 기록 동기화가 완료되면 사용 설정된 통합 아래에 OpenCart 통합 주위에 녹색 테두리가 표시됩니다.

통합을 확인하려면:

1. 애널리틱스 아래에 있는 계정의 지표 탭으로 이동합니다. 여기에서 필터링하여 모든 OpenCart 지표를 볼 수 있습니다. OpenCart의 주문 완료( ) 메트릭을 찾아 활동 피드 아이콘을 클릭합니다. 통합에서 데이터 동기화가 시작되면 주문 완료 이벤트가 여기에 채워지기 시작합니다.
2. 모든 과거 주문 데이터를 자동으로 동기화합니다. 이를 확인하려면 클라비요에서 특정 날짜의 이벤트 수를 OpenCart 인터페이스의 이벤트 수와 비교하여 일치하는지 확인하면 됩니다.
3. 예를 들어, 주문 접수됨 메트릭을 탐색할 때 어제 데이터 포인트에 마우스를 올리거나 차트 아래의 데이터 표를 확인하여 어제 보고된 주문 수를 확인할 수 있습니다.
4. 이 숫자를 어제 OpenCart에 저장된 숫자와 비교하면 정확히 일치하는 것을 확인할 수 있습니다. 그렇지 않은 경우 클라비요 계정의 표준 시간대가 설정한 OpenCart 표준 시간대와 일치하지 않는 문제일 가능성이 높습니다.

5. 계정의 표준 시간대를 확인하거나 업데이트하는 방법은 다음과 같습니다.

   • 왼쪽 하단에서 조직 이름을 클릭합니다.

   • 설정을 선택합니다.
   • 조직 탭으로 이동합니다. 

OpenCart에서 동기화된 데이터

• 판매 및 주문 데이터
  제품 세부 정보 및 이미지를 포함하여 어떤 제품을 구매했는지 확인할 수 있습니다.
• 고객 정보
  이름, 성, 위치, 고객 그룹.
• 결제 시작 데이터
  버려진 장바구니 이메일을 트리거하는 데 사용됩니다. 이 기능은 통합할 때 추가한 PHP 코드 스니펫에 의해 활성화됩니다.
• 주문 처리된 주문 데이터
  주문이 배송되는 시기를 추적하는 데 사용됩니다.
• 현장 추적
  사람들이 웹사이트를 방문할 때

클라비요의 애널리틱스 > 메트릭으로 이동하여 OpenCart 메트릭으로 필터링할 수 있습니다.

기본적으로 클라비요는 주문됨 및 주문 처리됨 메트릭에 대해 다음 상태를 동기화합니다:

• 주문됨: 보류 중, 처리 중, 처리 중, 배송 중, 완료됨
• 주문 처리됨: 배송됨, 완료

추가 리소스

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