eCommerce 이벤트 사용 방법

eCommerce 추천 이벤트는 공유된 주문 수준 스키마를 사용하므로, Braze가 eCommerce 데이터를 기반으로 고객 프로필, 세분화, 메시징, 보고, AI 기반 추천 등 신뢰할 수 있는 기능을 구축할 수 있습니다. 이 문서의 각 섹션에서는 Braze에서 각 기능을 사용하는 방법을 다룹니다.

속성정보 요구 사항과 데이터 유형은 이벤트 스키마를, 이벤트 유효성 검사에 실패했을 때 발생하는 상황은 이벤트 유효성 검사 및 문제 해결을 참조하세요.

eCommerce 이벤트는 예측 가능한 스키마를 따르기 때문에, Braze는 매출 추적과 사전 구축된 Canvas 템플릿부터 AI 기반 추천까지 신뢰할 수 있는 기능을 구축할 수 있습니다. 다음 섹션에서는 각 기능에 대한 간략한 개요와 전체 설명서 링크를 제공합니다.

Commerce 탭

각 고객 프로필의 Commerce 탭은 주문 활동(계산된 매출 및 주문 측정기준)과 활성 장바구니(ecommerce.cart_updated 이벤트의 최신 장바구니)라는 두 가지 모듈을 결합합니다.

주문 활동

주문 활동 모듈은 이벤트가 처리될 때 실시간으로 업데이트되는 세 가지 계산 측정기준을 표시합니다. 이러한 계산의 주문 수준 모델은 제품 가격과 총 주문 금액을 깔끔하게 분리합니다.

측정기준	공식
총 매출	sum (order_placed.total_value) − sum (order_refunded.total_value)
총 주문 수	count (distinct order_placed) − count (distinct order_cancelled)
총 환불 금액	sum (order_refunded.total_value)

활성 장바구니

활성 장바구니 모듈은 고객 프로필의 최신 장바구니를 표시합니다. 이 뷰는 테스트 중에 특히 유용합니다. 장바구니 내용을 확인하거나, 장바구니 기반 여정을 검증하거나, ecommerce.cart_updated 이벤트가 프로필을 예상대로 업데이트하고 있는지 확인하는 데 사용할 수 있습니다.

활성 장바구니에는 다음이 포함됩니다:

• 장바구니 ID — 마지막으로 ecommerce.cart_updated 이벤트를 수신한 장바구니의 식별자입니다.
• 마지막 업데이트 — 가장 최근 장바구니 업데이트의 타임스탬프입니다.
• 총 장바구니 금액 — 현재 장바구니에 있는 라인 항목의 총 금액입니다.
• 제품 보기 — 장바구니에 있는 제품 목록을 여는 링크입니다(최대 50개 제품).

이커머스 오케스트레이션

세분화

Braze는 이커머스 데이터를 기반으로 사용자를 세분화하는 세 가지 방법을 제공합니다.

• 이커머스 필터: 세그먼터에서 eCommerce 카테고리를 사용하세요. 이 카테고리에는 이커머스 추천 이벤트를 기반으로 하는 필터(예: Last Order Placed, Total Revenue, Average Order Value)가 포함되어 있습니다. 사용 가능한 필터의 전체 목록은 Segment 필터를 참조하세요.
• 커스텀 이벤트 필터: 이커머스 이벤트는 커스텀 이벤트처럼 동작하므로 기존의 모든 커스텀 이벤트 필터를 바로 사용할 수 있습니다. 예를 들어 “Has performed custom event ecommerce.order_placed more than X times” 또는 “First performed custom event ecommerce.order_placed“로 필터링할 수 있습니다.
• 세그먼트 확장: 중첩된 제품 배열이나 메타데이터 객체 속성정보 등 중첩된 이벤트 속성정보를 기준으로 세분화하려면 중첩된 이벤트 속성정보 필터링과 함께 세그먼트 확장을 사용하세요. 이를 통해 “지난 90일 동안 제품 SKU-123을 구매한 사용자”와 같은 오디언스를 구축하거나, 같은 주문의 서로 다른 속성정보에 걸친 기준을 결합할 수 있습니다.

