Volusion과 통합하는 방법 – Klaviyo - Help Center - KR

학습 내용

Volusion과 클라비요를 통합하는 방법을 알아보세요. 이 단계를 완료하면 동기화된 주문 데이터와 고객 속성을 기반으로 이메일을 개인화 및 타겟팅할 수 있습니다.

클라비요는 Volusion에서 주문한 제품 및 배치된 주문 통계를추적하며, 몇 가지 추가 코드를 추가하면 포기한 장바구니 정보도추적할 수 있습니다.

시작하기 전 안내 사항

Volusion은 90일마다 Volusion 스토어의 관리자 계정 비밀번호를 업데이트해야 합니다. 이 업데이트를 Volusion 계정에서 수행할 때, 클라비요 계정에서 Volusion 연동도 함께 업데이트해야 합니다. 이 문서의 해당 섹션에 있는 단계에 따라 영구 API 키를 만들 수도 있습니다.

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

Klaviyo에서 연동 탭을 선택합니다.
'앱 탐색'을 선택하세요.
Volusion을 검색하고 카드를 클릭한 다음 설치를 클릭합니다.
다음 페이지에서 스토어 URL, 로그인 이메일, API 키/암호화된 비밀번호를 입력합니다. 그런 다음 Volusion에 연결을 클릭합니다.
다음 페이지에 클라비요 목록에 새로운 Volusion 고객 추가확인란이 표시됩니다. 이 확인란을 선택하면 클라비요에서 향후 고객이 주문할 때 추가할 목록 중 하나를 선택할 수 있습니다.
마지막으로 설정 완료를 클릭합니다.

클라비요에서 이메일 웹 추적 비활성화하기

클라비요의 "이메일에서 웹 추적" 기능은 클릭 추적을 사용하여 클라비요 이메일을 통해 웹사이트에 도착한 사용자를 원래 식별하기 전(예: 구매를 하거나 이메일 목록에 가입한 경우)에 식별합니다.
Volusion은 클릭 추적에서 사용하는 URL 형식을 지원하지 않으며 사용자가 이러한 링크 중 하나를 통해 스토어를 방문하려고 할 때 오류가 발생하므로 이메일의 링크가 Volusion 스토어로 올바르게 연결되도록 하려면 Klaviyo에서 이 기능을 비활성화해야 합니다.
계정 이름 > 설정 > 이메일 > 어트리뷰션 아래의 계정 설정에서 이 추적을 사용 중지할 수 있습니다.
이 기능을 비활성화하면 웹사이트의 새 프로필을 클릭한 이메일을 통해 추적할 수 있는 기능만 손실됩니다. 웹사이트에 클라비요 현장 추적 분석 기능이 있는 한(다음 섹션에서 추가할 예정임), 스토어에서 구매하거나 이메일 목록에 가입할 때 이메일 주소를 받으면 바로 사용자를 추적할 수 있습니다.

Volusion 스토어에 현장 추적 추가

클라비요는 고객에 대한 귀중한 정보를 수집하는 데 도움이 되는 두 가지 현장 추적 스니펫을 제공합니다:

사이트에서 활성화됨
이 스니펫은 고객이 사이트를 방문하는 시점을 추적합니다. 조회한 제품 등의 다른 스니펫이 작동하려면 이 스니펫을 사이트에 추가해야 합니다.
조회한 제품
이 스니펫은 고객이 특정 제품을 조회하는 시점을 추적합니다. 스토어에 조회된 제품 코드 스니펫을 추가하여 이 이벤트를 추적할 수 있습니다.

사이트 내 활성 추적 추가

웹사이트의 모든 페이지에 표시되도록 다음 Klaviyo.js 스니펫을 추가합니다. 이렇게 하면 사이트 내 추적 및 클라비요 양식을 활성화할 수 있습니다. PUBLIC_API_KEY를 클라비요 공개 API 키로 바꿔야 합니다.

<스크립트 유형="application/javascript" async="" src="https://static.klaviyo.com/onsite/js/PUBLIC_API_KEY/klaviyo.js"></script>
<script type="text/javascript"> //페이지 로드 시 Klaviyo 객체를 초기화하는 스크립트 !function(){if(!window.Klaviyo){wow._klOnsite=wow._klOnsite||[];try{wow.Klaviyo=새로운 프록시({},{get:function(n,i){return"푸시"===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=새 Promise((function(n){window._klOnsite.푸시([i].concat(o,[function(i){t&&t(i),n(i)}]))});return e}}})}catch(n){window.Klaviyo=window.Klaviyo[],window.Klaviyo.푸시=function(){var n;(n=window._klOnsite).푸시.적용(n,인수)}}}}(); </script>

조회한 제품 추적 추가

