# 이벤트 속성

## 커스텀 속성 <a href="#custom-property" id="custom-property"></a>

비즈니스의 고유한 요구를 충족하기 위해 **커스텀 속성**을 설정할 수 있습니다. 커스텀 속성은 콘솔에서 생성 후, 기본 속성과 동일한 방식으로 사용이 가능합니다.

{% hint style="success" %}
마켓탭은 후술할 내용처럼, 기본 이벤트 속성을 제공하고 있습니다. 필요한 속성이 이미 제공중인지 확인한 뒤 필요한 경우에 사용해주세요.
{% endhint %}

{% hint style="danger" %}
커스텀 속성을 사용할 때는 반드시 Marketap 콘솔의 텍소노미에서 해당 속성을 정의하세요. **콘솔에 정의되지 않은 커스텀 속성**은 분석 및 세그먼트 생성에서 **무시**됩니다. 반드시 [텍소노미 개요 페이지](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/taxonomy/overview)에서 안내한 내용에 따라 프로젝트에 설정된 속성을 확인해주세요.
{% endhint %}

{% hint style="danger" %}
이벤트 아이템 속성은 이벤트 속성과 구분되는 값입니다. [사용자 가이드](https://app.gitbook.com/s/yROeODSgPulCgZ9LFAYn/customer-data/taxonomy/event-property)에서 이벤트 속성 연동 방법을 정확하게 확인해주세요.
{% endhint %}

## 기본 이벤트 속성 <a href="#predefined-event-property" id="predefined-event-property"></a>

Marketap SDK는 아래와 같은 **기본 이벤트 속성**을 제공합니다.&#x20;

### UTM 관련 속성 <a href="#utm" id="utm"></a>

| 이벤트 속성 이름          | 설명         | 타입     |
| ------------------ | ---------- | ------ |
| mkt\_utm\_campaign | UTM 캠페인 이름 | STRING |
| mkt\_utm\_medium   | UTM 미디어 소스 | STRING |
| mkt\_utm\_source   | UTM 소스     | STRING |
| mkt\_utm\_term     | UTM 검색어    | STRING |
| mkt\_utm\_content  | UTM 콘텐츠 이름 | STRING |

### 페이지 관련 속성

| 이벤트 속성 이름           | 설명              | 타입     |
| ------------------- | --------------- | ------ |
| mkt\_page\_path     | 조회된 페이지의 경로     | STRING |
| mkt\_page\_domain   | 조회된 페이지의 도메인    | STRING |
| mkt\_page\_url      | 조회된 페이지의 전체 URL | STRING |
| mkt\_page\_title    | 조회된 페이지의 제목     | STRING |
| mkt\_page\_uri      | URI 경로          | STRING |
| mkt\_page\_params   | 페이지의 쿼리 파라미터    | STRING |
| mkt\_page\_referrer | 페이지의 리퍼러        | STRING |

### 세션 관련 속성 <a href="#session" id="session"></a>

| 이벤트 속성 이름        | 설명       | 타입     |
| ---------------- | -------- | ------ |
| mkt\_session\_id | 세션 고유 ID | STRING |

### 전환 관련 속성 <a href="#conversion" id="conversion"></a>

| 이벤트 속성 이름    | 설명             | 타입     |
| ------------ | -------------- | ------ |
| mkt\_revenue | 이벤트와 관련된 매출 금액 | DOUBLE |

{% hint style="success" %}
웹 SDK의 경우 UTM, 페이지 관련 속성이 자동으로 이벤트 속성에 포함됩니다. 개발자는 추가적으로 해당 속성을 연동하지 않아도 됩니다. ([자동 수집 속성 관련 문서](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/taxonomy/sdk/event/auto-collect))
{% endhint %}

{% hint style="warning" %}
`mkt_revenue`의 경우 매출 집계, 전환율, ROAS등을 측정하는데 사용되는 중요한 지표입니다. 커스텀 필드를 사용하는 경우에도 매출이 일어난 경우 `mkt_revenue` 필드에 매출 금액을 전달해야 합니다.
{% endhint %}

### 이벤트 아이템 속성 <a href="#event-item" id="event-item"></a>

Marketap SDK는 이벤트와 관련된 아이템 목록의 추적을 위해 아래와 같은 **기본 이벤트 아이템 속성**을 제공합니다.

<table><thead><tr><th>아이템 속성 이름</th><th width="324">설명</th><th>타입</th></tr></thead><tbody><tr><td>mkt_product_id</td><td>상품의 고유 ID</td><td>STRING</td></tr><tr><td>mkt_product_name</td><td>상품 이름</td><td>STRING</td></tr><tr><td>mkt_product_price</td><td>상품 가격</td><td>DOUBLE</td></tr><tr><td>mkt_quantity</td><td>구매한 상품의 수량</td><td>INT</td></tr><tr><td>mkt_discount</td><td>상품에 적용된 할인 금액</td><td>DOUBLE</td></tr><tr><td>mkt_category1</td><td>상품 카테고리 1</td><td>STRING</td></tr><tr><td>mkt_category2</td><td>상품 카테고리 2</td><td>STRING</td></tr><tr><td>mkt_category3</td><td>상품 카테고리 3</td><td>STRING</td></tr><tr><td>mkt_category4</td><td>상품 카테고리 4</td><td>STRING</td></tr><tr><td>mkt_category5</td><td>상품 카테고리 5</td><td>STRING</td></tr><tr><td>mkt_brand</td><td>상품의 브랜드</td><td>STRING</td></tr><tr><td>mkt_variant</td><td>상품 세부 선택사항 (예: 사이즈, 추가옵션 등)</td><td>STRING</td></tr><tr><td>mkt_option_price</td><td>옵션추가로 인한 가격</td><td>DOUBLE</td></tr><tr><td>mkt_created_datetime</td><td>상품을 추가한 시간</td><td>DATETIME</td></tr><tr><td>mkt_bundle_info</td><td>상품에 포함된 번들 정보</td><td>STRING</td></tr><tr><td>mkt_shipping_info</td><td>상품의 배송 정보</td><td>STRING</td></tr></tbody></table>