Magento 1 데이터 참조

학습 내용

기존 Magento 1 연동이 Klaviyo로 동기화하는 데이터(과거 주문, 고객 기록, 제품 포함)를 확인해 보세요. 초기 과거 데이터 동기화가 완료된 후에는 주문, 고객, 제품이 30분마다 동기화됩니다.

Klaviyo에서 왼쪽 사이드바의 분석 > 지표로 이동해 계정의 지표를 확인해 보세요. Magento 아이콘이 있는 지표는 Magento 연동에서 동기화된 항목이에요.

Magento 지표

'취소된 주문'

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

이러한 이벤트에는 다음과 같은 주문 데이터가 포함됩니다. 최상위 속성을 사용해 이벤트를 필터링하고 타겟팅할 수 있고, extra 아래의 속성 세부 정보는 메시지 콘텐츠에 사용할 수 있어요.

• 값: 할인 적용 후 세금과 배송비를 포함한 Magento의 주문 총액이에요.
• 항목: 각 주문의 라인 아이템에 있는 제품명(예: 티셔츠 또는 바지). 별도의 라인 아이템에 표시되어 있으면 이름이 두 번 이상 나타날 수 있어요.
• Item Categories: 주문에 포함된 제품의 카테고리(예: 티셔츠, 남성, 바지 및 세일)입니다.
• 품목 수: 주문의 라인 아이템 수(예: 2)예요. 이는 주문된 수량의 합계가 아니에요.
• 통화 코드: 주문의 통화 코드(예: USD 또는 EUR)입니다.
• 할인 적용됨: 주문에 할인이 적용되었는지 여부(참 또는 거짓).
• 쿠폰: 적용된 쿠폰 코드입니다.
• 고유 항목: 중복을 제거한 주문 내 제품명(예: 셔츠 또는 반바지)입니다.
• 고유 품목 카테고리: 중복을 제거한 뒤 주문에 포함된 상품 카테고리를 순서대로 나열한 값(예: 남성, 세일)입니다.
• 속성(선택 사항): extra 아래의 항목 세부 정보에 있는 제품 속성입니다. Ordered Product 이벤트를 사용해 개별 제품 속성으로 필터링하세요.

'결제 완료됨'

이 이벤트는 고객이 Magento 스토어에서 결제를 완료할 때 추적됩니다. Checkout Completed 이벤트는 과거 데이터가 동기화되지 않으므로, 합계가 과거의 모든 결제를 반영하지 않을 수 있습니다. 수익 보고 및 세분화에는 Placed Order 이벤트를 사용하세요.

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

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

시작된 결제

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

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

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

'처리된 주문'

표준 Magento 주문 상태에서는 주문이 완료 상태에 도달하면 이 이벤트가 추적돼요. Klaviyo는 누군가 구매한 품목의 제품명, 이미지, 그리고 구매 후속 이메일에 사용할 수 있는 같은 이메일의 다른 버전 정보 등 관련 제품 정보를 추적해요.

이러한 이벤트에는 다음과 같은 주문 데이터가 포함됩니다. 최상위 속성을 사용해 이벤트를 필터링하고 타겟팅할 수 있고, extra 아래의 속성 세부 정보는 메시지 콘텐츠에 사용할 수 있어요.

• 값: 할인 적용 후 세금과 배송비를 포함한 Magento의 주문 총액이에요.
• 항목: 각 주문의 라인 아이템에 있는 제품명(예: 티셔츠 또는 바지). 별도의 라인 아이템에 표시되어 있으면 이름이 두 번 이상 나타날 수 있어요.
• Item Categories: 주문에 포함된 제품의 카테고리(예: 티셔츠, 남성, 바지 및 세일)입니다.
• 품목 수: 주문의 라인 아이템 수(예: 2)예요. 이는 주문된 수량의 합계가 아니에요.
• 통화 코드: 주문의 통화 코드(예: USD 또는 EUR)입니다.
• 할인 적용됨: 주문에 할인이 적용되었는지 여부(참 또는 거짓).
• 쿠폰: 적용된 쿠폰 코드입니다.
• 고유 항목: 중복을 제거한 주문 내 제품명(예: 셔츠 또는 반바지)입니다.
• 고유 품목 카테고리: 중복을 제거한 뒤 주문에 포함된 상품 카테고리를 순서대로 나열한 값(예: 남성, 세일)입니다.
• 속성(선택 사항): extra 아래의 항목 세부 정보에 있는 제품 속성입니다. Ordered Product 이벤트를 사용해 개별 제품 속성으로 필터링하세요.

'주문한 제품'

이 이벤트는 고객이 주문할 때 추적됩니다. 수량이 정수인 경우 구매한 각 단위마다 Ordered Product 이벤트 1개가 추적되며, 주문 라인 항목당 최대 100개의 이벤트까지 추적됩니다. 예를 들어 누군가 티셔츠 1장과 바지 1벌을 구매하면 Placed Order 이벤트 1개와 Ordered Product 이벤트 2개가 기록됩니다. 티셔츠에 1개, 바지에 1개입니다. 소수 수량으로 판매되는 제품의 경우 Klaviyo는 해당 라인 항목에 대해 이벤트 1개를 기록하고, 구매한 수량을 포함합니다.

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

