파라미터의 타입(type)

① 파라미터의 타입이란?

프로그래밍에서 ‘값(value)’이 가질 수 있는 형식을 ‘데이터 타입(data type)’이라고 부릅니다. JavaScript 기준으로 마케터가 알아 두면 좋은 타입은 여섯입니다.

위 여섯 가운데 GA4가 파라미터 값으로 공식 지원하는 것은 두 가지 — string과 number뿐입니다. 나머지(boolean·array·object)는 GA4가 직접 받지 않거나, 받더라도 string 또는 별도 구조(예: 전자상거래의 items 배열)로 변환되어 들어갑니다.

② GA4가 받는 두 가지 — string과 number

파라미터 값의 자리에 들어갈 수 있는 형식은 단 두 가지로 줄어듭니다.

나머지 타입은 어떻게 처리되나

• boolean(true/false) → string으로 변환해 보냅니다("true"·"false").
• array(여러 값의 묶음) → 일반 파라미터로는 못 보냅니다. 전자상거래의 items 같은 정해진 자리에서만 배열 형태가 허용됩니다.
• object(이름:값 쌍 묶음) → 객체 자체를 보낼 수는 없고, 안의 각 속성을 별도 파라미터로 펼쳐 보냅니다.
• null/undefined(없음) → 보내지 않는 것과 같습니다.

그래서 실제 설계할 때 던지는 질문은 단 하나입니다 — ‘이 값을 string으로 보낼까, number로 보낼까?’

③ number로 보내야 하는 값 — 계산과 정렬이 필요한 모든 수치

다음 분석 중 하나라도 하게 될 값이라면 number로 보냅니다.

• 사칙연산 — 합계, 평균, 최솟값, 최댓값 (예: 매출 합계, 평균 객단가)
• 정렬 — 내림차순(descending) · 오름차순(ascending) (예: 가격 높은 순으로 정렬)
• 구간 분석 — ‘1만원 이상 ~ 5만원 미만’ 같은 범위 그룹핑

대표적인 number 값들 — 상품 단가, 수량, 결제 금액, 배송비, 점수, 페이지 깊이, 체류 시간 등입니다. GA4에서 측정항목(metric)이 되어 표의 숫자 열에 들어가려면 number여야 합니다.

④ string으로 보내야 하는 값 — 분류·이름·코드

다음 두 조건 중 하나라도 해당하면 string으로 보냅니다.

• ‘이걸로 그룹핑(GROUP BY)’을 한다 — 상품 이름별·카테고리별·등급별 분석
• 값에 의미가 없고 식별만 한다 — 상품 ID, 사용자 ID, 거래 ID, 페이지 경로

대표적인 string 값들 — 상품 이름, 상품 ID(SKU), 카테고리, 브랜드, 회원 등급, 검색어, 페이지 URL·제목, 결제 수단 이름 등입니다. GA4에서 측정기준(dimension)이 되어 표의 ‘쪼개는 축’으로 쓰입니다.

‘이 값을 더하거나 평균 낼 일이 없다’가 핵심 판단입니다. 상품 ID 값들의 평균이 의미 없듯, 합계나 정렬이 무의미한 값은 string으로 보냅니다.

⑤ 결정 가이드 — 이 값은 string인가 number인가?

새 파라미터를 설계할 때 ‘값 자리에 무엇이 들어갈까’를 정한 다음 던지는 질문은 한 줄입니다 — “이 값을 합하거나 정렬할 일이 있는가?” 있으면 number, 없으면 string.

자주 묻는 질문