Magento 2 데이터 참조
두 플랫폼을 연동할 때 Klaviyo가 Magento 2 스토어에서 어떤 데이터를 가져오는지 알아보세요. 초기 과거 동기화를 통해 최대 5년치 주문 및 고객 데이터를 가져오며, 과거에 생성되고 처리 완료된 주문과 관련된 정보도 포함돼요. 활성화하면 연동이 30분마다 주문 및 고객 데이터도 동기화해요.
Klaviyo에서 왼쪽 사이드바의 Analytics > 지표로 이동해 계정에 있는 모든 지표를 확인할 수 있어요. Magento 2 아이콘이 있는 지표는 Magento 2 연동에서 동기화된 이벤트예요. 또한 기어 아이콘이 있는 Klaviyo 온사이트 트래킹 이벤트도 표시되는데, 이는 연동을 통해서도 트래킹돼요.


Klaviyo가 Magento 2 지표를 결정하는 방법
주문 지표
Klaviyo는 동기화한 각 주문에 대해 Placed Order 이벤트를 기록해요. 또한 Magento 2의 주문 현재 상태와 상태 기록을 사용해 추가 주문 지표를 기록해요.
주문이 생성되거나 업데이트되면 Klaviyo에서 현재 상태와 상태 기록을 확인해요. 아래 표에는 표준 매핑이 표시되어 있습니다. pending_payment 또는 무시하도록 구성된 사용자 지정 상태의 주문은 제외됩니다.
Magento 주문 상태 | Klaviyo에서 트리거된 지표 |
완료 | 주문 완료 및 주문 처리 완료 |
취소됨, 취소됨 | 주문 완료 및 주문 취소 |
pay_aborted | 주문 완료 및 결제 취소 |
종료됨 | 주문 완료 및 환불 완료 |
무시된 상태를 제외한 다른 모든 주문 상태 | '완료된 주문' |
Placed Order 지표를 트리거하면 안 되는 사용자 지정 주문 상태가 있거나 위 표와 일치하지 않는 경우, 사용자 지정 상태를 무시하도록 설정하거나 추가 주문 이벤트에 매핑할 수 있도록 알려 주세요.
상태가 “pending_payment”인 주문은 무시돼요.
결제 시작 지표
표준 Magento 결제에서는 고객이 Magento 결제 프로세스의 첫 페이지에서 연락처 및 배송 정보를 입력하고 계속을 클릭하면 이 이벤트가 트리거돼요.
Started Checkout 이벤트는 이메일 주소가 연결된 장바구니(Magento에서는 견적[quote]이라고 함)를 기반으로 해요. Klaviyo는 동기화가 실행될 때 장바구니가 아직 활성 상태이고 항목이 들어 있는 경우에만 이를 동기화해요.
장바구니가 동기화되기 전에 고객이 주문을 완료하면 장바구니는 더 이상 활성 상태가 아니며, Klaviyo에서 이를 건너뛰어요. Placed Order 이벤트는 상태가 무시되지 않는 한, 주문이 동기화될 때 기록돼요. 이미 동기화된 Started Checkout 이벤트는 Klaviyo에 그대로 유지돼요. Started Checkout 이벤트가 Klaviyo에 동기화되는 데 최대 1시간이 걸릴 수 있다는 점에 유의해 주세요.
처리된 배송 지표
이 지표는 Magento 2 스토어에서 새 배송 건이 생성될 때 트리거돼요.
Magento 2 지표 데이터
이 섹션에서는 Magento 2 지표와 세그먼트 및 플로우를 만들 때 필터링에 사용할 수 있는 데이터를 다룹니다.
'취소된 주문'
이 이벤트는 Magento 2 스토어에서 주문 상태가 canceled 또는 canceled으로 변경될 때 트리거돼요.
- ProductCategories
취소된 주문에 포함된 제품의 카테고리입니다. - 값
취소된 주문의 값입니다. - 할인됨
(True 또는 False) 취소된 주문의 할인 상태입니다. - 제품명
취소된 주문에 포함된 제품의 이름입니다. - ItemCount
주문에 포함된 라인 아이템 수이며, 총 수량(단위 기준)은 아니에요. - OrderCurrencyCode
취소된 주문에 사용된 통화 코드입니다. - CartPriceRuleIDs
자동으로 적용된 규칙과 적용된 쿠폰의 규칙을 포함하는 Cart Price Rule ID(숫자 ID 문자열) 배열이에요. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
'처리된 주문'
이 이벤트는 Magento 2 스토어에서 주문 상태를 완료로 설정할 때 추적됩니다.
- ProductCategories
주문에 포함된 제품의 카테고리입니다. - 값
주문의 값입니다. - 할인됨
주문이 할인되었는지 여부입니다. - 제품명
주문에 포함된 제품의 이름입니다. - ItemCount
주문에 포함된 라인 아이템 수이며, 총 수량(단위 기준)은 아니에요. - OrderCurrencyCode
주문에 사용되는 통화 코드예요. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
'처리된 배송'
이 이벤트는 Magento 2 스토어에서 새 Shipment이 생성될 때 추적됩니다.
- StoreName
주문이 접수된 스토어의 이름입니다. - StoreID
주문이 접수된 스토어의 ID입니다. - BillingAddress
주문의 청구지 주소입니다. - 트래킹
배송 트래킹에 관한 정보입니다. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
'주문한 제품'
Klaviyo는 주문된 단위당 Ordered Product 이벤트를 1개 기록하며, 라인 아이템당 최대 100개 이벤트까지 기록해요. 예를 들어, 같은 티셔츠 3개를 주문하면 Ordered Product 이벤트가 3개 생성되고, 각 이벤트의 수량은 1이에요. 분수 단위로 판매되는 제품의 경우, Klaviyo는 주문 수량이 포함된 이벤트 1개를 기록해요.
- SKU
제품의 SKU입니다. - OrderCurrencyCode
제품의 통화 코드예요. - 가격
제품의 값입니다. - 카테고리
제품의 카테고리예요. - 할인됨
(True 또는 False) 제품에 할인이 적용되었는지 여부예요. - 수량
이 이벤트로 표시되는 수량입니다. 정수 단위로 구매한 경우에는 1이고, 분수 단위로 판매되는 제품의 경우에는 주문된 수량입니다. - 값
제품의 값입니다. - ProductID
제품의 ID입니다. - RootProductID
상위 제품의 ID입니다. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
Ordered Product 지표에는 트래킹에 사용할 수 있는 다른 데이터 필드도 많이 있어요. 이 이벤트에 사용할 수 있는 모든 데이터를 확인하려면 개별 Ordered Product 이벤트의 원시 데이터 보기를 확인하세요.
'완료된 주문'
사용자가 주문을 완료하면 이 이벤트가 트래킹됩니다.
- ProductCategories
주문에 포함된 제품의 카테고리입니다. - 값
주문의 값입니다. - 할인됨
주문이 할인되었는지 여부입니다. - 제품명
주문에 포함된 제품의 이름입니다. - ItemCount
주문에 포함된 라인 아이템 수이며, 총 수량(단위 기준)은 아니에요. - OrderCurrencyCode
주문에 사용되는 통화 코드예요. - CartPriceRuleIDs
자동으로 적용된 규칙과 적용된 쿠폰의 규칙을 포함하는 Cart Price Rule ID(숫자 ID 문자열) 배열이에요. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
'환불된 주문'
이 이벤트는 Magento 2에서 주문 상태가 종료됨(Closed)으로 변경될 때 트리거돼요. 주문이 다른 상태로 남는 부분 환불은 표준 상태 매핑을 통해서는 ‘환불된 주문(Refunded Order)’을 트리거하지 않아요.
- 값
주문의 값입니다. - 할인됨
주문이 할인되었는지 여부입니다. - ProductNames
주문에 포함된 모든 제품의 이름이에요. - ItemCount
주문에 포함된 라인 아이템 수이며, 총 수량(단위 기준)은 아니에요. - OrderCurrencyCode
주문에 사용되는 통화 코드예요. - ProductCategories
주문에 포함된 제품의 카테고리입니다. - CartPriceRuleIDs
자동으로 적용된 규칙과 적용된 쿠폰의 규칙을 포함하는 Cart Price Rule ID(숫자 ID 문자열) 배열이에요. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다.
결제 시작
알려진 이메일 주소가 있는 고객이 결제를 시작하고, Klaviyo가 이를 동기화할 때 장바구니에 상품이 남아 있으며 계속 활성 상태인 경우 이 이벤트가 트리거돼요. 표준 결제 페이지에서 고객은 연락처 및 배송 정보를 입력하고 계속을 클릭해요. 장바구니가 동기화되기 전에 결제를 완료하면 상태가 무시되지 않는 한, Klaviyo는 Started Checkout을 건너뛰고 주문이 동기화될 때 Placed Order를 기록해요. 주문을 완료해도 이미 동기화된 Started Checkout 이벤트는 제거되지 않아요.
- 값
결제 과정에서 주문 금액입니다. - 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)입니다.
Added To Cart 이벤트의 MaskedQuoteId 값을 사용해, 고객이 다른 기기에서 이메일을 통해 다시 방문할 때 장바구니를 다시 구성하는 링크를 만드세요. 다음 URL을 사용하세요:
{{ organization.url|trim_slash }}/reclaim/checkout/cart?quote_id={{ event.MaskedQuoteId }}조회한 제품
이 지표는 Klaviyo에서 사이트에서 고객이 제품을 조회한 것을 식별할 수 있을 때 추적됩니다. 다음 기준에 따라 조회한 제품 지표를 필터링하고 타기팅할 수 있습니다:
- ProductID
제품의 ID입니다. - Name
제품 이름입니다. - SKU
제품의 SKU입니다. - URL
제품의 URL입니다. - 가격
제품의 가격입니다. - FinalPrice
할인이 적용된 후의 최종 가격입니다. - 카테고리
제품이 속한 카테고리가 포함된 배열입니다. - ImageURL
제품 이미지의 URL이에요. - 외부 카탈로그 ID
Klaviyo에서 카탈로그 조직화에 사용됩니다. - integration_key
전자상거래 플랫폼(Magento 2)입니다.
'사이트 내 활성 상태'
이 지표는 Klaviyo에서 식별할 수 있는 고객이 사이트에서 활성 상태일 때 추적돼요. 세그먼트와 플로우에서 활성 on Site 활동을 사용할 수 있지만, 아래 이벤트 속성은 세그먼트 또는 플로우 필터에서 사용할 수 없어요. 이벤트의 원시 데이터에서 확인할 수 있어요:
- utm_medium
UTM 추적 매개변수의 매체(예: campaign)입니다. - kx_present
URL에 kx parameter가 있으면 True예요. 매개변수가 없으면 이 필드는 생략돼요. - os
사용자 디바이스의 운영 체제입니다. - initial_page_path
사용자가 처음 도착한 페이지의 URL 경로입니다. - browser
사용자의 브라우저 유형이에요. - 페이지
사용자가 활성 상태였던 페이지의 URL입니다. - utm_campaign
캠페인의 UTM 추적 매개변수입니다. - utm_source
UTM 소스(예: Klaviyo).
동기화된 고객 데이터
Klaviyo는 동기화된 주문, 고객 기록, 시작된 결제를 기반으로 프로필을 생성하거나 업데이트해요. 다음 정보는 소스 데이터에서 사용할 수 있는 경우 추가돼요:
- 이메일
- 이름 및 성
- 도시, 주/지역, 우편번호, 국가
- 전화번호
- Magento 계정 생성됨(예: YYYY-mm-dd hh:mm:ss, 2015. 5. 21. 13:04:00)
- Magento 고객 그룹(예: 도매)
- Magento 스토어(예: 미국 스토어)
- 생년월일(예: YYYY-mm-dd, 1990-03-25)
- 성별
Magento 2에서 고객 그룹을 업데이트하면 Klaviyo에서 원래 프로필이 생성된 이후라도 Klaviyo의 고객 그룹이 업데이트돼요.
MagentoWebsiteID는 고객 또는 주문에 연결된 Magento 스토어가 있을 때 동기화돼요. 억제는 Klaviyo로 복사되지 않아요.
Klaviyo는 다른 기본 URL에서 호스팅되는 제품 이미지에 대해 맞춤 미디어 루트 URL을 지원해요. 구성 안내는 Magento 2 설정 가이드를 참고해 주세요.
수익 값
Magento 2의 Placed Order 지표를 사용해 매출을 측정할 때, 취소 및 환불된 주문은 자동으로 차감되지 않아요. 이로 인해 Klaviyo에 표시되는 매출이 Magento에 표시되는 매출과 다를 수 있어요.
추가 자료
- Magento 2.x(CE 및 EE) 시작하기
Klaviyo를 Magento 2 CE 또는 EE 스토어와 연동하는 방법을 알아보세요. Magento에서 Klaviyo 확장 프로그램을 설치하고, 확장 프로그램을 구성하고, OAuth를 설정한 다음, Klaviyo에서 연동을 활성화해야 합니다. 이 가이드에서는 모든 필수 연동 단계와 과거 데이터 동기화 성공을 확인하는 방법에 대해 설명합니다.
- Magento 2 연동 문제 해결하기
아래에 설명된 문제 해결 단계를 따라 Magento 2 OAuth 설정 문제를 해결하는 방법을 알아보세요. 이 단계를 진행한 후에도 문제가 계속되면 커뮤니티 또는 지원 팀에 문의해 주세요.