파라미터의 수준(level)

① 파라미터의 수준이란?

‘파라미터(parameter)’는 이벤트와 같이 따라가는 부가 정보입니다. 형식은 ‘이름 : 값’의 한 쌍입니다 — 예를 들어 사용자가 GNB의 ‘쇼핑’ 메뉴를 클릭했다면 gnb_label : '쇼핑'이라는 한 쌍을 그 클릭 이벤트와 함께 전송합니다.

그런데 GA4에는 한 가지 더 중요한 차원이 있습니다 — 같은 파라미터라도 ‘어디에 매달리는가’가 다르다는 것. 매달릴 수 있는 자리가 셋 — 이벤트 레벨·사용자 레벨·아이템 레벨입니다. 이것을 ‘파라미터의 수준(scope)’이라고 부릅니다.

어떤 정보를 어느 레벨에 두느냐는 단순한 표기상의 선택이 아닙니다. 같은 ‘쿠폰’이라는 이름의 파라미터도 이벤트 레벨에 두면 ‘주문 전체’의 쿠폰이 되고 아이템 레벨에 두면 ‘상품 한 개’의 쿠폰이 됩니다. 코드를 짜기 전에 ‘이 정보는 어느 레벨이어야 하는가’부터 정해야 분석에서 길이 막히지 않습니다.

② 세 자리 한눈 비교

같은 ‘부가 정보’라도 셋 중 어디에 다느냐로 의미가 갈립니다. 한 줄로 요약하면:

② 이벤트 레벨 파라미터 — click_gnb 예시

가장 단순한 레벨입니다. 한 번의 행동에 ‘그 행동에 대해 함께 알고 싶은 정보’를 묶어 전송합니다. 사용자가 사이트 상단 메뉴(GNB)에서 ‘쇼핑’ 버튼을 클릭한 상황을 가정합니다. 이 행동을 click_gnb 이벤트로 수집하고, ‘어떤 메뉴를 눌렀는지’를 파라미터로 함께 전송합니다.

핵심은 — 이 파라미터들이 이 클릭 한 건에만 매달려 있다는 점입니다. 같은 사용자가 다음에 ‘로그인’ 버튼을 누르면 그 클릭은 별개의 click_gnb 이벤트로 수집되고, gnb_label 값은 ‘로그인’으로 새로 채워집니다. 이전의 ‘쇼핑’ 값은 자동으로 전파되지 않습니다.

이벤트 레벨 파라미터의 다른 예시

• 검색 이벤트(search) — 검색어(search_term), 검색 카테고리
• 상품 조회(view_item) — 페이지 URL, 페이지 제목, 통화·금액
• 결제 시작(begin_checkout) — 결제 수단(payment_type), 배송 등급
• 구매 완료(purchase) — 거래 ID, 총 금액, 통화, 주문 쿠폰, 배송비

공통점은 모두 ‘그 행동 한 건’에만 의미가 있다는 점입니다. 같은 사용자라도 두 번째 검색에서는 검색어가 달라지고, 두 번째 결제에서는 결제 수단이 달라질 수 있기 때문입니다.

③ 사용자 레벨 파라미터 — 멤버십 등급 예시

이번에는 다른 모양의 정보를 살펴봅니다 — 회원 등급. VIP 등급인 사용자가 메인 페이지를 보든·상품을 클릭하든·구매하든 ‘VIP’라는 사실은 모든 행동에 똑같이 적용됩니다. 따라서 매 이벤트마다 ‘grade: VIP’를 묻을 필요가 없고, 그 사람 자체에 한 번 ‘이 사람은 VIP’라는 속성을 부여해 두면 충분합니다.

이 자리 덕분에 분석에서 어떤 일이 가능해지는지 살펴봅니다 — ‘VIP 사용자의 전환율 vs 일반 회원의 전환율’ 같은 비교가 한 줄로 끝납니다. 매 이벤트마다 등급을 직접 파라미터로 전송했다면, 어느 한 이벤트라도 누락된 순간 그 사용자의 그 이벤트만 ‘등급 없음’으로 집계되어 분석이 어긋났을 가능성이 큽니다.

사용자 레벨 파라미터의 다른 예시

• 회원 정체성 — 회원 등급, 가입일, 구독 여부, 멤버십 만료일
• 관심·자가식별 정보 — 연령대, 성별(사이트가 받은 자가 입력값)
• 장기 행동 결과 — 누적 구매 횟수, 누적 결제액 등급, 마지막 방문일
• 자동 수집되는 항목 — 언어, 국가, 기기 카테고리, 운영체제 (별도 작업 없이 GA4가 자동으로 부여)

④ 아이템 레벨 파라미터 — 구매 완료 예시

이제 마지막 자리입니다. 사용자가 한 번의 결제에서 ‘청바지 1개 + 티셔츠 1개’를 구매한 상황을 가정합니다. 이 행동은 purchase 이벤트 한 번으로 잡히지만 — 같은 거래 안에서도 상품마다 다른 정보가 있습니다. 청바지는 카테고리가 ‘하의’, 티셔츠는 ‘상의’. 청바지는 17,000원, 티셔츠는 10,000원. 이 ‘상품별로 따로 적용되는 정보’가 아이템 레벨 파라미터입니다.

이렇게 분리해 전송하면 GA4 ‘전자상거래 구매’ 리포트에서 — ‘청바지가 몇 번 조회됐고 몇 번 구매됐는지’, ‘상의 카테고리의 총 매출은 얼마인지’ 같은 상품 단위 분석이 그대로 나옵니다.

아이템 레벨 파라미터의 다른 예시

• 상품 정체성 — 상품 ID(item_id), 상품 이름, 브랜드, 카테고리(1~5단계), 색상·사이즈 같은 옵션(item_variant)
• 상품 가격·수량 — 단가, 수량, 할인액 등
• 상품별 컨텍스트 — 그 상품이 노출된 목록 이름(‘BEST·NEW’), 목록 안 위치(인덱스), 상품 쿠폰(특정 상품에만 적용된 쿠폰)

이 아이템 수준의 구조에 대한 더 자세한 설명(왜 상품 묶음만 ‘배열’ 모양인지 등)은 ‘전자상거래 이벤트를 이해하기 위한 프로그래밍 지식’에서 다룹니다.

⑥ 어디에 둘지 — 한 가지 질문

새 파라미터를 어느 레벨에 둘지 결정할 때 던지는 질문은 단 하나입니다.

실제로 자주 등장하는 정보들을 표로 정리해 봤습니다.

한 정보가 두 자리에 동시에 있을 수도 있다

대표적인 사례가 쿠폰입니다. ‘5만원 이상 결제 시 3,000원 할인’ 같은 주문 쿠폰은 거래 한 건 전체에 적용되므로 이벤트 레벨에 두고, ‘청바지만 10% 할인’ 같은 상품 쿠폰은 특정 상품에만 적용되므로 아이템 레벨에 둡니다. 같은 ‘쿠폰’이라는 이름이지만 자리가 다르므로 GA4도 두 가지를 별개 데이터로 분리해 보관합니다 — 그래서 ‘주문 쿠폰별 매출’과 ‘상품 쿠폰별 매출’을 각각 분석할 수 있습니다.

자주 묻는 질문