• 값: 할인 전 기준으로 이 이벤트가 나타내는 값이며, 배송비는 제외돼요. 수량이 정수인 경우, 주문 라인의 총액을 해당 수량으로 나눈 값이에요. 수량이 소수인 경우, 라인 총액 전체예요.
• 이름: 이 특정 항목에 지정된 이름이에요.
• SKU: 항목에 할당된 SKU(예: REDMEDIUMTSHIRT)입니다.
• Categories: 이 제품의 카테고리(예: 티셔츠, 남성, 바지, 세일)입니다.
• 가격: 주문 통화 기준으로 주문에 포함된 제품의 단가(예: 셔츠 25.50 또는 신발 50.25)입니다.
• 비용(선택 사항): 사용 가능한 경우 Magento에 기록된 제품 비용(예: 셔츠 13.85 또는 신발 20.00).
• 통화 코드: 주문의 통화 코드(예: USD 또는 EUR)입니다.
• 할인 적용됨: 이 특정 항목에 할인이 적용되었는지 여부(예: true 또는 false).
• ProductID: 스토어에 있는 특정 제품의 ID.
• 수량: 이 이벤트로 표시되는 수량이에요. 정수 수량의 경우 1이며, 소수 수량으로 판매되는 제품의 경우에는 구매한 수량이에요.
• 속성(선택 사항): 사용자 지정 제품 속성.

'완료된 주문'

이 이벤트는 고객이 결제 프로세스를 완료하고 Magento 스토어에서 주문을 생성할 때 추적됩니다. Klaviyo는 구매 후 후속 이메일에 사용할 수 있도록, 누군가 구매한 품목에 대한 제품명, 이미지, 같은 이메일의 다른 버전 정보를 포함한 제품 정보 등 관련 데이터를 추적합니다. 이러한 Placed Order 이벤트에는 다음 주문 데이터가 포함됩니다. 최상위 속성을 사용해 이벤트를 필터링하고 타겟팅할 수 있으며, extra 아래의 속성 세부정보는 메시지 콘텐츠에 사용할 수 있습니다.

• 값: 할인 적용 후 세금과 배송비를 포함한 Magento의 주문 총액이에요.
• 항목: 각 주문의 라인 아이템에 있는 제품명(예: 티셔츠 또는 바지). 별도의 라인 아이템에 표시되어 있으면 이름이 두 번 이상 나타날 수 있어요.
• Item Categories: 주문에 포함된 제품의 카테고리(예: 티셔츠, 남성, 바지 및 세일)입니다.
• 품목 수: 주문의 라인 아이템 수(예: 2)예요. 이는 주문된 수량의 합계가 아니에요.
• 통화 코드: 주문의 통화 코드(예: USD 또는 EUR)입니다.
• 할인 적용됨: 주문에 할인이 적용되었는지 여부(참 또는 거짓).
• 쿠폰: 적용된 쿠폰 코드입니다.
• 고유 항목: 중복을 제거한 주문 내 제품명(예: 셔츠 또는 반바지)입니다.
• 고유 품목 카테고리: 중복을 제거한 뒤 주문에 포함된 상품 카테고리를 순서대로 나열한 값(예: 남성, 세일)입니다.
• 속성(선택 사항): extra 아래의 항목 세부 정보에 있는 제품 속성입니다. Ordered Product 이벤트를 사용해 개별 제품 속성으로 필터링하세요. 사용자 정의 제품 속성을 검토하는 방법을 알아보세요.

'환불된 주문'

표준 Magento 주문 상태에서는 주문이 종료됨 상태에 도달하면 이 이벤트가 추적돼요. Value는 개별 환불 금액이 아니라 원래 주문의 총 결제 금액(grand total)이에요.

• 값: 원래 주문의 Magento 총 결제 금액(할인 적용 후 세금 및 배송비 포함)입니다.
• 쿠폰: 적용된 쿠폰 코드입니다.
• 통화 코드: 주문의 통화 코드(예: USD 또는 EUR)입니다.
• 할인 적용됨: 주문에 할인이 적용되었는지 여부(참 또는 거짓).
• Item Categories: 주문에 포함된 제품의 카테고리(예: 티셔츠, 남성, 바지 및 세일)입니다.
• 품목 수: 주문의 라인 아이템 수(예: 2)예요. 이는 주문된 수량의 합계가 아니에요.
• 항목: 각 주문의 라인 아이템에 있는 제품명(예: 티셔츠 또는 바지). 별도의 라인 아이템에 표시되어 있으면 이름이 두 번 이상 나타날 수 있어요.
• 고유 품목 카테고리: 중복을 제거한 뒤 주문에 포함된 상품 카테고리를 순서대로 나열한 값(예: 남성, 세일)입니다.
• 고유 항목: 중복을 제거한 주문 내 제품명(예: 셔츠 또는 반바지)입니다.

Placed Order 매출은 할인 적용 후 세금과 배송비를 포함한 Magento의 주문 총액을 사용해요. $value를 기준으로 세그먼트를 필터링하려면 Revenue를 사용하세요.

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

