Magento 1 데이터 참조

학습 내용

두 플랫폼을 연동할 때 Magento 1 데이터가 Klaviyo로 어떤 항목이 가져와지는지 알아보세요. Klaviyo의 Magento 연동은 초기 과거 동기화 시점에 Magento 스토어의 모든 과거 데이터를 가져옵니다. 활성화되면 연동이 거의 실시간으로 지표와 고객 데이터를 동기화하기 시작합니다. 이 데이터의 예로는 과거에 주문한 주문, 처리 완료된 주문 등과 관련된 정보가 포함됩니다.

Klaviyo에서 왼쪽 사이드바의 계정 분석 탭으로 이동해 계정의 모든 지표를 확인할 수 있어요. Magento 아이콘이 있는 지표는 Magento 연동에서 동기화된 지표예요.

Magento 지표

'취소된 주문'

이 이벤트는 고객이 Magento 스토어에서 주문을 생성했지만, 이행 전에 주문을 취소한 경우에 추적돼요. Klaviyo는 누군가가 구매한 품목의 모든 제품 정보를 포함해 관련 데이터를 추적해요. 제품 정보에는 제품 이름, 이미지, 그리고 구매 후속 이메일에서 사용할 수 있는 같은 이메일의 다른 버전 정보가 포함돼요.

다음 기준에 따라 주문 취소 이벤트를 필터링하고 타기팅할 수 있습니다:

• 값: 주문의 총액(소계+배송비-할인 금액).
• Items: 누군가의 주문에 포함된 제품의 이름입니다.
  예: 티셔츠 또는 바지. 여러 번 주문한 경우 동일한 항목이 여러 개 표시돼요.
• 항목 카테고리: 누군가의 주문에 포함된 항목의 전체 카테고리 집합(예: t-shirts, mens, pants, 세일)입니다.
• Item Count: 주문 내 품목 수(예: 2).
• 통화 코드: 국가에 따라 항목에 대해 결제된 특정 통화(예: USD, EUR).
• 할인 적용: 이 특정 항목에 할인이 적용되었는지 여부(예: true/false)입니다.
• 쿠폰: 적용된 쿠폰 코드입니다.
• 고유 항목: 주문에 포함된 개별 항목(예: 셔츠, 반바지). 여러 제품을 주문한 경우 고유 항목은 한 번만 표시돼요.
• 고유 상품 카테고리: 고유 상품이 그룹화되는 카테고리(예: 남성용, 세일).
• 속성(선택 사항): 사용자 지정 제품 속성.

'결제 완료됨'

이 이벤트는 Magento 스토어에서 고객이 결제를 완료할 때 추적돼요. Checkout Completed 이벤트는 과거 데이터가 동기화되지 않으므로, 시간 경과에 따른 총 이벤트를 볼 때 항상 정확한 측정값은 아니에요. 매출 트래킹과 세분화에는 Placed Order 이벤트를 사용해 주세요.

다음 기준에 따라 결제 완료 이벤트를 필터링하고 타기팅할 수 있어요.

• 값: 주문의 총액수입니다.
• 할인 코드: 적용된 모든 쿠폰 또는 할인 코드.
• Items: 누군가의 장바구니에 있는 제품 이름(예: t-shirt 또는 pants)입니다.
• 항목 수: 장바구니에 있는 항목의 총수.
• 총 할인(선택 사항): 쿠폰 또는 할인의 총 금액(달러)입니다.

시작된 결제

이 이벤트는 고객이 Magento 결제 프로세스의 첫 페이지에서 연락처 및 배송 정보를 입력한 다음 계속을 클릭할 때 추적돼요. Klaviyo는 누군가의 장바구니에 있는 항목에 대한 관련 제품 데이터(제품명, 이미지, 같은 이메일의 다른 버전 정보 등)를 추적하며, 이를 장바구니 이탈 이메일에 사용할 수 있어요. 이 이벤트에는 각 고객의 정확한 장바구니로 다시 연결되는 결제 URL 속성이 있으며, 고객이 새 기기에서 이메일을 열 때 장바구니를 다시 만들 때 사용할 수 있어요.

다음 기준에 따라 결제 시작 이벤트를 필터링하고 타기팅할 수 있어요.

• 값: 결제 시점의 장바구니 값(소계 + 배송비 - 모든 할인).
• Items: 누군가의 장바구니에 있는 제품 이름(예: t-shirt 또는 pants)입니다.
• 항목 수: 장바구니에 있는 항목의 총수.
• 할인 코드(선택 사항): 적용된 모든 쿠폰 또는 할인 코드예요.
• 총 할인(선택 사항): 쿠폰 또는 할인의 총 금액(달러)입니다.

