Magento 2 데이터 참조
두 플랫폼을 연동할 때 Klaviyo가 Magento 2 스토어에서 어떤 데이터를 가져오는지 알아보세요. Klaviyo와 Magento 2 연동은 초기 과거 동기화 시 Magento 2 스토어의 모든 과거 데이터를 가져옵니다. 연동을 활성화하면 30분마다 주문 및 고객 데이터 동기화도 시작됩니다. 이 데이터의 예로는 과거에 주문한 주문, 처리 완료된 주문 등과 관련된 정보가 포함됩니다.
Klaviyo에서 왼쪽 사이드바의 계정 애널리틱스 탭으로 이동하면 계정의 모든 지표를 확인할 수 있어요. 지표 중 Magento 2 아이콘이 있는 항목은 Magento 2 연동에서 동기화된 주문 이벤트예요. 톱니바퀴 아이콘이 있는 Klaviyo 온사이트 트래킹 이벤트도 표시되며, 이는 연동을 통해서도 트래킹돼요.
Klaviyo가 Magento 2 지표를 결정하는 방법
주문 지표
Magento 2 주문 지표는 Magento 2 스토어의 주문에서 Status 필드에 의해 결정돼요.
주문이 생성되거나 상태가 업데이트될 때마다 아래 매트릭스를 기준으로 평가되어 어떤 이벤트를 트리거할지 결정돼요.
Magento 주문 상태 | Klaviyo에서 지표 트리거됨 |
완료 | '처리된 주문' |
취소됨, 취소됨 | '취소된 주문' |
pay_aborted | 결제 취소됨 |
종료됨 | '환불된 주문' |
기타 모든 주문 상태 | '완료된 주문' |
Placed Order 지표를 트리거하지 않아야 하는 맞춤 주문 상태가 있거나 위 표와 일치하지 않는 경우, 알려 주세요. 그러면 연동에서 주문 상태 매핑을 그에 맞게 조정해 드릴 수 있어요.
상태가 “pending_payment”인 주문은 무시돼요.
결제 시작 지표
표준 Magento 결제에서는 고객이 Magento 결제 프로세스의 첫 페이지에서 연락처 및 배송 정보를 입력하고 계속을 클릭하면 이 이벤트가 트리거돼요.
Started Checkout 이벤트는 “Quote”가 생성되고 여기에 이메일 주소가 연결되어 있어야 해요. 이는 고객이 결제의 “Shipping Information” 단계에서 이메일 주소를 입력한 후에 발생해요. 고객이 결제를 완료하지 않으면 이 Quote가 Started Checkout 이벤트로 Klaviyo에 동기화돼요.
고객이 주문을 완료하면 이 견적은 Magento 데이터베이스에서 “invoice”로 변환돼요. 그 결과 Started Checkout 이벤트가 Klaviyo로 전송되지 않아요. 대신 Placed Order 이벤트가 전송돼요. Started Checkout 이벤트가 Klaviyo와 동기화되는 데 최대 1시간이 걸릴 수 있다는 점에 유의하세요.
처리된 배송 지표
이 지표는 Magento 2 스토어에서 새 배송 건이 생성될 때 트리거돼요.
Magento 2 지표 데이터
이 섹션에서는 Magento 2 지표 각각과 세그먼트 및 플로우를 만들 때 필터링에 사용할 수 있는 데이터를 다뤄요.
'취소된 주문'
이 이벤트는 Magento 2 스토어에서 주문 상태가 canceled 또는 canceled으로 변경될 때 트리거돼요.
- ProductCategories
취소된 주문에 포함된 제품의 카테고리입니다. - 값
취소된 주문의 값입니다. - 할인됨
(True 또는 False) 취소된 주문의 할인 상태입니다. - OrderedProducts
취소된 주문에 포함된 제품 이름입니다. - OrderedProductCount
취소된 주문에 포함된 제품 수입니다. - OrderCurrencyCode
취소된 주문에 사용된 통화 코드입니다. - CartPriceRuleIDs
자동으로 적용된 규칙과 적용된 쿠폰의 규칙을 포함하는 Cart Price Rule ID(숫자 ID 문자열) 배열이에요. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
'처리된 주문'
이 이벤트는 Magento 2 스토어에서 주문 상태를 완료로 설정할 때 추적됩니다.
- ProductCategories
주문에 포함된 제품의 카테고리입니다. - 값
주문의 값입니다. - 할인됨
주문이 할인되었는지 여부입니다. - OrderedProducts
주문에 포함된 제품의 이름입니다. - OrderedProductCount
주문에 포함된 제품 수예요. - OrderCurrencyCode
주문에 사용되는 통화 코드예요. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
'처리된 배송'
이 이벤트는 Magento 2 스토어에서 새 Shipment이 생성될 때 추적됩니다.
- StoreName
주문이 접수된 스토어의 이름입니다. - StoreID
주문이 접수된 스토어의 ID입니다. - BillingAddress
주문의 청구지 주소입니다. - 트래킹
배송 트래킹에 관한 정보입니다. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
'주문한 제품'
이 이벤트는 사용자가 주문할 때 주문하는 모든 제품에 대해 한 번씩 추적돼요.
- SKU
제품의 SKU입니다. - OrderCurrencyCode
제품의 통화 코드예요. - 가격
제품의 값입니다. - 카테고리
제품의 카테고리예요. - 할인됨
제품에 적용된 모든 할인입니다. - 수량
제품 수입니다. - 값
제품의 값입니다. - ProductID
제품의 ID입니다. - RootProductID
상위 제품의 ID입니다. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
Ordered Product 지표에는 트래킹에 사용할 수 있는 다른 데이터 필드도 많이 있어요. 이 이벤트에 사용할 수 있는 모든 데이터를 확인하려면 개별 Ordered Product 이벤트의 원시 데이터 보기를 확인하세요.
'완료된 주문'
사용자가 주문을 완료하면 이 이벤트가 트래킹됩니다.
- ProductCategories
주문에 포함된 제품의 카테고리입니다. - 값
주문의 값입니다. - 할인됨
주문이 할인되었는지 여부입니다. - OrderedProducts
주문에 포함된 제품의 이름입니다. - OrderedProductCount
주문에 포함된 제품 수예요. - OrderCurrencyCode
주문에 사용되는 통화 코드예요. - CartPriceRuleIDs
자동으로 적용된 규칙과 적용된 쿠폰의 규칙을 포함하는 Cart Price Rule ID(숫자 ID 문자열) 배열이에요. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
'환불된 주문'
이 이벤트는 고객이 주문을 환불할 때 트리거돼요.
- 값
주문의 값입니다. - 할인됨
주문이 할인되었는지 여부입니다. - OrderedProducts
주문에 포함된 모든 제품의 이름이에요. - OrderedProductCount
주문에 포함된 제품 수예요. - OrderCurrencyCode
주문에 사용되는 통화 코드예요. - ProductCategories
주문에 포함된 제품의 카테고리입니다. - CartPriceRuleIDs
자동으로 적용된 규칙과 적용된 쿠폰의 규칙을 포함하는 Cart Price Rule ID(숫자 ID 문자열) 배열이에요. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
결제 시작
이 이벤트는 이메일 주소가 확인된 고객이 결제를 시작할 때 트리거돼요. 표준 결제 페이지에서는 고객이 Magento 결제 프로세스의 첫 페이지에서 연락처 및 배송 정보를 입력하고 계속을 클릭하면 이 이벤트가 트리거돼요. 사용자가 결제를 완료하면 결제 시작 이벤트는 Klaviyo로 전송되지 않아요. 대신 주문 완료 이벤트가 기록돼요.
- 값
결제 과정에서 주문 금액입니다. - ItemCount
주문에 포함된 품목 수입니다. - 항목
주문의 항목입니다. - ProductCategories
주문에 포함된 제품의 카테고리입니다. - 제품명
주문에 포함된 제품의 이름입니다. - StoreName
주문이 시작된 스토어의 이름이에요. - StoreID
주문이 시작된 스토어의 ID입니다. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
'장바구니에 추가'
참고: 이 지표는 Klaviyo 확장 프로그램 버전 4.0.0 이상을 사용 중인 경우에만 추적됩니다. 이 지표는 Klaviyo 쿠키가 설정된 고객이 장바구니에 품목을 추가할 때 추적됩니다.
추가된 항목에 대한 자세한 정보가 포함돼요. 사용자가 장바구니에 추가한 제품을 기준으로 세그먼트를 만들거나, 장바구니 이탈 플로우를 구축할 때 유용해요. 다음 기준에 따라 장바구니에 추가됨 지표를 필터링하고 타기팅할 수 있습니다:
- MaskedQuoteId
로그인한 고객의 MaskedQuoteId 또는 고유 식별자입니다. - AddedItemCategories
항목이 속한 카테고리입니다. - AddedItemProductName
스토어에 있는 제품의 이름입니다(예: Red T-shirt). - AddedItemDescription
아이템의 설명입니다. - AddedItemImageURLKey
항목 이미지의 URL이에요. - AddedItemPrice
항목의 가격이에요. - AddedItemProductID
Magento 2 스토어에서 제품에 대한 사용자 지정 ID(예: 1234)예요. - AddedItemSKU
스토어에 있는 항목의 SKU(예: REDMEDIUMTSHIRT)입니다. - AddedItemURL
항목의 URL입니다. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다. - integration_key
전자상거래 플랫폼(Magento 2)입니다.
Klaviyo는 장바구니 재구성 키라는 키를 생성해요. 이 키를 사용하면 다른 기기에서 이 이벤트로 트리거된 이메일을 통해 고객이 장바구니로 돌아올 경우 고객의 장바구니를 재구성하는 링크를 만들 수 있어요. 이 키는 ‘extra’ 속성 배열에서 찾을 수 있어요. 다음 URL을 사용해 이 링크를 만들 수 있어요:
{{ organization.url|trim_slash }}reclaim/checkout/cart?quote_id={{ event.MaskedQuoteId }} 조회한 제품
이 지표는 고객이 사이트에서 제품을 조회할 때 추적돼요. 다음 기준에 따라 조회된 제품 지표를 필터링하고 타기팅할 수 있어요:
- ProductID
제품의 ID입니다. - Name
제품 이름입니다. - SKU
제품의 SKU입니다. - URL
제품의 URL입니다. - 가격
제품의 가격입니다. - FinalPrice
할인이 적용된 후의 최종 가격입니다. - 카테고리
제품이 속한 카테고리가 포함된 배열입니다. - ImageURL
제품 이미지의 URL이에요. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다. - integration_key
전자상거래 플랫폼(Magento 2)입니다.
'사이트 내 활성 상태'
이 지표는 고객이 사이트에서 활성 상태일 때 추적됩니다. 다음 기준에 따라 사이트에서 활성 지표를 필터링하고 타기팅할 수 있어요:
- utm_medium
UTM 추적 매개변수의 매체(예: campaign)입니다. - kx_present
(True 또는 False) kx 매개변수가 있는지 여부예요. - os
사용자 디바이스의 운영 체제입니다. - initial_page_path
사용자가 처음 도착한 페이지의 URL 경로입니다. - browser
사용자의 브라우저 유형이에요. - 페이지
사용자가 활성 상태였던 페이지의 URL입니다. - utm_campaign
캠페인의 UTM 추적 매개변수입니다. - utm_source
UTM 소스(예: Klaviyo).
동기화된 고객 데이터
Klaviyo는 기존 주문 생성, 기존 고객 레코드 생성 또는 결제가 시작될 때 연락처를 생성해요. Klaviyo는 동기화된 각 연락처에 대해 새 Klaviyo 프로필을 만들고, 이 프로필에 다음 정보를 입력해요:
- 이메일
- 이름 및 성
- 도시, 주/지역, 우편번호, 국가
- 전화번호
- Magento 계정 생성(예: YYY-mm-dd hh:mm:ss, 2015-05-21 13:04:00)
- Magento 고객 그룹(예: 도매)
- Magento 스토어(예: 미국 스토어)
- 생년월일(예: YYYY-mm-dd, 1990-03-25)
- 성별
Magento 2에서 고객 그룹을 업데이트하면 Klaviyo에서 원래 프로필이 생성된 이후라도 Klaviyo의 고객 그룹이 업데이트돼요.
Website_ID는 가져오지 않아요. 억제는 Klaviyo로 복사되지 않으므로 Klaviyo 플랫폼에 표시되지 않아요.
Klaviyo에서는 사용자 지정 이미지 위치를 가져올 수 없어요.
수익 값
Klaviyo 대시보드의 수익 값이 Magento에서 확인하는 수익 값과 항상 일치하지 않을 수 있어요. 이는 Klaviyo가 수익 계산에서 취소 및 환불된 주문을 차감하지 않기 때문이에요.
추가 자료
- Getting started with Magento 2.x (CE and EE)
Learn how to integrate Klaviyo with your Magento 2 CE or EE store. You'll need to install the Klaviyo extension in Magento, configure the extension and set up OAuth, then enable the integration in Klaviyo. This guide covers all required integration steps, as well as how to confirm your historical data sync is successful.
- Troubleshooting your Magento 2 integration
Learn how to solve issues with your Magento 2 OAuth setup by following the troubleshooting steps described below. If you are still encountering issues after running through these steps, please reach out on our Community or to our Support Team.