데이터 구조
디렉터리 구분
meta (메타데이터)와 event (이벤트 데이터) 두 가지 최상위 폴더로 구성됩니다.
| 폴더 | 설명 |
|---|---|
/meta | 검색 조건·설정에 필요한 메타데이터 |
/event | 영상 분석으로 추출한 원본 이벤트 데이터를 날짜별로 저장 |
- 기본적으로 제공되는 데이터는 사용자와의 협의를 바 탕으로 선택적으로 전달합니다.
- 필요 시 고객 요구에 맞춘 커스텀 이벤트 데이터를 추가 제공할 수 있습니다.
- 전송 방법(SFTP/S3 등), 파일 포맷(기본: CSV), 스키마 및 전달 주기 등은 계약·협의를 통해 결정합니다.
/meta
/meta 폴더는 메타데이터를 저장합니다. 검색 조건이나 서비스 설정에 필요한 추가 정보를 제공합니다.
파일 경로 규칙
/meta/{테이블}.csv
테이블 구분
| 구분 | 설명 |
|---|---|
| place | 매장 |
| zone | 구역 |
| line | 라인 |
| no_direction_line | 무방향 라인 |
| event_source_group | 이벤트 소스 그룹 |
| event_source_group_zones | 이벤트 소스 그룹의 구역 정보 |
| event_source_group_lines | 이벤트 소스 그룹의 라인 정보 |
예시
/meta/place.csv
/event
/event 폴더에는 영상 분석에서 추출한 원본 이벤트 데이터를 날짜별로 저장합니다.
파일 경로 규칙
/event/{매장태그}/{테이블}/{YYYY-MM-DD}.csv
- 매장 태그:
meta/place테이블의tag값 - 날짜:
YYYY-MM-DD형식
테이블 구분
| 구분 | 설명 |
|---|---|
| place/visit | 매장 방문 통계 이벤트 |
| place/visit_group | 매장 그룹 방문 통계 이벤트 |
| place/residence | 매장 체류 통계 이벤트 |
| line/visit | 라인 방문 통계 이벤트 |
| zone/residence | 구역 체류 통계 이벤트 |
| person/behavior | 방문객 행동 이벤트 |
| zone/behavior | 구역 방문객 행동 이벤트 |
| line/behavior | 라인 방문객 행동 이벤트 |
예시
/event/mayi/place/visit/2023-09-03.csv