문서화된 이벤트 스키마에 포함되지 않은 커스텀 속성정보로 필터링해야 하는 경우, 이벤트를 기록할 때 해당 속성정보를 metadata 아래에 중첩하세요(예: color 대신 metadata.color). API 또는 SDK를 통해 보내는 커스텀 최상위 속성정보는 이벤트 데이터에 표시되더라도 확장 속성정보 필터에 유효하지 않습니다. 허용 목록에 없는 최상위 속성정보를 사용하면 확장을 저장하거나 보관 해제할 수 없습니다.

트리거

다른 커스텀 이벤트와 마찬가지로 Braze 전반에서 이커머스 이벤트와 함께 커스텀 이벤트 수행 트리거를 사용할 수 있습니다. 유기한 장바구니 플로우의 경우 Update Cart 트리거를 사용하여 장바구니 업데이트를 올바르게 캡처하세요.

또한 Braze는 전용 Place Order 트리거를 제공하므로 사용자가 주문할 때 여정을 시작하거나 작업을 수행할 수 있습니다. 자세한 내용은 실행 기반 전달을 참조하세요.

속성정보 필터

Place Order 및 Update Cart 트리거는 이벤트에 포함된 속성정보로도 필터링할 수 있으므로, 관심 있는 주문이나 장바구니에 대해서만 트리거가 실행됩니다.

• 기본 속성정보는 total_value 또는 currency와 같은 이벤트의 최상위 속성정보와 일치합니다.
• 중첩된 속성정보는 products 배열 내부를 확인합니다. 각 제품은 고유한 속성정보를 가지므로, products[].metadata.category는 주문 또는 장바구니의 제품 중 하나라도 조건을 충족하면 일치합니다.

커스텀 제품 필드는 metadata 아래에 중첩하세요(예: products[].metadata.brand). 이벤트 스키마에 포함되지 않은 제품 속성정보는 유효성 검사에 실패하므로, 해당 속성정보에 대한 필터는 절대 일치하지 않습니다.

예를 들어 total_value가 1000보다 큼과 products[].metadata.category가 shoes와 같음을 결합하면 신발이 포함된 고액 주문에 대해서만 트리거됩니다. 속성정보 필터가 도입되기 전에는 주문이 이루어진 것에 대해서는 트리거할 수 있었지만 주문에 무엇이 포함되었는지에 대해서는 트리거할 수 없었습니다.

속성정보 필터는 다음 영역에서 사용할 수 있습니다.

• Place Order: Campaign 및 Canvas 트리거, 예외 이벤트, Canvas 종료 기준, 작업 경로 단계, 전환 이벤트, 콘텐츠 카드 제거 이벤트. 기본 속성정보와 중첩된 속성정보가 모두 지원됩니다. 인앱 메시지 트리거에서는 Place Order가 기본 속성정보만 지원합니다.
• Update Cart: Campaign 및 Canvas 트리거, 예외 이벤트, Canvas 종료 기준, 작업 경로 단계. 기본 속성정보와 중첩된 속성정보가 모두 지원됩니다. 전환 이벤트, 콘텐츠 카드 제거 이벤트, 인앱 메시지 트리거에서는 Update Cart가 ecommerce.cart_updated 커스텀 이벤트를 기반으로 하며 기본 속성정보만 지원합니다.

인앱 메시지 트리거는 기기에서 평가되므로, 인앱 메시지에서는 Place Order로 특정 제품을 타겟팅하거나 중첩된 속성정보로 필터링할 수 없습니다. 작성기에서 Place order for specific product 옵션은 비활성화되어 있습니다. 특정 제품에 대해 작업을 수행하려면 다른 채널의 Campaign이나 Canvas를 대신 사용하세요.

특정 제품으로 주문 범위 지정

주문에 특정 제품이 포함된 경우에만 트리거하려면 Place Order 트리거에 중첩된 속성정보 필터를 추가하세요. 이 기능은 인앱 메시지 트리거에서는 사용할 수 없습니다.

목표	중첩된 속성정보 필터
제품 이름	products[].product_name이 값과 같음
제품 ID	products[].product_id가 값과 같음
제품 배리언트 ID	products[].variant_id가 값과 같음

제품 범위가 지정된 저장된 동작

