# 이벤트 속성

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

이벤트 속성은 구매 금액, 상품명, 카테고리 등 이벤트의 맥락을 보완하는 데이터를 포함하며, 집계 기준 및 오디언스 조건 정의에 필수적으로 사용됩니다.

{% 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%2FCoyNP5DmYG9EhQbyFdrz%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.07.22.png?alt=media&#x26;token=73333b9b-a707-421c-b2f9-43ecfcfb0de0" alt=""><figcaption></figcaption></figure>

* 이벤트 속성은 특정 이벤트가 발생할 때 함께 전달되는 상세 데이터입니다.
* 예를 들어, `구매` 이벤트에는 `상품명`, `구매 금액`, `카테고리` 등의 속성이 포함될 수 있습니다.
* **속성명**은 개발 연동 시 사용되는 key 값입니다.
* **표기명**은 마케터가 콘솔에서 확인하는 이름입니다.
* **데이터 타입**은 해당 속성의 자료형(문자열, 숫자, 날짜 등)을 정의합니다. 자료형에 따라 필터 조건 및 연산 방식이 달라집니다.
* **유형** 및 **수집 상태**는 이벤트와 동일하게 `표준/커스텀` 및 `활성/비활성`으로 구분됩니다.

{% hint style="info" %}
상품과 관련된 속성은 `상품 <속성명>` 형식으로 구분되어 관리됩니다. (예: `상품 <브랜드>`, `상품 <배송정보>`)
{% endhint %}

{% 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%2FfGHNPlD8hxqLGdGNJoeH%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.12.01.png?alt=media&#x26;token=9dc27b73-4177-4418-a5e6-d14659e600d2" alt=""><figcaption></figcaption></figure>

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

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

### 2-1. 이벤트 상품 속성 추가하기

<figure><img src="https://3826783036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyROeODSgPulCgZ9LFAYn%2Fuploads%2FMNa6AdY53wsh4eqULvOq%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.16.08.png?alt=media&#x26;token=4a552ca5-1cd3-4e94-9dcc-67b587c0956c" alt=""><figcaption></figcaption></figure>

* 상품명, 카테고리 등 **상품 단위로 수집되는 속성**을 등록하고자 할 경우, **\[상품 하위 속성]** 체크박스를 활성화해 주세요.
* 해당 속성은 오디언스 및 리포트에서 **상품 단위로 분리**되어 활용됩니다.