콘텐츠로 건너뛰기

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}.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.sku }}

이벤트: 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 }}

트리거가 되는 ecommerce.checkout_started 이벤트의 이벤트 속성정보(예: source, checkout_url)로도 개인화할 수 있습니다. 이러한 속성정보는 장바구니에 저장되지 않으므로 {% shopping_cart %} 태그로는 사용할 수 없습니다. 유기한 체크아웃 Canvas에서는 Canvas 컨텍스트에서 참조하세요.

변수 Liquid 템플릿
source {{context.${source}}}
checkout_url {{context.${metadata}.checkout_url}}

예를 들어, 유기한 체크아웃 이메일에서는 다음과 같이 사용합니다.

{% shopping_cart {{context.${cart_id}}} :abort_if_not_abandoned false %}
{% for item in shopping_cart.products %}
  {{ item.product_name }} / SKU: {{ item.metadata.sku }}
{% endfor %}
<a href="{{context.${metadata}.checkout_url}}">Return to checkout</a>

이벤트: ecommerce.order_placed
유형: 추천 이벤트
트리거: 사용자가 체크아웃 프로세스를 성공적으로 완료하고 주문을 완료할 때
데이터 소스: Braze REST API
사용 사례: 주문 확인, 구매 후 리타겟팅, 업셀 또는 크로스셀

다른 시스템에서 이미 Braze로 주문 완료 이벤트를 보내고 있다면, Shopify 데이터 추적 단계에서 다른 소스에서 주문 완료 이벤트 보내기를 사용하여 스토어별로 이 이벤트를 끌 수 있습니다. 그러면 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_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 표준 속성

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

Shopify의 빈 값

Shopify가 사용자 속성에 빈 값을 보내는 경우, 고객 프로필에 이미 있는 값을 Braze가 유지할지 지울지 선택할 수 있습니다. Shopify 통합 설정의 Shopify가 빈 값을 보낼 때 고객 프로필에서의 동작에서 다음 중 하나를 선택하세요.

옵션 사용 시기
기존 값 유지 CRM의 전화번호처럼 다른 소스에서도 이 고객 프로필을 업데이트하는 경우에 적합합니다.
기존 값 지우기 Shopify가 신뢰할 수 있는 단일 소스여서 빈 값이 데이터가 삭제되었음을 의미하는 경우에 적합합니다.

이 설정은 Braze가 고객 프로필에서 동기화하는 표준 속성과 Shopify 커스텀 속성에 적용됩니다. 통합의 기본값은 기존 값 유지입니다. 예를 들어 전화번호가 CRM에서도 들어오는데 Shopify가 빈 전화번호를 보내면, CRM의 전화번호가 지워지지 않고 Braze 고객 프로필에 그대로 유지됩니다.

Shopify 고객 메타필드

Shopify 고객 메타필드에는 로열티 등급이나 고객이탈 위험 점수처럼 고객에 대해 직접 관리하는 데이터가 담깁니다. 표준 통합을 사용하면 최대 20개의 고객 메타필드 정의를 Braze 고객 프로필에 동기화하고, 이를 세분화와 개인화에 활용할 수 있습니다.

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

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

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

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

지원되는 메타필드 유형

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

Shopify 유형 프로필에 저장되는 형식
한 줄 텍스트, 여러 줄 텍스트, 색상, URL, ID 문자열
정수 정수
소수 숫자
참 또는 거짓 부울
날짜, 날짜 및 시간 시간(날짜 기반 Segment 필터 사용 가능)
한 줄 텍스트, 날짜, 날짜 및 시간, 색상, ID 또는 URL 목록 문자열 배열

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

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

값이 동기화되는 시점

소스 시점
Shopify의 customers/create 및 customers/update 웹훅 선택한 메타필드의 변경을 포함하여 Shopify에서 고객 정보가 변경될 때마다
과거 데이터 백필 설정 중에 메타필드를 선택하면 초기 고객 백필에 포함됨
기존 고객 연결된 스토어에 메타필드를 추가하면 Braze는 과거 고객 백필 기간 시작 이후(백필이 꺼져 있었다면 스토어 연결 이후) 업데이트된 고객의 고객 프로필에 해당 값을 동기화합니다. 이 작업이 진행되는 동안 통합 페이지에 기존 고객 프로필에 고객 메타필드 동기화 중이 표시되며, 완료될 때까지 선택기를 사용할 수 없습니다.

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

메타필드 변경 또는 제거

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

세분화 및 개인화

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

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

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

Shopify 주문 메타필드

Shopify 주문 메타필드에는 선물 메모나 주문 처리 선호 사항처럼 주문에 대한 자체 데이터가 저장됩니다. Shopify 표준 통합을 사용하면 선택한 주문 메타필드를 주문 이벤트에 추가할 수 있습니다. 메타필드가 이벤트에 표시되는 방식, 메타필드를 포함하는 이벤트, 지원되는 유형, 선택 항목을 변경하는 방법은 Shopify 주문 메타필드를 참조하세요.

SDK 데이터 수집

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

과거 데이터 백필

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

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 마케팅 구독
New Stuff!