이벤트 속성

이 페이지에서는 마켓탭의 이벤트 속성에 대해 안내합니다.

커스텀 속성

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

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

커스텀 속성을 사용할 때는 반드시 Marketap 콘솔의 텍소노미에서 해당 속성을 정의하세요. 콘솔에 정의되지 않은 커스텀 속성은 분석 및 세그먼트 생성에서 무시됩니다. 반드시 텍소노미 개요 페이지에서 안내한 내용에 따라 프로젝트에 설정된 속성을 확인해주세요.

이벤트 아이템 속성은 이벤트 속성과 구분되는 값입니다. 사용자 가이드에서 이벤트 속성 연동 방법을 정확하게 확인해주세요.

기본 이벤트 속성

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

UTM 관련 속성

이벤트 속성 이름	설명	타입
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

세션 관련 속성

이벤트 속성 이름	설명	타입
mkt_session_id	세션 고유 ID	STRING

전환 관련 속성

이벤트 속성 이름	설명	타입
mkt_revenue	이벤트와 관련된 매출 금액	DOUBLE

웹 SDK의 경우 UTM, 페이지 관련 속성이 자동으로 이벤트 속성에 포함됩니다. 개발자는 추가적으로 해당 속성을 연동하지 않아도 됩니다. (자동 수집 속성 관련 문서)

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

이벤트 아이템 속성

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

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