'처리된 주문'

Magento 스토어에서 주문을 '배송됨'으로 표시할 때 이 이벤트가 추적돼요. Klaviyo는 누군가가 구매한 항목의 상품명, 이미지, 같은 이메일의 다른 버전 정보 등 관련 상품 정보를 추적하며, 이 정보는 구매 후 후속 이메일에 활용할 수 있어요.

다음 기준에 따라 처리 완료된 주문 이벤트를 필터링하고 타기팅할 수 있습니다.

• 값: 주문의 총액(소계+배송비-할인 금액).
• Items: 주문에 포함된 제품의 이름(예: 티셔츠 또는 바지). 여러 번 주문한 경우 동일한 항목이 여러 개 표시돼요.
• 항목 카테고리: 누군가의 주문에 포함된 항목의 전체 카테고리 집합(예: 티셔츠, 남성, 바지 및 세일)입니다.
• 품목 수: 주문에 포함된 품목 수입니다. (예: 2).
• 통화 코드: 국가에 따라 항목에 대해 결제되는 특정 통화(예: USD, EUR).
• 할인 적용: 이 특정 항목에 할인이 적용되었는지 여부(예: true/false)입니다.
• 쿠폰: 적용된 쿠폰 코드입니다.
• 고유 품목: 주문에서 생성된 개별 품목입니다(예: 셔츠, 반바지). 여러 제품을 주문한 경우 고유 품목은 한 번만 표시돼요.
• 고유 상품 카테고리: 고유 상품이 그룹화되는 카테고리(예: 남성용, 세일).
• 속성(선택 사항): 사용자 지정 제품 속성.

'주문한 제품'

이 이벤트는 고객이 주문할 때 추적됩니다. 누군가 구매하는 각 항목에 대해 Ordered Product 이벤트가 1개씩 추적됩니다. 예를 들어 누군가가 티셔츠와 바지를 구매하면 Placed Order 이벤트 1개가 추적되고 Ordered Product 이벤트 2개가 기록됩니다. 티셔츠에 대한 이벤트 1개와 바지에 대한 이벤트 1개가 기록돼요.

Ordered Product 이벤트에는 누군가가 구매한 각 제품에 대한 자세한 정보가 포함돼요. 이는 완료된 주문 이벤트에서 사용할 수 없는 제품 같은 이메일의 다른 버전 옵션 및 기타 세부 정보를 기반으로 행동 세그먼트를 생성할 때 유용합니다. 다음 기준에 따라 주문한 제품 이벤트를 필터링하고 타기팅할 수 있습니다.

• 값: 상품 총액(배송비 또는 적용된 할인은 포함되지 않음).
• 이름: 이 특정 항목에 지정된 이름이에요.
• SKU: 항목을 추적하기 위해 할당된 특정 SKU(예: REDMEDIUMTSHIRT).
• 카테고리: 누군가의 주문에 포함된 제품 컬렉션의 전체 집합(예: 티셔츠, 남성, 바지 및 세일).
• 가격: 특정 제품의 달러 가치(예: 셔츠 25.50, 신발 50.25).
• 비용: 제품을 만드는 데 드는 비용(예: 셔츠 13.85, 신발 20.00).
• 통화 코드: 국가를 기준으로 상품에 대해 결제된 특정 통화(예: USD, EUR).
• 할인 적용됨: 이 특정 항목에 할인이 적용되었는지 여부(예: true 또는 false).
• ProductID: 스토어에 있는 특정 제품의 ID.
• 수량: 주문한 수량입니다.
• 속성(선택 사항): 사용자 지정 제품 속성.

'완료된 주문'

이 이벤트는 고객이 결제 프로세스를 완료하고 Magento 스토어에서 주문을 생성할 때 추적돼요. Klaviyo는 구매한 항목의 제품명, 이미지, 같은 이메일의 다른 버전 정보 등 관련 데이터를 추적하며, 이를 구매 후 후속 이메일에 사용할 수 있어요. 다음 기준에 따라 주문 완료 이벤트를 필터링하고 타기팅할 수 있어요:

• Value: 주문의 총 가치(소계 + 배송비 - 모든 할인).
• Items: 누군가의 주문에 포함된 제품 이름(예: t-shirt 또는 pants)입니다. 여러 번 주문된 경우 동일한 품목이 여러 개 표시돼요.
• 항목 카테고리: 누군가의 주문에 포함된 항목의 전체 카테고리 집합(예: 티셔츠, 남성, 바지 및 세일).
• 품목 수: 주문에 포함된 품목 수(예: 2).
• 통화 코드: 국가를 기준으로 상품에 대해 결제된 특정 통화(예: USD, EUR).
• 할인 적용: 이 특정 항목에 할인이 적용되었는지 여부(예: true/false)입니다.
• 쿠폰: 적용된 쿠폰 코드입니다.
• 고유 항목: 주문에서 생성된 개별 항목(예: 셔츠, 반바지). 여러 제품을 주문한 경우 고유 항목은 한 번만 표시돼요.
• 고유 항목 카테고리: 고유 항목이 그룹화되는 카테고리(예: 남성, 세일).
• 속성(선택 사항): 최대 10개의 사용자 지정 제품 속성을 접수된 주문에 대해 동기화할 수 있어요. 이 동기화는 사용자 지정 속성 데이터가 Klaviyo 계정으로 들어오기 전에 활성화해야 해요. 설정 방법은 아래 섹션을 참고하세요.

'환불된 주문'

이 이벤트는 Magento에서 주문이 환불될 때 추적됩니다.

• Value: 주문의 총 가치(소계 + 배송비 - 모든 할인).
• 쿠폰: 적용된 쿠폰 코드입니다.
• 통화 코드: 국가를 기준으로 상품에 대해 결제된 특정 통화(예: USD, EUR).
• 할인됨: 이 특정 항목에 할인이 적용되었는지 여부(즉, true/false).
• 항목 카테고리: 누군가의 주문에 포함된 항목의 전체 카테고리 집합(예: 티셔츠, 남성, 바지 및 세일).
• 품목 수: 주문에 포함된 품목 수(예: 2).
• Items: 주문에 포함된 제품의 이름(예: 티셔츠 또는 바지). 여러 번 주문된 경우 동일한 품목이 여러 개 표시돼요.
• 고유한 항목 카테고리: 고유한 항목이 그룹화되는 카테고리(예: mens, sale).
• 고유 항목: 주문에서 생성된 개별 항목(예: 셔츠, 반바지)여러 제품을 주문한 경우에도 고유 항목은 한 번만 표시돼요.

매출 또는 주문 완료 값은 다음과 같이 계산돼요: (주문 가격+배송비-할인). $value를 기준으로 세그먼트를 필터링하려면 매출을 사용해 세그먼트를 필터링해 주세요.

결제는 extra 필드 아래의 2단계 속성으로 사용할 수 있어요. 세분화를 위해 2단계 속성으로 필터링할 수는 없지만, 이메일 템플릿에서 이 데이터를 이벤트 변수로 사용 할 수 있어요.

동기화된 고객 데이터

Klaviyo는 기존 주문 생성, 기존 고객 레코드 생성 또는 결제가 시작될 때 연락처를 생성해요. Klaviyo는 동기화된 각 연락처에 대해 새 Klaviyo 프로필을 만들고, 이 프로필에 다음 정보를 입력해요:

• 이메일
• 이름 및 성
• 도시, 주/지역, 우편번호, 국가
• 전화번호
• Magento 계정 생성됨(예: 2015-05-01 00:00:00)
• Magento 고객 그룹(예: 도매)
• Magento 스토어(예: 미국 스토어)
• 생년월일(예: 1990-01-01)
• 성별
• website_ID가 가져와지지 않아요
• 억제는 Klaviyo에 복사되지 않으므로 Klaviyo 플랫폼에 표시되지 않아요

Magento에서 고객 그룹을 업데이트하면 Klaviyo에서 원래 프로필이 이미 생성된 이후라도 고객 그룹이 Klaviyo에서 업데이트돼요.

주문 완료된 주문의 맞춤 제품 속성 동기화

Klaviyo는 Placed Order 지표에 대해 최대 10개의 맞춤 제품 속성을 동기화할 수 있어요. 맞춤 제품 속성은 Klaviyo로 자동으로 동기화되지 않지만, Klaviyo에서 해당 속성을 가져오도록 요청할 수 있어요. 이렇게 하려면 맞춤 속성 ID(아래 안내)를 수집한 다음 지원팀에 요청을 보내야 해요.

카탈로그 > 속성 > 속성 관리로 이동한 다음 속성을 클릭하여 Magento 관리자 패널에서 사용자 지정 제품 ID를 찾습니다.

