데이터 소개

mAsh API 데이터를 소개합니다.

데이터 구분

매쉬 API는 크게 네 가지 분류로 구성되어 있으며, 해당 구조를 간단히 표로 정리하면 다음과 같습니다.

항목	설명
인증 토큰	유저 정보를 인증하기 위한 API입니다. 인증에 성공해야 데이터를 호출할 수 있습니다.
메타 데이터	분석 중인 매장 목록과 매장 내 설정된 라인/구역에 대한 정보를 조회하기 위한 API입니다.
기본 통계 이벤트	동선 추적이 진행되지 않은 방문객 카운트 데이터를 조회하기 위한 API입니다.
방문객 행동 이벤트	동선 추적이 완료된, 개별 방문객의 매장 내 행동 데이터를 조회하기 위한 API입니다.

메타 데이터

데이터 검색 조건 및 서비스 구성을 위해 필요한 부가 정보를 다룹니다.

mAsh 서비스의 '매장'은 실제 상점을 가리키며, 이곳은 고객들이 제품을 살펴보고 구입하는 장소입니다. mAsh는 이 매장 내에서 방문객 활동을 모니터링하고 분석하여 매장 운영을 최적화하고자 합니다.

매장은 하나 이상의 매장 구역과 라인을 포함할 수 있으며, CCTV 카메라가 설치되어 방문객 활동을 관찰하고 기록하는 지점입니다.

'구역'은 특정 영역을 가리키며, 이는 신발 섹션, 의류 부스 또는 레지스터 대기열과 같은 특정 지점을 의미합니다. mAsh를 통해 매장 구역을 정의하면 어떤 지역에서 가장 활발한 활동이 일어나는지 파악할 수 있습니다.

'라인'은 CCTV 화면 상에 그린 가상의 선으로, 방문객이 이 선을 교차할 때마다 자동으로 인식하여, 어느 방향으로 이동하였는지를 세게 됩니다. 예를 들면, 매장의 입구와 출구를 파악하는 데 유용하게 사용될 수 있습니다.

API로 제공되는 데이터는 다음과 같습니다. [👉 메타 데이터]

항목	설명
매장 목록	분석 중인 매장 목록 및 매장 정보를 조회합니다.
구역 목록	특정 매장 내에 설정된 구역(상품 매대) 목록 및 정보를 조회합니다.
입/퇴장(라인) 목록	특정 매장 내에 설정된 라인(방향 포함) 목록 및 정보를 조회합니다.
무방향 라인 목록	특정 매장 내에 설정된 라인(방향 미포함) 목록 및 정보를 조회합니다.

이벤트 데이터

영상 데이터를 분석하여 추출한 원본 수집 데이터입니다.

'이벤트'는 매장 내에서 고객의 특별한 활동을 기록한 것입니다. 매장 내에서 어떤 지역에서 어떤 활동이 발생했는지를 파악하기 위해 매장, 구역 및 라인 정보와 연관시킵니다. 예를 들어, 방문객이 '신발 섹션'에 들어가는 것은 '신발 섹션 진입' 이벤트로 기록되며, 이를 통해 어떤 구역에서 어떤 활동이 일어나고 있는지를 이해하고 최적화할 수 있습니다. 또한 라인 정보를 활용하여 매장 입구와 출구에서 방문객 이동을 추적하고 방문 패턴을 파악할 수 있습니다.

기본 통계 이벤트

동선 추적이 진행되지 않은 방문객 카운트 데이터를 조회하기 위한 API입니다. [👉 기본 통계 이벤트]

항목	설명
매장 방문	매장 방문 이벤트 목록 데이터를 조회합니다.
입/퇴장(라인) 방문	매장 내에 설정된 라인(방향 포함) 통과 이벤트 목록 데이터를 조회합니다.
구역 체류	매장 내에 설정된 구역 방문/체류 이벤트 목록 데이터를 조회합니다.

방문객 행동 이벤트

동선 추적이 완료된, 개별 방문객의 매장 내 행동 데이터를 조회하기 위한 API입니다. [👉 방문객 행동 이벤트]

항목	설명
매장 방문객 행동	개별 방문객의 매장 내 행동 데이터를 조회합니다.

데이터 활용

메타 데이터와 이벤트 데이터를 함께 활용하여 대시보드 서비스, 데이터 분석 기능을 직접 제작할 수 있습니다.