속성정보 필터가 제공되기 전에 Place Order 동작을 구성했다면, 해당 동작은 여전히 Product Identifier(제품 이름, product_id 또는 variant_id)와 함께 Place order for specific product를 사용할 수 있습니다. 이렇게 저장된 동작은 계속 작동하며 이전과 똑같이 일치하므로 기존 Campaigns 및 Canvases에는 영향이 없습니다.

저장된 동작을 속성정보 필터로 전환하려면 Place any order를 선택하세요. 그러면 제품 범위 컨트롤이 속성정보 필터로 대체됩니다. 다음 표를 사용하여 동일한 범위를 다시 만드세요.

이전 Product Identifier	동등한 중첩된 속성정보 필터
제품 이름	products[].product_name이 값과 같음
제품 ID	products[].product_id가 값과 같음
제품 배리언트 ID	products[].variant_id가 값과 같음

Liquid 개인화

이커머스 이벤트는 커스텀 이벤트와 같은 방식으로 Liquid 개인화를 지원하므로, 메시징에서 이벤트 속성정보를 직접 참조할 수 있습니다. 제품 이미지, 가격 또는 기타 카탈로그 데이터를 메시지로 가져오려면 product_id 또는 variant_id를 연결 식별자로 사용하여 카탈로그를 이벤트와 조인하세요. {% shopping_cart %} Liquid 태그를 사용하면 사용자의 현재 장바구니 내용을 반복 처리하여 유기한 장바구니 리마인더, 결제 유도 메시지 또는 주문 확인 메시지를 만들 수 있습니다. 바로 사용할 수 있는 코드 샘플은 이커머스 사용 사례를 참조하세요.

코드 없이 사용할 수 있는 대안으로 드래그 앤 드롭 제품 블록을 얼리 액세스 프로그램에서 이용할 수 있습니다.

이커머스 Canvas 템플릿

Braze는 이커머스 추천 이벤트가 항목, 종료, 전환 기준으로 미리 구성된 바로 사용 가능한 Canvas 템플릿을 제공하므로, 커스텀 설정 없이 라이프사이클 플로우를 시작할 수 있습니다. 각 템플릿에는 드래그 앤 드롭 이메일 디자인이 포함되어 있으며 드래그 앤 드롭 제품 블록(현재 얼리 액세스 단계)을 지원합니다. 자세한 사용 사례와 Liquid 예시는 이커머스 사용 사례를 참조하세요.

이 템플릿은 가장 일반적인 이커머스 라이프사이클 플로우를 다룹니다. 템플릿을 출발점으로 삼아 오디언스에 맞게 타이밍, 채널, 크리에이티브를 커스텀하세요.

• abandoned browse
• abandoned cart
• abandoned checkout
• order confirmation and survey

템플릿 커스텀

이 템플릿은 출발점으로 사용하도록 설계되었습니다. 일반적인 커스텀 방법은 다음과 같습니다.

• 이메일 커스텀: 각 템플릿에는 드래그 앤 드롭 편집기로 만든 사전 구성된 이메일이 포함되어 있으며, 브랜드와 콘텐츠에 맞게 자유롭게 편집할 수 있습니다.
• 채널 추가: 이메일을 푸시, SMS 또는 인앱 메시지와 함께 사용하여 크로스채널 효과를 강화하세요.
• 지연 및 결정 분할 추가: 행동(예: 고액 장바구니와 저액 장바구니 비교)에 따라 사용자를 분기하거나 메시지 사이에 대기 기간을 두세요.
• 크리에이티브 교체: 포함된 이메일 템플릿을 브랜드의 비주얼 스타일로 교체하세요.
• 제품 블록 사용: 드래그 앤 드롭 제품 블록(얼리 액세스 프로그램)을 사용하면 커스텀 Liquid를 작성하지 않고도 유기한 장바구니 내용이나 둘러본 제품을 동적으로 렌더링할 수 있습니다.

Liquid 개인화 예시를 포함한 고급 라이프사이클 전략은 이커머스 사용 사례를 참조하세요.

이커머스 보고

이커머스 권장 이벤트는 고객이 이미 사용 중인 매출 관련 화면에 그대로 반영됩니다. 통합에서 이커머스 이벤트를 전송하면 다음 보고서에 이커머스 매출이 자동으로 포함됩니다.

