콘텐츠로 건너뛰기

Shopify 데이터 기능

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

추적된 Shopify 이벤트

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




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






{
    "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": {}
    }
}






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






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






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






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






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






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






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






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

이벤트: 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 태그를 추가해야 합니다.




{% 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> }}

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

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




{% 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
사용 사례: 주문 확인, 구매 후 리타겟팅, 업셀 또는 크로스셀

변수 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_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 커스텀 속성




{
  "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/* 웹훅, 과거 고객 데이터 백필

Liquid 개인화

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

“속성” 드롭다운이 펼쳐진 “개인화 추가” 섹션.

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

메시지에 Liquid 스니펫을 붙여넣는 모습.

지원되는 Shopify 표준 속성

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

SDK 데이터 수집

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

과거 데이터 백필

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

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

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

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

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

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

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

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

데이터 선택 가능한 기간 Shopify 날짜 필드
주문 이벤트 (주문 완료, 주문 환불, 주문 취소) 지난 90일, 지난 1년 또는 지난 2년 주문 생성일
고객 프로필 지난 1년, 지난 2년 또는 전체 기간 고객 업데이트일

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

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

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

이벤트가 활발히 동기화 중임을 나타내는 스피너가 표시된 Shopify 통합 설정 페이지.

백필 동기화 속도 및 소요 시간

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

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

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

동기화되는 데이터

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

다음 표에는 초기 로드에 포함되는 데이터가 요약되어 있습니다.

Braze 권장 이벤트 Shopify 커스텀 이벤트 Braze 표준 속성 Braze 구독 상태
  • 주문 완료
  • 주문 취소
  • 주문 환불
  • shopify_tags
  • shopify_total_spent
  • shopify_orders_count
  • shopify_last_order_id
  • shopify_zipcode
  • shopify_province
  • shopify_locale
  • 이메일
  • 이름
  • 성
  • 전화번호
  • 구/군/시
  • 국가
  • 총 매출
  • 총 환불
  • 총 주문
  • 이 Shopify 스토어와 연결된 이메일 마케팅 구독
  • 이 Shopify 스토어와 연결된 SMS 마케팅 구독

Braze 고객 참여 플랫폼 문서.

리소스
법적 고지
회사
© 2026 Braze, Inc. All rights reserved.
브레이즈 상태 확인
New Stuff!