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가 수익 계산에서 취소 및 환불된 주문을 차감하지 않기 때문이에요.
추가 자료
- Magento 2.x(CE 및 EE) 시작하기
Klaviyo를 Magento 2 CE 또는 EE 스토어와 연동하는 방법을 알아보세요. Magento에서 Klaviyo 확장 프로그램을 설치하고, 확장 프로그램을 구성하고, OAuth를 설정한 다음, Klaviyo에서 연동을 활성화해야 합니다. 이 가이드에서는 모든 필수 연동 단계와 과거 데이터 동기화 성공을 확인하는 방법에 대해 설명합니다.
- Magento 2 연동 문제 해결하기
아래에 설명된 문제 해결 단계를 따라 Magento 2 OAuth 설정 문제를 해결하는 방법을 알아보세요. 이 단계를 진행한 후에도 문제가 계속되면 커뮤니티 또는 지원 팀에 문의해 주세요.