Shopify 데이터 기능

이 문서에서는 추적되는 Shopify 데이터와 예시 페이로드, 과거 데이터 백필, 제품 동기화를 포함한 Braze Shopify 기능에 대한 개요를 제공합니다.

추적된 Shopify 이벤트

Shopify 통합은 이커머스 추천 이벤트를 사용하여 주요 쇼핑 행동을 캡처합니다. 이러한 이벤트를 활용한 구현 예시와 마케팅 전략은 이커머스 사용 사례를 참조하세요.

중요

Shopify 통합은 데이터 구성 설정에 있는 Shopify 고객 생성 및 고객 업데이트 웹훅을 지원합니다. Shopify에서 사용자 프로필이 생성되거나 업데이트되면 Braze에서도 해당 사용자 프로필이 생성되거나 업데이트됩니다.

이러한 동작은 Braze에서 커스텀 이벤트를 트리거하지 않으며, Shopify 사용자 데이터를 Braze와 동기화하는 용도로만 사용됩니다. 동기화되는 데이터에는 커스텀 속성, 표준 속성, 그리고 구성에서 활성화된 경우 구독 그룹 상태가 포함됩니다.

• 예시 페이로드
• shopify 이벤트

• product viewed
• cart updated
• checkout started
• order placed
• fulfilled order
• partially fulfilled order
• paid order
• order cancelled
• order refunded
• account login

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