ID는 다음과 같이 URL에서 찾을 수 있어요:

동기화된 주문 데이터를 확인해 주세요.

Klaviyo는 Magento 데이터를 모두 가져와요. 이를 확인하려면 특정 날짜의 주문 수를 Magento 인터페이스에 있는 수와 비교해 일치하는지 확인하면 돼요. 왼쪽 사이드바에서 분석을 클릭하고 Placed Order 지표를 찾은 다음 클릭하세요. 그러면 지표 차트 페이지로 이동하며 기본적으로 지난 30일 데이터가 표시돼요. 아래에 표시된 지표 차트 예시를 확인할 수 있어요.

어제 주문 수를 확인하려면 어제의 데이터 포인트에 마우스를 올리거나 차트 아래의 데이터 표를 확인해 주세요. 그 숫자를 Magento에 저장된 값과 비교하면 정확히 일치하는 것을 확인할 수 있어요. 일치하지 않는다면, 가장 가능성이 높은 원인은 Klaviyo 계정의 시간대가 Magento 시간대와 일치하지 않기 때문이에요. 시간대 설정을 확인하려면:

1. 왼쪽 하단에서 조직 이름을 클릭합니다.
2. 설정을 클릭합니다.
3. 조직.을 선택하세요.

Klaviyo 대시보드의 수익 값이 Magento에서 확인하는 수익 값과 항상 일치하지 않을 수 있어요. 이는 Klaviyo가 수익 계산에서 취소 및 환불된 주문을 차감하지 않기 때문이에요.

동기화된 Magento 주문의 속성

아래는 Magento SOAP API를 통해 동기화된 주문에 대해 저희가 저장하는 속성과 일치하는 Placed Order, Ordered Product, Fulfilled Order 지표의 예시 JSON 페이로드예요.

이는 Magento 주문 데이터와 결합될 주문에 대해 올바른 속성을 전송하는 데 유용해요.

'완료된 주문'

// 
// PLACED ORDER
// ------------------------------------------

{
  "token" : "PUBLIC_API_KEY",
  "service" : "magento",
  "event" : "Placed Order",
  "customer_properties" : {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties" : {
    "$event_id" : "1234",
    "$value" : 29.98,
    "$extra" : {},
    "Currency Code" : "USD",
    "Item Count" : 2,
    "Items" : ["Winnie the Pooh", "A Tale of Two Cities"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "Discounted" : true,
    "Coupon" : "COUPON123",
    "Unique Items" : ["Winnie the Pooh", "A Tale of Two Cities"],
    "Item Categories" : ["Fiction", "Classics", "Children"],
    "Unique Item Categories" : ["Fiction", "Classics", "Children"]
  },
  "time" : 1387302423
}

'주문한 제품'

// 
// ORDERED PRODUCT
// ------------------------------------------

{
  "token" : "PUBLIC_API_KEY",
  "service" : "magento",
  "event" : "Ordered Product",
  "customer_properties" : {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties" : {
    "$event_id" : "123456789", // LineId (unique)
    "$value" : 9.99,
    "Currency Code" : "USD",
    "Name" : "Winnie the Pooh",
    "SKU" : "WINNIEPOOH",
    "ProductID" : "567",
    "Categories" : ["Fiction", "Classics"],
    "Price" : 9.99,
    "Discounted" : true,
    "Cost" : 5.00, // (optional),
    "Attribute: Color" : "Red" // product attributes (optional)
    "$extra" : {
        "Product URL Key" : "winnie-pooh",
        "Product URL" : "https://www.store.com/winnie-pooh",
        "Image URL" : "https://cnd.store.com/images/winnie-pooh.png",
    }
  },
  "time" : 1387302423
}

'처리된 주문'

// 
// FULFILLED ORDER
// ------------------------------------------

{
  "token" : "PUBLIC_API_KEY",
  "service" : "magento",
  "event" : "Fulfilled Order",
  "customer_properties" : {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties" : {
    "$event_id" : "1234",
    "$value" : 29.98,
    "$extra" : {},
    "Currency Code" : "USD",
    "Item Count" : 2,
    "Items" : ["Winnie the Pooh", "A Tale of Two Cities"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "Discounted" : true,
    "Coupon" : "COUPON123",
    "Unique Items" : ["Winnie the Pooh", "A Tale of Two Cities"],
    "Item Categories" : ["Fiction", "Classics", "Children"],
    "Unique Item Categories" : ["Fiction", "Classics", "Children"]
  },
  "time" : 1387302423
}