# Event 및 User 텍소노미 개요

## 1. 기본 개념

Marketap SDK는 고정된(Fixed) 스키마 기반으로 동작합니다.

즉, 콘솔을 통해 사전에 정의된 **이벤트(Event)**, **이벤트 속성(Event Properties)**, **사용자 속성(User Properties)** 만 수집 대상이 됩니다.

{% hint style="danger" %}
정의되지 않은 데이터는 SDK에서 수집되지 않으며, **데이터가 정상적으로 처리되지 않습니다.**
{% endhint %}

이를 통해 수집되는 모든 데이터는 분석 콘솔의 텍소노미(Taxonomy)와 자동으로 연결되며, 이후 조건 필터링, 세그먼트 구성, 캠페인 실행 등에 사용될 수 있습니다.

{% hint style="success" %}
**텍소노미(Taxonomy)**는 고객의 행동과 속성을 구조화하여 정의하는 체계이며, 이후 문서에서는 프로젝트에 정의된 이벤트, 이벤트 속성, 사용자 속성을 통칭하여 "**텍소노미**"라고 부르겠습니다.
{% endhint %}

## 2. 현재 텍소노미 확인하기

마켓탭 콘솔에 접속 후, 설정 > 고객 데이터 연동 탭 하위에서 현재 프로젝트에 설정된 텍소노미가 확인이 가능합니다.

<div data-full-width="false"><figure><img src="https://260547158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTQoY0rYrzNUQxhlUfYFm%2Fuploads%2F85TyfIz9GDDExFt9ZnS1%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-07-09%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.57.21.png?alt=media&#x26;token=846997af-272f-4b1b-aad4-ee76f7dcbf00" alt=""><figcaption></figcaption></figure></div>

콘솔에서 텍소노미를 직접 연동하는 자세한 방법은 아래 사용자 가이드를 참고해주세요.

{% content-ref url="<https://app.gitbook.com/s/yROeODSgPulCgZ9LFAYn/customer-data/taxonomy>" %}
[텍소노미](https://app.gitbook.com/s/yROeODSgPulCgZ9LFAYn/customer-data/taxonomy)
{% endcontent-ref %}

## 3. 이벤트와 이벤트 속성

**이벤트(Event)**&#xB294; 사용자의 특정 행동 자체를 의미합니다. 예를 들어, `회원가입`, `상품 조회`, `결제 완료`와 같은 행위가 이벤트에 해당합니다.

반면에 **이벤트 속성(Event Property)**&#xC740; 해당 이벤트가 발생했을 때 함께 수집되는 부가 정보입니다. 예를 들어 `상품 조회` 이벤트에는 `product_id`, `category`, `price` 등의 속성이 함께 수집될 수 있습니다.

즉, 이벤트는 **무엇을 했는가**, 이벤트 속성은 **어떤 맥락에서 했는가**를 설명하는 역할을 합니다.

<div><figure><img src="https://260547158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTQoY0rYrzNUQxhlUfYFm%2Fuploads%2FOFFDQFJt7XJ59VIVCyEE%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-07-09%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.57.54.png?alt=media&#x26;token=a1b65696-32c0-49b3-884d-c2849e27d82b" alt=""><figcaption><p>프로젝트에 정의되어있는 이벤트 목록</p></figcaption></figure> <figure><img src="https://260547158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTQoY0rYrzNUQxhlUfYFm%2Fuploads%2Fx7evehXtasYqIwcb3AoE%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-07-09%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.58.21.png?alt=media&#x26;token=c005dc6e-03c2-44aa-a299-ea33caecefac" alt=""><figcaption><p>프로젝트에 정의되어있는 이벤트 속성 목록</p></figcaption></figure></div>

프로젝트의 설정 페이지에서 확인이 가능하며, 마켓탭에서 기본으로 제공하는 값들은 `mkt_` 접두사(prefix)가 붙어져 있습니다.

## 4. 유저 속성

**사용자 속성(User Property)**&#xC740; 특정 시점에서 사용자가 가지고 있는 상태나 특성을 의미합니다. 예를 들어 `성별`, `나이`, `가입일`, `회원 등급`, `앱 푸시 수신 동의 여부`와 같은 정보가 여기에 해당합니다.

이벤트가 사용자의 **행동의 흐름(무엇을, 언제 했는가)**&#xC744; 기록한다면, 사용자 속성은 **현재 사용자가 어떤 상태에 있는가**를 설명합니다.\
즉, 이벤트는 시간에 따라 계속 쌓이는 **시계열 데이터**이고, 사용자 속성은 시점별로 유지되거나 갱신되는 **정적 데이터**입니다.

이 둘은 함께 사용되어 강력한 타겟팅과 분석이 가능해집니다. 예를 들어, “VIP 등급(사용자 속성)이면서 최근 7일 내 결제 완료(이벤트)를 한 사용자”와 같은 세그먼트를 정의할 수 있습니다.

<figure><img src="https://260547158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTQoY0rYrzNUQxhlUfYFm%2Fuploads%2FcsvRJyqWFQGz1fGZtLqD%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-07-09%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.59.04.png?alt=media&#x26;token=e45745f5-7015-422a-bd46-172b72b37bf7" alt=""><figcaption></figcaption></figure>

이벤트와 마찬가지로 마켓탭에서 기본으로 제공하는 값들은 `mkt_` 접두사가 붙어져 있습니다.

## 5. 마켓탭 제공 속성

Marketap에서는 프로젝트마다 커스텀 사용자 속성과 이벤트 속성을 자유롭게 정의할 수 있지만, **가능한 한 플랫폼에서 기본 제공하는 속성을 우선 활용하는 것을 권장**합니다. 그 이유는, Marketap의 **요약 분석 리포트, 대시보드, 퍼널, 리텐션 등 주요 분석 기능**이 기본 제공 속성을 기준으로 사전 설계되어 있기 때문입니다.&#x20;

예를 들어 `성별`, `나이`, `가입일`, `회원등급`, `mkt_revenue`, `mkt_items` 등의 속성을 기반으로 자동 필터, 집계, 시각화가 구성됩니다.

따라서 동일한 정보를 커스텀 속성으로 중복 정의하기보다는, 가능한 경우 **제공되는 스키마에 맞춰 연동**하면 분석 기능을 더 효과적으로 활용할 수 있습니다.

## 6. 이어서 진행하기

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>SDK를 통해 행동 및 유저 정보 수집하기</td><td><a href="sdk">sdk</a></td></tr><tr><td>데이터 연동 현황 확인하기</td><td><a href="validation/testing">testing</a></td></tr></tbody></table>