# 유저 속성

## 개요 <a href="#overview" id="overview"></a>

유저 속성은 성별, 생일, 가입일, 마케팅 수신 여부 등과 같이 프로필 기반의 조건 설정 및 [tag](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/campaign/common/tag "mention") 구성에 활용됩니다.

{% hint style="warning" %}
사전에 정의된 텍소노미는 **단순히 콘솔에서 설정을 마치는 것으로 끝나지 않으며**, 실제 데이터를 수집하기 위해서는 개발자의 연동 작업이 반드시 필요합니다.

즉, SDK 또는 API를 통해 실시간 이벤트 및 속성 데이터가 전송되어야 하며, 이를 위해 반드시 [Event 및 User 텍소노미 개요](https://app.gitbook.com/s/TQoY0rYrzNUQxhlUfYFm/taxonomy/overview "mention")를 기준으로 정의된 구조에 맞게 구현되어야 합니다.
{% endhint %}

## 1. 유저 속성 목록

<figure><img src="https://3826783036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyROeODSgPulCgZ9LFAYn%2Fuploads%2FLRUQBJxdLWto0T08Ot56%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-15%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%205.22.45.png?alt=media&#x26;token=e96e18a2-dd9c-463a-8420-2837813f394f" alt=""><figcaption></figcaption></figure>

* 유저 속성은 고객 프로필에 해당하는 고정 데이터로, 예를 들어 `성별`, `생일`, `가입일`, `마케팅 수신 여부` 등이 이에 해당합니다.
* [event-property](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/customer-data/taxonomy/event-property "mention")과 대부분 동일한 구조로 구성되며, **객체 목록** 타입으로 `장바구니`, `쿠폰` 등의 다중 값 데이터도 처리할 수 있습니다.

{% hint style="danger" %}
유저 속성은 **비활성화**되면 해당 유저 속성의 데이터는 더 이상 수집되지 않으며,\
이후 **오디언스, 캠페인 조건, 리포트** 등에서 사용할 수 없습니다.

비활성화 후 다시 **활성화**하더라도, **최대 1시간까지 데이터 수집이 지연**될 수 있으므로, 운영 중인 유저 속성의 상태 변경은 신중하게 진행해 주세요.
{% endhint %}

## 2. 유저 속성 추가하기

<figure><img src="https://3826783036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyROeODSgPulCgZ9LFAYn%2Fuploads%2FI56mbx0UTefkgjioM9Cs%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-15%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%205.27.26.png?alt=media&#x26;token=e611515e-877b-4eb5-8106-c091d53a3f04" alt=""><figcaption></figcaption></figure>

* 유저 속성 추가 시, 데이터 타입을 반드시 지정해야 하며, 이는 데이터 정합성 확보 및 조건 필터의 정확성을 위해 중요합니다.
* 예: 숫자형 속성에는 합계/평균/최소값/최대값 집계가 가능하며, 날짜형 속성에는 시간 조건 필터가 제공됩니다.

{% hint style="warning" %}
커스텀 유저 속성은 사용자가 직접 정의하는 유저 속성으로, `mkt_` 접두어를 사용할 수 없습니다.
{% endhint %}

{% hint style="info" %}
쿠폰, 장바구니와 같은 **객체 목록 타입의 유저 속성**은 시스템에 **사전 정의된 항목만 사용 가능**합니다.\
현재는 쿠폰, 장바구니 외의 **새로운 객체 목록 형태의 커스텀 유저 속성은 지원되지 않습니다.**
{% endhint %}