보고서	표시 내용
매출 보고서	선택한 기간과 앱을 기준으로 모든 소스의 총 매출, 일평균 매출, 일별 구매 수, 시간 경과에 따른 사용자당 매출을 보여줍니다.
매출 - 최종 접점 기여도 대시보드	사용자가 주문하기 전에 마지막으로 상호작용한 Campaign 또는 Canvas에 기여한 매출을 보여줍니다. 접점 이벤트에는 이메일 클릭, 푸시 열람, 콘텐츠 카드 클릭, 인앱 메시지 클릭, 단문 메시지 서비스(SMS) 또는 WhatsApp 단축 링크 클릭이 포함됩니다.
Campaign 및 Canvas 분석	주요 전환 기간 내에 특정 Campaign 또는 Canvas에 기여한 총 매출을 보여줍니다.
전환 보고서	Campaigns 및 Canvases의 전환 이벤트와 연결된 매출을 보여줍니다. ecommerce.order_placed 매출을 집계하려면 Campaign 또는 Canvas에서 Places Order 전환 이벤트 유형을 사용해야 합니다. 자세한 내용은 전환 이벤트를 참조하세요.
세그먼트 인사이트	세그먼트 인사이트 대시보드에서 Segments 간 매출을 비교합니다.
보고서 빌더	보고서 빌더에서 생성한 커스텀 보고서의 매출 측정기준을 보여줍니다.
대시보드 빌더	대시보드 빌더에서 생성한 커스텀 대시보드의 매출 측정기준을 보여줍니다.

사용자 단위가 아닌 계산 필드(예: Campaign 또는 Canvas 매출)의 경우, 매출은 모든 보고서에서 동일한 방식으로 계산됩니다. 주문에 포함된 제품별로 price에 quantity를 곱한 값을 각 order_placed 이벤트의 모든 제품에 대해 합산합니다.

BrazeAI^TM

예측 이벤트, 예측 이탈, 아이템 추천은 이커머스 이벤트를 타겟 이벤트 및 신호로 지원하며, 전용 “Order Placed” 옵션을 제공합니다. 표준화된 스키마 덕분에 사용자 기반 전체에서 데이터가 일관되므로 이러한 모델의 신뢰도가 높아집니다.

데이터 내보내기

Braze는 데이터 웨어하우스, BI 도구 또는 다운스트림 시스템에서 사용할 수 있도록 이커머스 이벤트 데이터를 내보내는 여러 방법을 제공합니다. 이커머스 권장 이벤트는 다른 이벤트 데이터와 동일한 경로로 내보내집니다.

내보내기 경로	포함 내용
Currents	이커머스 이벤트는 커스텀 이벤트로 스트리밍되며, ecommerce.* 네임스페이스를 검색하여 찾을 수 있습니다. 각 주문의 제품은 구매로 제공됩니다.
Snowflake 데이터 공유	이커머스 이벤트는 커스텀 이벤트로 공유되며, ecommerce.* 네임스페이스를 검색하여 찾을 수 있습니다. 각 주문의 제품은 구매 테이블에서 확인할 수 있습니다.
Segment 데이터를 CSV로 내보내기	Segment 멤버를 CSV로 내보냅니다. 이커머스 이벤트를 포함하려면 커스텀 이벤트 드롭다운에서 이름으로 선택하세요.
Segment별 고객 프로필 내보내기(API)	Segment 멤버의 고객 프로필 데이터를 API를 통해 반환합니다. 이커머스 이벤트는 커스텀 이벤트로 포함됩니다.

특정 제품을 기준으로 사용자를 세분화하려면 어떻게 해야 하나요?

세그먼트 생성기를 사용하면 사용자가 이커머스 이벤트를 수행한 횟수로 필터링할 수 있습니다. 특정 제품 속성(예: product_id 또는 product_name)으로 필터링하려면 중첩된 이벤트 속성정보 필터링을 지원하는 세그먼트 확장을 사용하세요. 예를 들어 지난 90일 동안 제품 “SKU-123”을 구매한 모든 사용자를 찾을 수 있습니다.