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

이 페이지에서는 Marketap SDK가 자동으로 수집하는 이벤트 및 이벤트 속성에 대해서 안내합니다.

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 속성이 쿼리파라미터에 포함된 경우, 해당 값을 이벤트 속성 하위에 자동으로 추가합니다.

• 관련 구글 문서

이벤트 속성	설명	쿼리 파라미터
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의 값을 기반으로 아래 속성을 자동으로 추가합니다.

이벤트 속성	설명	Document 값
mkt_page_path	조회된 페이지의 경로	url에서 파싱 (예: /product_list/product1)
mkt_page_domain	조회된 페이지의 도메인	url에서 파싱 (예: marketap.io)
mkt_page_url	조회된 페이지의 전체 URL	document.URL
mkt_page_title	조회된 페이지의 제목	document.title
mkt_page_uri	URI 경로	document.documentURI
mkt_page_params	페이지의 쿼리 파라미터	url에서 파싱 (예: ?key1=value1&key2=value2)
mkt_page_referrer	페이지의 리퍼러	document.referrer