동기화된 고객 데이터

Klaviyo는 동기화된 주문, 고객 기록, 시작된 결제를 기반으로 프로필을 생성하거나 업데이트해요. 프로필에서 확인할 수 있는 정보는 Magento에서 제공하는 데이터에 따라 달라요. 여기에는 다음이 포함될 수 있어요:

• 이메일
• 이름 및 성
• 도시, 주/지역, 우편번호, 국가
• 전화번호
• Magento 계정 생성됨(예: 2015-05-01 00:00:00)
• Magento 고객 그룹(예: 도매)
• Magento 스토어(예: 미국 스토어)
• 생년월일(예: 1990-01-01)
• 성별
• Magento 웹사이트 ID(고객 레코드에 스토어 ID가 포함된 경우)

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

사용자 정의 제품 속성 검토

맞춤 제품 속성은 기존 연동 구성에 따라 달라져요. 구성된 속성은 Ordered Product 이벤트에서 “Attribute:”라는 이름의 속성으로 표시되며, 뒤에 속성 코드가 이어져요. 속성 세부 정보는 주문 이벤트의 extra 아래에 있는 개별 항목에도 저장돼요. Klaviyo Support에서는 더 이상 Magento 1 속성 동기화를 활성화하거나 변경해 달라는 요청을 처리하지 않아요. 기존 이벤트 데이터를 검토해 어떤 속성이 포함되어 있는지 확인해 보세요. 일반적인 지원 정보는 지원팀에 문의하는 방법에서 확인할 수 있어요.

기존 구성에서 사용자 지정 속성을 식별하려면 Magento 관리자 패널에서 카탈로그 > 속성 > 속성 관리로 이동한 다음 해당 속성을 클릭해 주세요.

아래와 같이 URL에서 속성 ID를 찾아보세요.

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

동기화된 주문을 확인하려면, 완료된 하루에 대한 Placed Order 이벤트 수를 같은 날짜와 스토어의 Magento 주문 수와 비교해 보세요. 수량을 비교하기 전에 과거 동기화가 끝나고 최신 30분 동기화가 완료될 때까지 기다려 주세요.

1. 애널리틱스 > 지표로 이동한 다음 Magento 주문 완료 지표를 선택해 주세요.
2. 비교할 날짜가 포함되도록 날짜 범위를 설정해 주세요. 보기 기준을 일별로, 측정을 총합으로 설정해 주세요. 비교에서 주문이 제외되지 않도록 제외 기준이 되는 필터를 모두 삭제해 주세요.
3. 해당 날짜의 데이터 포인트에 마우스를 올리거나, 차트 아래 표에서 값을 확인해 주세요. 동일한 날짜와 스토어의 Magento 주문 수와 이 개수를 비교해 보세요.

개수가 다르면 두 보고서에서 동일한 시간대와 스토어 범위를 사용하고 있는지, 그리고 동기화가 완료되었는지 확인해 주세요. 또한 일치하지 않는 Magento 주문이 결제 대기 중인지, 또는 유효한 고객 이메일 주소가 없는지도 확인해 주세요. Klaviyo 표준 시간대를 확인하는 방법은 다음과 같습니다.

1. 왼쪽 하단에 있는 계정 이름을 클릭해 주세요.
2. 설정을 클릭합니다.
3. 일반 > 계정을(를) 선택하고 시간대 설정을 확인해 주세요.
4. 시간대를 변경하는 경우 저장을 클릭하세요. 이 값을 변경하려면 계정 설정 편집 권한이 필요합니다.

Klaviyo의 Placed Order 매출에는 취소되거나 환불된 주문이 차감되지 않아요. 따라서 이러한 주문을 차감하는 Magento 보고서와는 다를 수 있어요.

동기화된 Magento 주문 속성

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

이 예시를 참고해 동기화된 이벤트의 속성 이름과 중첩 구조를 이해해 보세요. 이 예시는 레거시 이벤트 페이로드 형식을 보여 주며, Klaviyo의 현재 API로 요청을 보내기 위한 안내는 아니에요. 예시 값은 설명을 위한 것이며, extra에는 주문 수준 이벤트에 대한 전체 주문 세부 정보가 포함돼요.

'완료된 주문'

{
  "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"
    ],
    "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
}

'주문한 제품'

{
  "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",
    "$value": 9.99,
    "Currency Code": "USD",
    "Name": "Winnie the Pooh",
    "SKU": "WINNIEPOOH",
    "ProductID": "567",
    "Categories": [
      "Fiction",
      "Classics"
    ],
    "Price": 9.99,
    "Discounted": true,
    "Cost": 5.0,
    "Attribute: Color": "Red",
    "$extra": {
      "Product URL Key": "winnie-pooh",
      "Product URL": "https://www.store.com/winnie-pooh",
      "Image URL": "https://cnd.store.com/images/winnie-pooh.png"
    },
    "Quantity": 1
  },
  "time": 1387302423
}

'처리된 주문'

{
  "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"
    ],
    "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
}

추가 자료