# 자동 수집 이벤트 및 이벤트 속성

## 1. 자동 수집 이벤트

마켓탭은 Web/App SDK가 설치된 이후에 `mkt_session_start` 이벤트와 `mkt_first_visit` 이벤트를 자동으로 측정합니다.

### 1-1. 세션 시작 이벤트 (mkt\_session\_start)

마켓탭 SDK는 유저의 마지막 활동 시각을 기록해둡니다. 어떤 유저가 

1. 이벤트를 일으켰을 때 마지막 활동 시각이 없거나, 
2. 30분 이상이 지났다면

`mkt_session_start` 이벤트를 함께 측정합니다.

### 1-2. 첫 방문 이벤트 (mkt\_first\_visit)

마켓탭 SDK는 유저의 첫 방문여부를 추적합니다. 특정 기기에서 (SDK설치 이후 기준) 처음으로 이벤트를 발생시켰다면, `mkt_first_visit` 이벤트를 함께 측정합니다.

### 1-3. 검색 이벤트 (mkt\_search)

마켓탭은 Web 한정으로 검색 이벤트를 조건부 자동 추적합니다.

1. `mkt_page_view` 이벤트가 기록 될 때,
2. `'q', 's', 'search', 'query', 'searchInput', 'queryInput', 'keyword'` 쿼리파라미터가 포함된 경우

`mkt_search` 이벤트를 함께 측정하며 `mkt_search_query` 속성에 해당 쿼리파라미터의 값을 함께 기록합니다.

### 1-4. 이탈 감지 이벤트 (mkt\_exit\_intent)

마켓탭은 PC Web 환경 한정으로 이탈 감지 이벤트를 자동 추적합니다.

사용자의 마우스가 브라우저 상단 영역(주소창 / 닫기 버튼 방향)으로 이동할 경우,\
페이지를 이탈하려는 의도로 판단되어\
`mkt_exit_intent` 이벤트를 함께 측정합니다.

## 2. 자동 수집 이벤트 속성 (WEB)

마켓탭은 Web SDK에서 특정 속성들을 자동으로 기록해줍니다.

### 2-1. UTM 속성

마켓탭은 웹에서 이벤트가 일어날때, 해당 이벤트가 일어난 웹 페이지의 URL에 GA4에서 사용되는 UTM 속성이 쿼리파라미터에 포함된 경우, 해당 값을 이벤트 속성 하위에 자동으로 추가합니다.

* [관련 구글 문서](https://support.google.com/analytics/answer/10917952?sjid=9839741059780465995-NC)

| 이벤트 속성             | 설명         | 쿼리 파라미터       |
| ------------------ | ---------- | ------------- |
| mkt\_utm\_campaign | UTM 캠페인 이름 | utm\_campaign |
| mkt\_utm\_medium   | UTM 미디어 소스 | utm\_medium   |
| mkt\_utm\_source   | UTM 소스     | utm\_source   |
| mkt\_utm\_term     | UTM 검색어    | utm\_term     |
| mkt\_utm\_content  | UTM 콘텐츠 이름 | utm\_content  |

### 2-2. Page 속성

마켓탭은 웹에서 이벤트가 일어날 때, 해당 이벤트가 일어난 웹 document의 값을 기반으로 아래 속성을 자동으로 추가합니다.

<table><thead><tr><th width="186.4375">이벤트 속성</th><th width="198.1875">설명</th><th>Document 값</th></tr></thead><tbody><tr><td>mkt_page_path</td><td>조회된 페이지의 경로</td><td>url에서 파싱 (예: <code>/product_list/product1</code>)</td></tr><tr><td>mkt_page_domain</td><td>조회된 페이지의 도메인</td><td>url에서 파싱 (예: <code>marketap.io</code>)</td></tr><tr><td>mkt_page_url</td><td>조회된 페이지의 전체 URL</td><td><a href="https://developer.mozilla.org/ko/docs/Web/API/Document/URL">document.URL</a></td></tr><tr><td>mkt_page_title</td><td>조회된 페이지의 제목</td><td><a href="https://developer.mozilla.org/en-US/docs/Web/API/Document/title">document.title</a></td></tr><tr><td>mkt_page_uri</td><td>URI 경로</td><td><a href="https://developer.mozilla.org/ko/docs/Web/API/Document/documentURI">document.documentURI</a></td></tr><tr><td>mkt_page_params</td><td>페이지의 쿼리 파라미터</td><td>url에서 파싱 (예: <code>?key1=value1&#x26;key2=value2</code>)</td></tr><tr><td>mkt_page_referrer</td><td>페이지의 리퍼러</td><td><a href="https://developer.mozilla.org/en-US/docs/Web/API/Document/referrer">document.referrer</a></td></tr></tbody></table>