조회한 제품 추적을 사용하도록 설정하려면 디자인 > 파일 편집기를 클릭하여 찾을 수 있는 Volusion의 파일 편집기에서 스토어의 템플릿 페이지에 아래 코드 스니펫을 추가해야 합니다.

<스크립트 유형="텍스트/자바스크립트">
// 코드를 실행하기 전에 고객이 제품 페이지에 있는지 확인합니다.
    if ($("meta[속성='og:type']").attr("content") == "product") {
        var klaviyo = window.klaviyo || [];
        // 상품 조회 시간 추적 함수
        var trackViewedProduct = function(item) {
            klaviyo.track("조회됨 제품", 항목);
            klaviyo.trackViewedItem({
                "제목": item.ProductName,
               "ItemId": item.ProductID,
               "ImageUrl": item.ImageURL,
               "Url": item.URL,
               "메타데이터": {
                    "Price": item.Price,
                    "Description": item.Description,
                    "CompareAtPrice": item.CompareAtPrice,
                    "YouSave": item.YouSave
                }
            });
        };
        var item = {}
        .get(`/ProductDetails.asp?ProductCode=${global_Current_ProductCode}`, function(data) {}
            var product_saleprice = $("table.colors_pricebox div.product_saleprice").length ?
                숫자(`${$("table.colors_pricebox div.product_saleprice").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_saleprice").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : null;
            var product_listprice = $("table.colors_pricebox div.product_listprice").length ?
                Number(`${$("table.colors_pricebox div.product_listprice").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_listprice").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : null;
            var product_productprice = $("table.colors_pricebox div.product_productprice").length ?
                Number(`${$("table.colors_pricebox div.product_productprice").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_productprice").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : null;
            var product_yousave = $("table.colors_pricebox div.product_yousave").length ?
                Number(`${$("table.colors_pricebox div.product_yousave").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_yousave").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : 0;
            item = {
                "ProductName": $("meta[property='og:title']").attr("content"),
                "ProductID": global_Current_ProductCode,
                "Description": $("meta[property='og:description']").attr("content"),
                "ImageURL": $("meta[property='og:image']").attr("content"),
                "URL": $("meta[property='og:url']").attr("content"),
                "Price": product_saleprice ? product_saleprice : product_productprice,
                "CompareAtPrice": product_listprice ? product_listprice : product_productprice,
                "YouSave": product_yousave
            };
            trackViewedProduct(item);
        });
    } 
</script>

버려진 장바구니 알림 추가

Volusion은 통합을 통해 버려진 카트를 추적하는 즉시 사용 가능한 방법을 제공하지는 않지만, Klaviyo에서 이 기능을 사용할 수 있도록 Volusion 스토어에 추가할 수 있는 사용자 지정 스크립트를 만들었습니다. 상점 템플릿에 코드를 추가하는 데 약간의 지식이 필요하므로 개발자가 있는 경우 이 문서를 보내 코드 추가를 안내할 수 있습니다.

버려진 카트 기능은 한 페이지 결제 기능을 사용하는 Volusion 스토어와 사용자가 구매하기 전에 계정이 필요하지 않은 스토어에서만 작동합니다.

디자인 > 파일 편집기를 클릭하여 찾을 수 있는 Volusion의 파일 편집기에서 스토어의 템플릿 페이지에 아래 코드 조각을 추가해야 합니다.

<스크립트 유형="텍스트/자바스크립트">
    // 코드를 실행하기 전에 고객이 결제 페이지에 있는지 확인합니다.
    if (window.location.pathname == "/one-page-checkout.asp") {
        var klaviyo = window.klaviyo || [];
        // 결제 시작 시점을 추적하는 함수입니다.
        var trackStartedCheckout = function() {
            $.post('/AjaxCart.asp', 함수(데이터) {
                if (!데이터 || !데이터.제품 || !데이터.제품.길이) {
                    return;
                }
                var items = [],
                    names = [],
                    skus = [];
                // 각 상품과 해당 SKU/이름/수량/가격/총 가격/이미지 URL 가져옵니다.
                .each(data.Products, function(i, record) {
                    var item_price = +(record.ProductPrice.replace(/[\$,]+/g, '')) / record.Quantity;
                    items.push({
                        SKU: record.ProductCode,
                        Name: record.ProductName,
                        Quantity: +record.Quantity,
                        ItemPrice: item_price,
                        RowTotal: item_price * record.Quantity,
                        ImageURL: record.ImageSource
                    });
                    names.push(record.ProductName);
                    skus.push(record.ProductCode);
                });
                // 고객 데이터와 함께 결제 시작 메트릭을 클라비요에 푸시합니다.
                klaviyo.track("시작됨 체크아웃", {
                    $value: +(data.Totals[0].CartTotal.replace(/[\$,]+/g, "")),
                    Items: items,
                    ProductNames: names,
                    SKUs: skus
                });
            }, 'json');
        };
        $(function() {
            // 이메일 양식을 가져와서 고객 이메일을 받고 클라비요에서 해당 이메일에 이벤트를 연결합니다.
            $('[name="OnePageCheckoutForm"] [name="Email"]').change(function(e) {
                var email = $(this).val();
                // 가벼운 유효성 검사를 수행합니다. 클라비요는 데이터가 수신되면 더 많은 유효성 검사를 수행합니다.
                if (이메일 && /@/.test(이메일)) {
                    klaviyo.identify({
                        $email: email
                    });
                    트랙스타트 체크아웃();
                }
            });
        });
} 
</script>

이 코드는 앞으로의 결제 이벤트만 추적할 수 있으며, 중단된 카트 플로우를 클라비요 내에서 다시 채울 수는 없습니다.
이 코드를 스토어에 저장하면 클라비요는 중단된 카트 흐름을 트리거할 수 있는 결제 시작 메트릭을 자동으로 추적하기 시작합니다.

클라비요 동기화 모니터링

Volusion, Klaviyo 과 통합되면 데이터를 동기화할 시간이 필요합니다. 연동 탭으로 돌아가서 Volusion 활성화 연동 목록에서 연동을 찾으면 이 동기화 상태를 확인할 수 있습니다.
회색 윤곽선이 있으면 통합이 아직 동기화 중이라는 뜻입니다. 스토어 규모가 클수록 동기화 시간이 더 오래 걸릴 수 있습니다. 통합이 녹색 테두리로 표시되면 준비가 완료된 것입니다.
클라비요는 처음 통합을 활성화할 때 모든 과거 Volusion 데이터를 가져옵니다. 이를 확인하기 위해 특정 날짜의 주문 수를 Volusion 인터페이스의 주문 수와 비교하여 일치하는지 확인할 수 있습니다. 예를 들어, 주문 처리됨 메트릭(클라비요의 분석 > 메트릭 아래)을 탐색할 때 어제 데이터 포인트에 마우스를 올리거나 차트 아래의 데이터 표를 확인하여 어제 보고된 주문 수를 확인할 수 있습니다.
이 숫자를 어제 Volusion에 저장된 숫자와 비교하면 정확히 일치하는 것을 확인할 수 있습니다. 그렇지 않다면 클라비요 계정의 시간대가 볼루전 시간대와 일치하지 않는 문제일 가능성이 높습니다.
계정의 표준 시간대를 확인하거나 업데이트하려면 다음과 같이 하세요:
- 왼쪽 하단에서 계정 이름을 클릭합니다.
- 설정을클릭한 다음 > 조직을 선택합니다.
- 시간대까지 아래로 스크롤합니다.

Volusion에서 동기화된 데이터

애널리틱스 > 메트릭으로 이동하여 계정의 모든 메트릭을 찾습니다. 볼루션 아이콘이 있는 지표는 볼루션 연동에서 동기화됩니다. Volusion의 지표 및 프로필 속성은 누군가가 주문한 후 1시간 이내에 동기화됩니다.
주문 및 주문 제품 메트릭을 보여주는 Volusion으로 필터링된 클라비요의 메트릭 탭

주문하기

이 이벤트는 고객이 결제 프로세스를 완료하고 Volusion 스토어에서 주문을 생성할 때 추적됩니다. 주문 완료 이벤트에는 제품 이름, 제품 코드, 이미지, 가격 정보 등 구매자가 구매한 품목에 대한 모든 관련 정보가 포함되어 있으므로 구매 후속 이메일에서 해당 정보를 사용할 수 있습니다.

주문한 제품

이 이벤트는 고객이 주문할 때도 추적되지만 주문의 각 품목에 대해 하나의 이벤트가 추적됩니다. 예를 들어, 티셔츠와 바지를 구매하는 경우 하나의 주문 이벤트가 추적되고 두 개의 주문 제품 이벤트(티셔츠에 대한 이벤트와 바지에 대한 이벤트)가 추적됩니다.

주문한 제품 이벤트에는 구매한 각 제품에 대한 자세한 정보가 포함되어 있습니다. 이는 주문 완료 이벤트에서 사용할 수 없는 제품 이형 상품 옵션 및 기타 세부 정보를 기반으로 행동 세그먼트를 생성할 때 유용합니다. 다음 기준에 따라 주문한 제품 이벤트를 필터링하고 타겟팅할 수 있습니다:

이름
Volusion에서 제품의 이름 또는 제목(예: 티셔츠).
제품 코드
Volusion 내 제품의 제품 코드입니다.
수량
주문에서 구매한 품목의 수량입니다.

Volusion에서 동기화된 고객 데이터

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

이메일
이름
성
도시
주/지역
우편 번호
국가
전화번호
출처(클라비요는 프로필의 출처 속성이 "Volusion" 으로 설정된 Volusion의 고객을 추적합니다.)

문제 해결

클라비요에서 볼루션 주문 데이터가 보고되지 않습니다.

데이터 내보내기를 허용하는 Volusion API 설정에 문제가 있을 수 있습니다.

이 문제를 해결하려면 Volusion 관리자 패널의 인벤토리 탭으로 이동하세요. 드롭다운 메뉴에서 가져오기/내보내기를 선택합니다.
Volusion API를 클릭하여 기본 API 페이지에 액세스합니다.
일반 섹션에는 스토어의 일반/주문 내보내기 실행 옵션이 있습니다. 내보내기가 실행되면 페이지가 새로 고쳐집니다.
$일반\주문용 실행을 마우스로 클릭하여 Volusion에서 페이지 가져오기/내보내기하기$
라는 열의 확인란을 클릭하여 모든 열을 선택하고 실행을 클릭합니다.
$Volusion API: 별표 열이 선택된 상태에서 일반\주문 페이지 실행$
실행을 클릭하여 일반 주문을 내보내면 페이지 상단에 API URL이 생성됩니다. 예를 들어, URL은 다음과 같이 표시됩니다: https://storename.com/net/WebService.aspx?Login=user@storename.com&EncryptedPassword=ABCDEFGHIJKLMNOPQRSTUVWXYZ123456789& EDI_Name=GenericOrder.
$페이지의 링크 내에 강조 표시된 API 키 Volusion API: 일반\주문 실행$
위의 스크린샷에서 강조 표시된 "EncryptedPassword=" 및 "& EDI_Name=GenericOrders" 사이에 표시되는 값이 API 키 역할을 합니다. 이를 사용하여 클라비요 대시보드의 연동 탭에서 연동 설정을 다시 설정할 수 있습니다.
완료되면 애널리틱스 > 메트릭을 클릭하여 테스트합니다. 클라비요에서 새로운 데이터가 동기화되었는지 확인하기 위해 Volusion Placed Order 메트릭의 최근 활동을 확인합니다. 주문 처리됨 메트릭에 대한 새 데이터가 표시되면 지원팀에 문의하여 클라비요에서 누락된 주문에 대한 갭 채우기를 실행하거나 추가 지원이 필요한 경우 도움을 요청하세요.
Volusion API를 사용하여 데이터를 내보내는 방법에 대한 자세한 내용은 Volusion 지원을 참조하세요.

사람들이 내 이메일 링크를 클릭하면 "잘못된 입력" 오류가 표시됩니다.

클라비요의 "이메일에서 웹 추적" 기능은 클릭 추적을 사용하여 클라비요 이메일을 통해 웹사이트에 도착한 사용자를 원래 식별하기 전(예: 구매 또는 이메일 목록에 가입한 경우)에 활동을 연결합니다.

Volusion은 클릭 추적에서 사용하는 URL 형식을 지원하지 않으며 사용자가 이러한 링크 중 하나를 통해 스토어를 방문하려고 할 때 오류가 발생하므로 이메일의 링크가 Volusion 스토어로 올바르게 연결되도록 하려면 Klaviyo에서 이 기능을 비활성화해야 합니다.

이 문제를 해결하려면 이 글의 시작 부분에 설명된 대로 클라비요에서 이메일에서 웹으로의 추적을 비활성화하세요.

Volusion에서 영구 API 키를 만드는 방법

일반적으로 볼루전은 계정에서 비밀번호를 재설정할 때 90일마다 API 키를 재설정해야 하므로 클라비요에서 볼루전 연동 기능을 다시 구성해야 합니다. 다음 단계에서는 로그인한 적이 없는 관리자 계정에 대한 API 자격 증명을 생성하는 대신 만료되지 않는 API 키를 만들 수 있습니다:

Volusion 관리자 패널에서 고객 > 관리자로 이동하여 새 관리자 계정을 생성합니다.
인벤토리 > 가져오기/내보내기로 이동하여 Volusion API 탭을 선택합니다.
일반 섹션에서 Volusion API 통합 도움말 링크를 클릭합니다.
내보내기를 선택하고 드롭다운에서 생성한 새 관리자를 선택합니다.
"URL을 쿼리 문자열로..." 상자를 확장하여 영구 URL, 로그인 및 암호화된 비밀번호(API 키)를 찾습니다.

이 계정으로 로그인하지 마세요. 이 계정은 API 액세스에만 사용됩니다. 이 계정으로 로그인하면 90일 후에 비밀번호가 만료되며, 새로운 영구 API 키를 생성하려면 이 단계를 다시 수행해야 합니다.

결과

이제 클라비요와 Volusion을 통합하고, 현장 추적을 추가하고, 동기화된 데이터를 검토하고, 영구 API 키를 만드는 방법을 배웠습니다.

추가 리소스

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