데이터 레퍼런스
정보
블럭스는 연동된 데이터를 행동 데이터(events) / 유저 데이터(blux_users) / 상품 데이터(items) 세 테이블로 보관합니다.
오디언스 필터, 분석 페이지, 블럭스 에이전트의 분석이 모두 이 데이터를 기준으로 동작합니다.
행동 데이터 — events
유저의 행동과 메시지 반응이 이벤트 단위로 쌓입니다. 시간 기준 컬럼은 captured_at(UTC 저장, 화면에는 KST로 표시)입니다.
| 컬럼 | 설명 |
|---|---|
_id | 행 고유 ID |
application_id | 애플리케이션 ID |
blux_user_id | 블럭스 내부 유저 ID (blux_users._id와 연결) |
user_id | 고객사 유저 ID (SDK로 전달한 값) |
device_id | 디바이스 ID |
captured_at | 이벤트 발생 시각 |
event_type | 이벤트 종류 — 전체 목록은 필터 조건 설정하기 참고 |
event_properties | 이벤트 종류별 속성 (JSON) |
custom_event_properties | SDK로 전달한 커스텀 이벤트 속성 (JSON) |
url | 이벤트가 발생한 페이지 URL |
ref | 유입 경로 URL |
click_target | 클릭 대상 (버튼 URL·딥링크) |
page / section | 이벤트가 발생한 페이지·섹션 이름 |
prev_page / prev_section | 직전 페이지·섹션 이름 |
price | 이벤트에 담긴 상품 가격 |
order_id | 주문 ID |
order_amount | 할인 전 주문 금액 |
paid_amount | 실제 결제 금액 |
item_id | 상품 ID |
position | 목록·캐러셀에서의 상품 위치 |
rating | 평점 (리뷰 이벤트 등) |
search_query | 검색어 |
recommendation_id | 상품을 노출시킨 추천 ID |
notification_id | 연관된 발송 메시지 ID |
notification_platform | 메시지가 전달된 플랫폼 (ios / android / browser) |
notification_scheduled_at | 메시지 발송 예정 시각 |
campaign_id / task_id | 연관된 캠페인·발송 작업 ID |
inapp_id | 연관된 인앱 메시지 ID |
scenario_id / scenario_node_id | 연관된 시나리오·시나리오 노드 ID |
유저 데이터 — blux_users
유저 한 명이 한 행입니다. 개인정보 컬럼은 조회 시 마스킹되어 반환됩니다.
| 컬럼 | 설명 |
|---|---|
_id | 블럭스 내부 유저 ID (events.blux_user_id와 연결) |
application_id | 애플리케이션 ID |
user_id | 고객사 유저 ID (SDK로 전달한 값) |
user_properties | 표준 유저 속성 (JSON) — 대부분 아래 개별 컬럼으로도 제공 |
custom_user_properties | SDK로 전달한 커스텀 유저 속성 (JSON) |
devices | 유저의 디바이스 목록 (JSON — 푸시 토큰, 플랫폼 등) |
name | 이름 (가운데 글자 마스킹, 예: 홍*동) |
phone_number | 전화번호 (가운데 4자리 마스킹) |
email_address | 이메일 (로컬 파트 마스킹, 예: jo***e@gmail.com) |
birthday | 생년월 (연-월까지만, 예: 1990-05) |
gender / age | 성별 / 연령 |
group_name | 고객사 회원 등급·그룹 이름 |
blux_user_tier | 블럭스 유저 등급 (충성·우수·일반·잠재 유저, 매일 재산정) |
marketing_notification_consent | 마케팅 수신 동의 (전체) |
marketing_notification_sms_consent | SMS 수신 동의 |
marketing_notification_email_consent | 이메일 수신 동의 |
marketing_notification_kakao_consent | 카카오톡 수신 동의 |
marketing_notification_push_consent | 앱 푸시 수신 동의 |
nighttime_notification_consent | 야간 수신 동의 |
is_all_notification_blocked | 전체 수신 차단 여부 |
signup_date | 가입 시각 |
last_login_date | 마지막 로그인 시각 |
last_active_at | 마지막 활동 시각 |
first_order_at / last_order_at | 첫 구매 / 마지막 구매 시각 |
last_cartadd_at | 마지막 장바구니 담기 시각 |
last_like_at | 마지막 좋아요 시각 |
sample_key | 유저별 고정 난수 — 같은 조건이면 항상 같은 유저가 뽑히는 표본 추출에 사용 |
상품 데이터 — items
상품 카탈로그입니다. 카테고리는 최대 3단계까지 보관됩니다.
| 컬럼 | 설명 |
|---|---|
_id | 행 고유 ID |
application_id | 애플리케이션 ID |
item_id | 상품 ID |
item_name | 상품 이름 |
item_properties | 표준 상품 속성 (JSON) — 대부분 아래 개별 컬럼으로도 제공 |
custom_item_properties | SDK·카탈로그로 전달한 커스텀 상품 속성 (JSON) |
brand_id / brand_name | 브랜드 ID / 이름 |
category_id_1~3 / category_name_1~3 | 1~3차 카테고리 ID / 이름 |
price | 현재 판매가 |
retail_price | 정가 |
image_url / item_url | 상품 이미지 / 상세 페이지 URL |
click_counts | 누적 클릭 수 |
purchase_counts | 누적 구매 수 |
커스텀 속성
custom_event_properties / custom_user_properties / custom_item_properties에는 애플리케이션이 SDK·카탈로그 연동으로 보낸 속성이 보낸 이름 그대로 저장됩니다. 어떤 키가 있는지는 애플리케이션마다 다르며, 콘솔의 데이터 페이지에서 확인할 수 있습니다.
이벤트 종류별로 함께 들어오는 표준 속성은 필터 조건 설정하기, 데이터 전송 방법은 이벤트 데이터 API를 참고하세요.