{
    "name": "ecommerce.product_viewed",
    "properties": {
        "product_id": "12345",
        "product_name": "product",
        "variant_id": "123",
        "image_url": "www.image-url.com",
        "product_url": "mystorefront.myshopify.com/product",
        "price": 10,
        "currency": "USD",
        "source": "mystorefront.myshopify.com",
        "metadata": {
          "sku": "sku"
        },
        "type": [
          "price_drop",
          "back_in_stock"
        ]
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
    "name": "ecommerce.cart_updated",
    "properties": {
        "cart_id": "Z2NwLXVzLWVhc3QxOjAxSjk3UFg4RlFZMjVTVkRHRlc1RlI3SlRY",
        "currency": "USD",
        "total_value": 2000000,
        "products": [
            {
                "product_id": "8266836345064",
                "product_name": "PANTS!!!",
                "variant_id": "44610569208040",
                "image_url": "https://cdn.shopify.com/s/files/1/0604/4211/6328/files/1200px-Trousers-colourisolated.jpg?v=1689256168",
                "product_url": "https://test-store.myshopify.com/products/pants?variant=44610569208040",
                "quantity": 2,
                "price": 1000000,
                "metadata": {
                    "sku": "007"
                }
            }
        ],
        "source": "https://test-store.myshopify.com",
        "metadata": {}
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

{
    "name": "ecommerce.checkout_started",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "cart_id": "eeafa272cebfd4b22385bc4b645e762c",
        "total_value": 421.88,
        "subtotal_value": 396.88,
        "tax": 15.00,
        "shipping": 10.00,
        "currency": "USD",
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "checkout_id": "123123123",
        "metadata": {
            "checkout_url": "https://checkout.local/548380009/checkouts/123123123/recover?key=example-secret-token"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

{
    "name": "ecommerce.order_placed",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "cart_id": "eeafa272cebfd4b22385bc4b645e762c",
        "total_value": 421.88,
        "subtotal_value": 396.88,
        "tax": 15.00,
        "shipping": 10.00,
        "currency": "USD",
        "total_discounts": 5,
        "discounts": [],
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "metadata": {
            "order_status_url": "https://apple.myshopify.com/690933842/orders/123456abcd/authenticate?key=abcdefg",
            "order_number": "1234",
            "tags": [
                "heavy",
                "heavy2"
            ],
            "referring_site": "https://www.google.com",
            "payment_gateway_names": [
                "visa",
                "bogus"
            ]
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

{
 "name": "shopify_fulfilled_order",
 "time": "2022-05-23T14:44:34-04:00",
 "properties": {
   "order_id": 4444668657855,
   "line_items": [
     {
       "quantity": 1,
       "product_id": 6143032066239,
       "sku": null,
       "title": "Dark Denim Top",
  "variant_id": 40094740549876,
       "variant_title": "Small Dark Denim Top",


       "vendor": "partners-demo",
       "name": "Dark Denim Top",
       "properties": [],
       "price": "60.00",
       "fulfillment_status": "fulfilled"
     }
   ],
   "shipping": [
     {
       "title": "Standard",
       "price": "0.00"
     }
   ],
   "total_price": "130.66",
   "confirmed": true,
   "total_discounts": "0.00",
   "discount_codes": [],
   "order_number": 1093,
   "order_status_url": "https://test-store.myshopify.com/",
   "cancelled_at": null,
   "tags": "",
   "closed_at": "2022-05-23T14:44:34-04:00",
   "fulfillment_status": "fulfilled",
   "fulfillments": [
     {
       "shipment_status": null,
       "status": "success",
       "tracking_company": "Other",
       "tracking_number": "456",
       "tracking_numbers": [
         "456"
       ],
       "tracking_url": "https://braze.com",
       "tracking_urls": [
         "https://braze.com"
       ],
       "line_items": [
         {
           "fulfillment_status": "fulfilled",
           "name": "Dark Denim Top",
           "price": "60.00",
           "product_id": 6143032066239,
           "quantity": 1,
           "requires_shipping": true,
           "sku": null,
           "title": "Dark Denim Top",
           "variant_id": 40094740549876,
           "variant_title": "Small Dark Denim Top",
           "vendor": "partners-demo"
         }
       ]
     }
   ]
 },
 "braze_id": "123abc123abc"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

{
 "name": "shopify_partially_fulfilled_order",
 "time": "2022-05-23T14:43:34-04:00",
 "properties": {
   "order_id": 4444668657855,
   "line_items": [
     {
       "quantity": 1,
       "product_id": 6143032066239,
       "sku": null,
       "title": "Dark Denim Top",
       "variant_id": 40094740549876,
       "variant_title": "",
       "vendor": "partners-demo",
       "name": "Dark Denim Top",
       "properties": [],
       "price": "60.00",
       "fulfillment_status": "fulfilled"
     }
   ],
   "shipping": [
     {
       "title": "Standard",
       "price": "0.00"
     }
   ],
   "total_price": "130.66",
   "confirmed": true,
   "total_discounts": "0.00",
   "discount_codes": [],
   "order_number": 1093,
   "order_status_url": "https://test-store.myshopify.com/",
   "cancelled_at": null,
   "tags": "",
   "closed_at": null,
   "fulfillment_status": "partial",
   "fulfillments": [
     {
       "shipment_status": null,
       "status": "success",
       "tracking_company": "Other",
       "tracking_number": "123",
       "tracking_numbers": [
         "123"
       ],
       "tracking_url": "https://braze.com",
       "tracking_urls": [
         "https://braze.com"
       ],
       "line_items": [
         {
           "fulfillment_status": "fulfilled",
           "name": "Dark Denim Top",
           "price": "60.00",
           "product_id": 6143032066239,
           "properties": [],
           "quantity": 1,
           "requires_shipping": true,
           "sku": null,
           "title": "Dark Denim Top",
           "variant_id": 40094740549876,
           "variant_title": "",
           "vendor": "partners-demo"
         }
       ]
     }
   ]
 },
 "braze_id": "abc123abc123"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

{
 "name": "shopify_paid_order",
 "time": "2022-05-23T13:52:38-04:00",
 "properties": {
   "order_id": 4444596371647,
   "line_items": [
     {
       "quantity": 1,
       "product_id": 6143033344191,
       "sku": null,
       "title": "LED High Tops",
       "variant_id": 40094740549876,
       "variant_title": null,
       "vendor": "partners-demo",
       "name": "LED High Tops",
       "properties": [],
       "price": "80.00",
       "fulfillment_status": null
     }
   ]
 }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

{
    "name": "ecommerce.order_cancelled",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "cancel_reason": "no longer necessary",
        "total_value": 421.88,
        "subtotal_value": 396.88,
        "tax": 15.00,
        "shipping": 10.00,
        "currency": "USD",
        "total_discounts": 5,
        "discounts": [],
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "metadata": {
            "order_status_url": "https://apple.myshopify.com/690933842/orders/123456abcd/authenticate?key=abcdefg",
            "order_number": "1234",
            "tags": [
                "heavy",
                "heavy2"
            ]
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

{
    "name": "ecommerce.order_refunded",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "total_value": 421.88,
        "currency": "USD",
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "metadata": {
		"order_note": "item was broken"
        }
    }
}

1
2
3
4
5
6

{
	"name": "shopify_account_login",
	"properties": {
	"source": "braze-mock-storefront.myshopify.com"
  }
}

참고

Braze는 이커머스 이벤트에 필요한 이벤트 속성정보(예: cart_id 또는 cart_token)를 Shopify로부터 제공받습니다. 드물게 Shopify 측의 일시적인 문제로 인해 이러한 속성정보가 누락될 수 있으며, 이 경우 해당 이벤트가 삭제될 수 있습니다.

• product viewed
• cart updated
• checkout started
• order placed
• fulfilled order
• partially fulfilled order
• paid order
• order cancelled
• order refunded
• account login

이벤트: ecommerce.product_viewed
유형: 추천 이벤트
트리거: 고객이 제품 페이지를 조회할 때
데이터 소스: Braze SDK
사용 사례: 탐색 이탈

변수	Liquid 템플릿
product_id	{{event_properties.${product_id}}}
product_name	{{event_properties.${product_name}}}
variant_id	{{event_properties.${variant_id}}}
image_url	{{event_properties.${image_url}}}
product_url	<your-store.myshopify.com>{{event_properties.${product_url}}} URL 앞에 Shopify 사이트 도메인을 추가하세요.
price	{{event_properties.${price}}}
currency	{{event_properties.${currency}}}
source	{{event_properties.${source}}}
sku	{{event_properties.${metadata}[0].sku}}
type	event_properties.${type}

이벤트: ecommerce.cart_updated
유형: 추천 이벤트
트리거: 고객이 장바구니에 상품을 추가, 제거 또는 업데이트할 때
데이터 소스: Braze SDK
사용 사례: 장바구니 유기

장바구니 유기 Canvases의 경우, 먼저 초기 장바구니 Liquid 태그를 추가하여 메시지에서 장바구니 컨텍스트를 가져와야 합니다.

1

{% shopping_cart {{context.${cart_id}}} %}

그런 다음 메시지에 다음 장바구니 Liquid 태그를 추가할 수 있습니다.

변수	Liquid 템플릿
cart_id	{{ shopping_cart.cart_id }}
currency	{{ shopping_cart.currency }}
total_value	{{ shopping_cart.total_value }}
product_id	{{ shopping_cart.products[0].product_id }}
product_name	{{ shopping_cart.products[0].product_name }}
variant_id	{{ shopping_cart.products[0].variant_id }}
image_url	{{ shopping_cart.products[0].image_url }}
product_url	{{ shopping_cart.products[0].product_url }}
quantity	{{ shopping_cart.products[0].quantity }}
price	{{ shopping_cart.products[0].price }}
sku	{{ shopping_cart.products[0].metadata[0].sku }}
source	{{ shopping_cart.source }}
metadata (value)	{{ shopping_cart.metadata[0].<add_value_here> }}

팁

Liquid for 루프를 구성하여 모든 제품을 이메일에 동적으로 추가하는 방법에 대한 자세한 내용은 이메일용 장바구니 유기 제품 개인화를 참조하세요.

이벤트: ecommerce.checkout_started
유형: 추천 이벤트
트리거: 사용자가 결제 페이지로 이동할 때
데이터 소스: Braze REST API
사용 사례: 결제 이탈

중요

고객이 빠른 결제 옵션으로 Shop Pay를 사용하는 경우, Shopify가 일부 표준 결제 이벤트(예: Shopify 결제 시작 웹훅)를 건너뛸 수 있습니다. 이 경우 Braze가 결제 토큰 별칭을 추가하는 데 필요한 데이터를 받지 못할 수 있으며, 이는 결제 이탈 추적 및 고객 프로필 조정에 영향을 줄 수 있습니다.

결제 이탈 Canvases의 경우, 먼저 다음 Liquid 태그를 사용해야 합니다.

1
2

{% shopping_cart {{context.${cart_id}}} :abort_if_not_abandoned false %}
{{context.${cart_id}}}

그런 다음 메시지에 다음 Liquid 태그를 추가하여 결제 시점에 장바구니에 담긴 제품을 참조할 수 있습니다.

변수	Liquid 템플릿
cart_id	{{ shopping_cart.cart_id }}
currency	{{ shopping_cart.currency }}
total_value	{{ shopping_cart.total_value }}
product_id	{{ shopping_cart.products[0].product_id }}
product_name	{{ shopping_cart.products[0].product_name }}
variant_id	{{ shopping_cart.products[0].variant_id }}
image_url	{{ shopping_cart.products[0].image_url }}
product_url	{{ shopping_cart.products[0].product_url }}
quantity	{{ shopping_cart.products[0].quantity }}
price	{{ shopping_cart.products[0].price }}
sku	{{ shopping_cart.products[0].metadata.sku }}
source	{{ shopping_cart.source }}
checkout_url	{{ shopping_cart.metadata[0].checkout_url }}

이벤트: ecommerce.order_placed
유형: 추천 이벤트
트리거: 사용자가 결제 과정을 성공적으로 완료하고 주문할 때
데이터 소스: Braze REST API
사용 사례: 주문 확인, 구매 후 리타겟팅, 업셀 또는 교차 판매

다른 시스템에서 이미 주문 완료 이벤트를 Braze로 보내고 있다면, Shopify 데이터 추적 단계에서 Send Order Placed events from another source를 사용하여 스토어별로 이 이벤트를 끌 수 있습니다. 그러면 Braze는 해당 스토어의 실시간 주문과 백필된 주문에 대해 ecommerce.order_placed를 건너뛰고, 다른 주문 이벤트, shopify_paid_order, 구매 속성은 계속 업데이트합니다. 자세한 내용은 표준 데이터 설정을 참조하세요.

변수	Liquid 템플릿
cart_id	{{event_properties.${cart_id}}}
currency	{{event_properties.${currency}}}
discounts	{{event_properties.${discounts}}}
order_id	{{event_properties.${order_id}}}
product_id	{{event_properties.${products}[0].product_id}}
product_name	{{event_properties.${products}[0].product_name}}
variant_id	{{event_properties.${products}[0].variant_id}}
quantity	{{event_properties.${products}[0].quantity}}
sku	{{event_properties.${products}[0].metadata.sku}}
total_discounts	{{event_properties.${total_discounts}}}
order_status_url	{{event_properties.${metadata}.order_status_url}}
order_number	{{event_properties.${metadata}.order_number}}
tags	{{event_properties.${metadata}.tags}}
referring_site	{{event_properties.${metadata}.referring_site}}
payment_gateway_names	{{event_properties.${metadata}.payment_gateway_names}}

팁

Shopify의 결제 완료 웹훅에는 제품 URL이나 이미지 URL이 포함되지 않습니다. 따라서 이메일용 장바구니 유기 제품 개인화에 설명된 대로 카탈로그 Liquid 개인화를 사용해야 합니다.

이벤트: shopify_fulfilled_order
유형: 커스텀 이벤트
트리거: 사용자의 주문이 처리 완료되어 배송 준비가 되었을 때
데이터 소스: Braze REST API
사용 사례: (트랜잭션) 주문 처리 업데이트

변수	Liquid 템플릿
주문 ID	{{event_properties.${order_id}}}
총 가격	{{event_properties.${total_price}}}
총 할인	{{event_properties.${total_discounts}}}
확인 상태	{{event_properties.${confirmed}}}
주문 상태 URL	{{event_properties.${order_status_url}}}
주문 번호	{{event_properties.${order_number}}}
취소 타임스탬프	{{event_properties.${cancelled_at}}}
종료 타임스탬프	{{event_properties.${closed_at}}}
항목 ID	{{event_properties.${line_items}[0].product_id}}
항목 수량	{{event_properties.${line_items}[0].quantity}}
항목 SKU	{{event_properties.${line_items}[0].sku}}
항목 제목	{{event_properties.${line_items}[0].title}}
항목 공급업체	{{event_properties.${line_items}[0].vendor}}
항목 이름	{{event_properties.${line_items}[0].name}}
항목 속성정보	{{event_properties.${line_items}[0].properties}}
항목 가격	{{event_properties.${line_items}[0].price}}
배송 제목	{{event_properties.${shipping}[0].title}}
배송 가격	{{event_properties.${shipping}[0].price}}
주문 처리 상태	{{event_properties.${fulfillment_status}}}
주문 처리 배송 상태	{{event_properties.${fulfillments}[0].shipment_status}}
상태	{{event_properties.${fulfillments}[0].status}}
주문 처리 배송 추적 회사	{{event_properties.${fulfillments}[0].Fulfillment tracking_company}}
주문 처리 추적 번호	{{event_properties.${fulfillments}[0].Fulfillment tracking_number}}
주문 처리 추적 번호 목록	{{event_properties.${fulfillments}[0].Fulfillment tracking_numbers}}
주문 처리 추적 URL	{{event_properties.${fulfillments}[0].Fulfillment tracking_url}}
주문 처리 추적 URL 목록	{{event_properties.${fulfillments}[0].Fulfillment tracking_urls}}
주문 처리 상태	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
주문 처리 이름	{{event_properties.${fulfillments}[0].line_items[0].name}}
주문 처리 가격	{{event_properties.${fulfillments}[0].line_items[0].price}}
주문 처리 제품 ID	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
주문 처리 수량	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
주문 처리 배송 필요 여부	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
주문 처리 SKU	{{event_properties.${fulfillments}[0].line_items[0].sku}}
주문 처리 제목	{{event_properties.${fulfillments}[0].line_items[0].title}}
주문 처리 공급업체	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
배리언트 ID	{{event_properties.${line_items}[0].variant_id}}
배리언트 제목	{{event_properties.${line_items}[0].variant_title}}

이벤트: shopify_partially_fulfilled_order
유형: 커스텀 이벤트
트리거: 사용자 주문의 일부가 처리 완료되어 배송 준비가 되었을 때
데이터 소스: Braze REST API
사용 사례: (트랜잭션) 주문 처리 업데이트

변수	Liquid 템플릿
주문 ID	{{event_properties.${order_id}}}
총 가격	{{event_properties.${total_price}}}
총 할인	{{event_properties.${total_discounts}}}
확인 상태	{{event_properties.${confirmed}}}
주문 상태 URL	{{event_properties.${order_status_url}}}
주문 번호	{{event_properties.${order_number}}}
취소 타임스탬프	{{event_properties.${cancelled_at}}}
종료 타임스탬프	{{event_properties.${closed_at}}}
항목 ID	{{event_properties.${line_items}[0].product_id}}
항목 수량	{{event_properties.${line_items}[0].quantity}}
항목 SKU	{{event_properties.${line_items}[0].sku}}
항목 제목	{{event_properties.${line_items}[0].title}}
항목 공급업체	{{event_properties.${line_items}[0].vendor}}
항목 이름	{{event_properties.${line_items}[0].name}}
항목 속성정보	{{event_properties.${line_items}[0].properties}}
항목 가격	{{event_properties.${line_items}[0].price}}
배송 제목	{{event_properties.${shipping}[0].title}}
배송 가격	{{event_properties.${shipping}[0].price}}
주문 처리 상태	{{event_properties.${fulfillment_status}}}
주문 처리 배송 상태	{{event_properties.${fulfillments}[0].shipment_status}}
주문 처리 상태	{{event_properties.${fulfillments}[0].status}}
주문 처리 배송 추적 회사	{{event_properties.${fulfillments}[0].tracking_company}}
주문 처리 추적 번호	{{event_properties.${fulfillments}[0].tracking_number}}
주문 처리 추적 번호 목록	{{event_properties.${fulfillments}[0].tracking_numbers}}
주문 처리 추적 URL	{{event_properties.${fulfillments}[0].tracking_url}}
주문 처리 추적 URL 목록	{{event_properties.${fulfillments}[0].tracking_urls}}
주문 처리 상태	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
주문 처리 이름	{{event_properties.${fulfillments}[0].line_items[0].name}}
주문 처리 가격	{{event_properties.${fulfillments}[0].line_items[0].price}}
주문 처리 제품 ID	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
주문 처리 수량	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
주문 처리 배송 필요 여부	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
주문 처리 SKU	{{event_properties.${fulfillments}[0].line_items[0].sku}}
주문 처리 제목	{{event_properties.${fulfillments}[0].line_items[0].title}}
주문 처리 공급업체	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
배리언트 ID	{{event_properties.${line_items}[0].variant_id}}
배리언트 제목	{{event_properties.${line_items}[0].variant_title}}

이벤트: shopify_paid_order
유형: 커스텀 이벤트
트리거: Shopify에서 사용자의 주문이 결제 완료로 표시될 때
데이터 소스: Braze REST API
사용 사례: (트랜잭션) 결제 확인

변수	Liquid 템플릿
주문 ID	{{event_properties.${order_id}}}
확인 상태	{{event_properties.${confirmed}}}
주문 상태 URL	{{event_properties.${order_status_url}}}
주문 번호	{{event_properties.${order_number}}}
취소 타임스탬프	{{event_properties.${cancelled_at}}}
총 할인	{{event_properties.${total_discounts}}}
총 가격	{{event_properties.${total_price}}}
태그	{{event_properties.${tags}}}
할인 코드	{{event_properties.${discount_codes}}}
항목 ID	{{event_properties.${line_items}[0].product_id}}
항목 수량	{{event_properties.${line_items}[0].quantity}}
항목 SKU	{{event_properties.${line_items}[0].sku}}
항목 제목	{{event_properties.${line_items}[0].title}}
항목 공급업체	{{event_properties.${line_items}[0].vendor}}
항목 속성정보	{{event_properties.${line_items}[0].properties}}
항목 가격	{{event_properties.${line_items}[0].price}}
배송 제목	{{event_properties.${shipping}[0].title}}
배송 가격	{{event_properties.${shipping}[0].price}}
배리언트 ID	{{event_properties.${line_items}[0].variant_id}}
배리언트 제목	{{event_properties.${line_items}[0].variant_title}}

이벤트: ecommerce.order_cancelled
유형: 추천 이벤트
트리거: 사용자의 주문이 취소될 때
데이터 소스: Braze REST API
사용 사례: (트랜잭션) 주문 취소 확인

변수	Liquid 템플릿
주문 ID	{{event_properties.${order_id}}}
총 가격	{{event_properties.${total_price}}}
총 할인	{{event_properties.${total_discounts}}}
확인됨	{{event_properties.${confirmed}}}
주문 상태 URL	{{event_properties.${order_status_url}}}
주문 번호	{{event_properties.${order_number}}}
취소 타임스탬프	{{event_properties.${cancelled_at}}}
태그	{{event_properties.${tags}}}
할인 코드	{{event_properties.${discount_codes}}}
주문 처리 상태	{{event_properties.${fulfillment_status}}}
주문 처리	{{event_properties.${fulfillments}}}
항목 ID	{{event_properties.${line_items}[0].product_id}}
항목 수량	{{event_properties.${line_items}[0].quantity}}
항목 SKU	{{event_properties.${line_items}[0].sku}}
항목 제목	{{event_properties.${line_items}[0].title}}
항목 공급업체	{{event_properties.${line_items}[0].vendor}}
항목 이름	{{event_properties.${line_items}[0].name}}
항목 속성정보	{{event_properties.${line_items}[0].properties}}
주문 처리 상태	{{event_properties.${line_items}[0].fulfillment_status}}
배송 제목	{{event_properties.${shipping}[0].title}}
배송 가격	{{event_properties.${shipping}[0].price}}
배리언트 ID	{{event_properties.${line_items}[0].variant_id}}
배리언트 제목	{{event_properties.${line_items}[0].variant_title}}

이벤트: ecommerce.order_refunded
유형: 추천 이벤트
트리거: 사용자의 주문이 환불될 때
데이터 소스: Braze REST API
사용 사례: (트랜잭션) 환불 확인

변수	Liquid 템플릿
주문 ID	{{event_properties.${order_id}}}
주문 메모	{event_properties.${note}}}
항목 ID	{{event_properties.${line_items}[0].product_id}}
항목 수량	{{event_properties.${line_items}[0].quantity}}
항목 SKU	{{event_properties.${line_items}[0].sku}}
항목 제목	{{event_properties.${line_items}[0].title}}
항목 공급업체	{{event_properties.${line_items}[0].vendor}}
항목 이름	{{event_properties.${line_items}[0].name}}
항목 속성정보	{{event_properties.${line_items}[0].properties}}
항목 가격	{{event_properties.${line_items}[0].price}}
배리언트 ID	{{event_properties.${line_items}[0].variant_id}}
배리언트 제목	{{event_properties.${line_items}[0].variant_title}}

이벤트: shopify_account_login
유형: 커스텀 이벤트
트리거: 사용자가 계정에 로그인할 때
데이터 소스: Braze REST API
사용 사례: 환영 시리즈

변수	Liquid 템플릿
source	{{event_properties.${source}}}

참고

Shopify 통합은 현재 Braze 구매 이벤트 채우기를 지원하지 않습니다. 따라서 구매 필터, Liquid 태그, 실행 기반 트리거 및 분석에는 ecommerce.order_placed 이벤트를 사용해야 합니다.

지원되는 Shopify 커스텀 속성

참고

모든 속성의 소스는 Braze REST API입니다.

• example payload
• shopify custom attributes

• shopify tags

1
2
3
4
5
6
7
8
9
10
11
12

{
  "attributes": [
    {
      "shopify_tags": "VIP_customer",
      "shopify_total_spent": "60.00",
      "shopify_orders_count": "3",
      "shopify_last_order_id": "1234567",
      "shopify_zipcode": "10001",
      "shopify_province": "null"
    }
  ]
}

속성 이름	설명	데이터 소스
shopify_total_spent	고객이 전체 주문 내역에서 지출한 총 금액입니다.	Shopify의 customers/purchasing_summary 웹훅
shopify_orders_count	이 고객과 연결된 주문 수입니다. 테스트 주문과 보관된 주문은 집계되지 않습니다.	Shopify의 customers/purchasing_summary 웹훅
shopify_last_order_id	고객의 마지막 주문 ID입니다.	Shopify의 customers/purchasing_summary 웹훅
shopify_zipcode	고객의 기본 주소에 있는 우편번호입니다.	Shopify의 customers/create 및 customers/update 웹훅
shopify_province	고객의 기본 주소에 있는 주/도입니다.	Shopify의 customers/create 및 customers/update 웹훅
shopify_locale	고객의 로캘(예: en 또는 fr-CA)입니다. 고객이 주문하기 전까지는 Braze 웹 픽셀이 수집한 브라우저 언어로 설정되며, 이후에는 최근 결제의 로캘로 업데이트됩니다.	Braze 웹 픽셀, Shopify orders/* 웹훅, 과거 고객 데이터 백필

참고

Shopify에서 더 이상 고객의 마지막 주문 이름을 제공하지 않으므로 Braze는 shopify_last_order_name 속성을 설정하지 않습니다. 이미 값이 있는 프로필은 해당 값을 유지하지만, 업데이트되지는 않습니다.

Liquid 개인화

Shopify 커스텀 속성에 Liquid 개인화를 추가하려면 + 개인화를 선택합니다. 그런 다음 개인화 유형으로 커스텀 속성을 선택합니다.

커스텀 속성을 선택한 후 기본값을 입력하고 Liquid 스니펫을 복사하여 메시지에 붙여넣습니다.

지원되는 Shopify 표준 속성

참고

모든 속성의 소스는 Braze REST API입니다.

• 이메일
• 이름
• 성
• 전화번호
• 구/군/시
• 국가

참고

Braze는 기존 고객 프로필과 데이터에 차이가 있는 경우에만 지원되는 Shopify 커스텀 속성과 Braze 표준 속성을 업데이트합니다. 예를 들어, 수신되는 Shopify 데이터에 이름이 Bob으로 포함되어 있고 Braze 고객 프로필에 이미 이름이 Bob으로 존재하는 경우, Braze는 업데이트를 트리거하지 않으며 데이터 포인트도 청구되지 않습니다.

Shopify 고객 메타필드

Shopify 고객 메타필드에는 로열티 등급이나 고객이탈 위험 점수처럼 고객에 대한 자체 데이터가 저장됩니다. 표준 통합을 사용하면 최대 20개의 고객 메타필드 정의를 Braze 고객 프로필에 동기화하여 세분화와 개인화에 활용할 수 있습니다.

메타필드가 고객 프로필에 저장되는 방식

Braze는 연결된 스토어마다 shopify_metafields_<store>라는 이름의 중첩 커스텀 속성을 하나씩 추가합니다. 여기서 <store>는 <store>.myshopify.com 도메인의 첫 부분입니다. 선택한 각 메타필드는 이 객체 안에서 <namespace>_<key>라는 이름의 키가 됩니다. 예를 들어 acme.myshopify.com 스토어의 custom.vip_tier 및 custom.loyalty_points 정의는 프로필에 다음과 같이 저장됩니다.

1
2
3
4
5
6

{
  "shopify_metafields_acme": {
    "custom_vip_tier": "gold",
    "custom_loyalty_points": 120
  }
}

각 업데이트는 객체에 딥 머지되므로 키 하나만 포함된 업데이트가 다른 키를 지우는 일은 없으며, Braze는 객체에서 키를 제거하지 않습니다. Shopify에서 메타필드가 비어 있으면 프로필은 마지막 값을 유지합니다.

지원되는 메타필드 유형

다음 유형의 정의만 선택기에 표시됩니다. 참조, 파일, JSON, 금액, 평점 등 다른 유형은 지원되지 않습니다.

다음과 같은 경우 Braze는 해당 값을 프로필에 기록하지 않고 나머지 키는 계속 기록합니다.

• 문자열 값 또는 목록의 항목이 255자를 초과하는 경우
• 값을 정의의 유형으로 변환할 수 없는 경우(예: 정수 필드에 텍스트가 있는 경우)
• 속성 키(<namespace>_<key>)가 255자를 초과하거나 $ 또는 .처럼 Braze가 저장할 수 없는 문자가 포함된 경우

값이 동기화되는 시점

통합 페이지의 Shopify 사용자 속성 표에서 동기화 상태를 확인할 수 있습니다. 이 표에는 기본 속성과 고객 메타필드가 상태(활성 또는 동기화 진행 중에는 업데이트 중) 및 각 항목의 속성 수와 함께 표시됩니다. 행의 보기 아이콘을 선택하면 속성 이름을 확인할 수 있습니다.

메타필드 변경 또는 제거

• 선택 항목을 변경하려면 통합 페이지에서 설정 편집을 선택하고 Shopify 데이터 추적 단계에서 선택기를 업데이트합니다. 메타필드를 추가하면 기존 고객에 대한 동기화가 시작되고, 메타필드를 제거하면 해당 키의 업데이트가 중지됩니다.
• 선택 항목에서 메타필드를 제거하거나 고객 메타필드를 사용자 속성으로 동기화를 끄면, 사용자 프로필은 Shopify의 마지막 값을 유지하고 더 이상 업데이트되지 않습니다.
• Shopify에서 정의를 삭제하면 Braze가 자동으로 선택 항목에서 제거합니다. 이미 사용자 프로필에 있는 값은 그대로 유지됩니다.

세분화 및 개인화

메타필드로 필터링하려면 먼저 해당 속성의 스키마를 생성해야 합니다. 데이터 설정 > 커스텀 속성으로 이동하여 shopify_metafields_<store>를 찾은 다음 스키마 생성을 선택합니다. Braze는 이미 사용자 프로필에 있는 값으로 스키마를 만들기 때문에, 첫 번째 동기화가 완료된 후에 이 작업을 수행하고 메타필드를 추가한 후에는 새 키가 표시되도록 스키마를 다시 생성하세요.

메타필드를 기준으로 세분화하려면 중첩 커스텀 속성 필터를 추가하고 shopify_metafields_<store>를 선택한 다음, 키를 속성정보로 선택하고 해당 유형에 맞는 비교 연산자를 선택합니다. 날짜 메타필드에는 시간 및 연중 일자 비교 연산자를 사용합니다. 메시지를 개인화하려면 점 표기법과 함께 custom_attribute 태그를 사용합니다. 앞의 예시 프로필의 경우 {{custom_attribute.${shopify_metafields_acme}.custom_vip_tier}}는 gold를 반환합니다.

Connected Audience API 호출에서는 중첩 커스텀 속성을 필터로 사용할 수 없으며, 커스텀 사용자로 미리보기는 모의 데이터를 문자열 또는 문자열 배열로만 허용합니다. 전체 목록은 중첩 커스텀 속성 고려 사항을 참조하세요.

SDK 데이터 수집

Braze SDK에서 수집하는 데이터에 대한 자세한 내용은 SDK 데이터 수집을 참조하세요.

과거 데이터 백필

과거 Shopify 데이터는 Braze를 연결하기 이전 기간의 데이터를 가져옵니다. 설정 중에 주문 이벤트와 고객 프로필을 얼마나 이전까지 가져올지 선택합니다. 각 기간은 통합을 완료한 날짜를 기준으로 역산됩니다.

Shopify 표준 통합 설정 또는 Shopify 커스텀 통합 설정에서 과거 데이터 백필을 켜면 과거 고객과 주문을 Segments, Campaigns, Canvases에 포함할 수 있습니다. 이 기능을 켜면 다음을 선택합니다.

• 주문 기간: 지난 90일, 지난 1년 또는 지난 2년(기본값은 지난 90일)
• 고객 프로필 기간: 지난 1년, 지난 2년 또는 전체 기간(기본값은 전체 기간)

Braze는 설정을 완료하기 전에 각 옵션의 예상 레코드 수와 처리 시간을 보여줍니다. 백필이 완료되면 선택한 기간이 Shopify 파트너 페이지에 구체적인 날짜로 표시됩니다. 이 선택 사항은 설정이 완료된 후에는 변경할 수 없습니다.

Braze가 Shopify 고객을 가져올 때 구성 설정에서 선택한 external_id 유형을 할당합니다.

참고

활성 Campaigns 또는 Canvases가 있는 기존 Braze 고객이라면, 과거 데이터 백필을 활성화하기 전에 가져온 고객과 주문 이벤트가 Segments와 여정에 어떤 영향을 미치는지 검토하세요. 과거 데이터 백필은 이미 활성 Campaigns 또는 Canvases에 있는 사용자를 소급하여 업데이트하지 않습니다.

커스텀 외부 ID로 통합할 계획인 경우(표준 통합 또는 커스텀 통합 모두 해당), 기존의 모든 Shopify 고객 프로필에 커스텀 외부 ID를 Shopify 고객 메타필드로 추가한 후 과거 데이터 백필을 수행해야 합니다.

Braze가 과거 데이터를 선택하는 방법

초기 로드가 실행될 때 Braze는 다음 Shopify 날짜 필드를 사용합니다.

과거 주문을 Shopify로 마이그레이션하면서 원래 생성일을 유지하는 경우, Braze는 생성일이 선택한 주문 기간에 해당하는 주문만 가져옵니다.

Shopify 과거 데이터 백필 설정하기

1. Shopify 데이터 추적 단계에서 과거 데이터 백필 켜기를 선택합니다.
2. 주문 기간과 고객 프로필 기간을 선택합니다. 선택한 항목의 예상 개수와 처리 시간을 검토합니다.
3. 통합 설정을 완료하면 Braze가 초기 데이터 동기화를 시작합니다. 통합 설정의 Shopify 데이터 탭에서 진행 상황을 모니터링할 수 있습니다.

백필 동기화 속도 및 타이밍

과거 데이터 백필은 Braze SDK가 아닌 Braze의 Shopify 통합에서 수행되며, 통합 설정을 완료하면 자동으로 시작됩니다.

과거 데이터 백필을 활성화하면 Braze는 Shopify에서 주문 이벤트와 고객 프로필을 일괄로 가져옵니다. 주문 이벤트와 고객 프로필은 별도의 일정으로 동기화되므로 한쪽이 먼저 완료될 수 있습니다. 대규모 백필은 동시에 실행할 수 있도록 병렬 기간으로 분할됩니다.

동기화 시간은 스토어에 있는 과거 데이터의 양과 선택한 기간에 따라 달라집니다. 주문량이 많거나 고객 기반이 큰 스토어는 백필을 완료하는 데 더 오래 걸릴 수 있습니다. 백필 속도를 변경하거나 더 빠른 동기화를 요청할 수는 없습니다.

동기화된 데이터

초기 데이터 동기화에서 Braze는 Braze가 과거 데이터를 선택하는 방법에 설명된 주문 이벤트와 고객 프로필을 가져옵니다. Braze가 Shopify 고객을 가져올 때 구성 설정에서 선택한 external_id 유형을 할당합니다. 설정 중에 고객 메타필드를 선택한 경우 고객 백필에서 해당 값도 기록합니다.

다음 표는 초기 로드에 포함되는 데이터를 요약한 것입니다.