Shopify 주문 메타필드
Shopify 표준 통합을 사용하면 선택한 주문 메타필드를 주문 이벤트에 추가할 수 있습니다. 주문 메타필드에는 선물 메모나 주문 처리 선호 사항처럼 주문에 관한 자체 데이터가 담겨 있습니다.
주문 메타필드 정의는 최대 20개까지 선택할 수 있습니다. Braze는 선택한 메타필드를 지원되는 Shopify 주문 이벤트에 기록하므로, 이를 세분화와 개인화에 활용할 수 있습니다.
이벤트에 주문 메타필드가 표시되는 방식
선택한 각 메타필드는 이벤트의 metadata 오브젝트에 <namespace>_<key> 형식으로 추가되며, metadata.tags와 같은 필드와 나란히 위치합니다. 예를 들어 Shopify 정의 custom.gift_note는 metadata.custom_gift_note로 표시됩니다.
{
"metadata": {
"order_number": "1234",
"tags": ["heavy", "heavy2"],
"custom_gift_note": "Happy birthday!"
}
}
주문 태그는 변경되지 않으며, Braze는 여전히 모든 태그를 이벤트에 전송합니다. 비어 있는 메타필드 값은 생략됩니다.
지원되는 주문 메타필드 유형
다음 유형의 정의만 선택 목록에 표시됩니다. 참조, 파일, JSON, 금액, 평점 유형은 제공되지 않습니다.
| Shopify 유형 | 이벤트에 저장되는 형식 |
|---|---|
| 한 줄 텍스트, 여러 줄 텍스트, 색상, URL, ID | 문자열 |
| 정수 | 정수 |
| 소수 | 숫자 |
| 참 또는 거짓 | 부울 |
| 날짜, 날짜 및 시간 | UTC 기준 ISO 8601 문자열. 시간이 없는 날짜는 UTC 자정으로 설정됩니다. |
| 한 줄 텍스트, 날짜, 날짜 및 시간, 색상, ID 또는 URL 목록 | 문자열 배열 |
다음과 같은 경우 Braze는 이벤트에서 해당 값을 생략합니다.
- 문자열 값 또는 목록의 항목이 255자를 초과하는 경우
- 값을 정의의 유형으로 변환할 수 없는 경우(예: 정수 필드에 텍스트가 있는 경우)
- 키(
<namespace>_<key>)가 255자를 초과하거나$또는.를 포함하는 경우 - 키가
order_number또는 Shopify Markets 필드처럼 Braze가 이미 이벤트에 기록하는 속성정보와 겹치는 경우
지원되는 이벤트
다음 이벤트는 선택한 주문 메타필드를 metadata에 포함합니다.
- 주문 완료(
ecommerce.order_placed) - 주문 취소(
ecommerce.order_cancelled) shopify_paid_ordershopify_fulfilled_ordershopify_partially_fulfilled_order
주문 환불(ecommerce.order_refunded) 및 결제 이벤트에는 주문 메타필드가 포함되지 않습니다.
Braze가 주문 메타필드를 포함하는 시점
| 소스 | 설명 |
|---|---|
| Shopify 주문 웹훅 | 값은 Shopify가 주문 웹훅을 전송하는 시점의 메타필드 스냅샷입니다. 이벤트는 전송된 후에 다시 작성되지 않습니다. |
| 과거 데이터 백필 | 초기 설정 중에 주문 메타필드를 선택하고 과거 데이터 백필이 켜져 있으면, 백필된 주문에 선택한 메타필드가 포함됩니다. |
선택 항목 변경은 변경 이후에 들어오는 주문에만 적용됩니다. 과거 주문은 다시 동기화되지 않습니다.
메타필드 변경 또는 제거
- 통합 페이지에서 설정 편집을 선택합니다.
- Shopify 데이터 추적 단계에서 추가 주문 이벤트 설정 표시를 엽니다.
- 주문 이벤트에 주문 메타필드 추가를 업데이트합니다. 체크박스를 해제하면 선택 항목이 지워집니다.
Shopify에서 정의를 삭제하면 Braze가 선택 항목에서 해당 정의를 자동으로 제거합니다. 이미 전송된 이벤트는 기존 값을 유지합니다.
세분화 및 개인화
주문 메타필드 값은 태그와 같은 위치인 metadata 아래의 이벤트 속성정보이므로, 현재 metadata.tags를 사용하는 것과 같은 방식으로 활용할 수 있습니다. 예를 들어 이 문서의 custom.gift_note 예시에서 {{event_properties.${metadata}.custom_gift_note}}는 Happy birthday!를 반환합니다.