GA4 이벤트 매개변수란 무엇일까?

앞 글에서는 GA4 이벤트가 무엇인지 살펴봤습니다.

그런데 purchase만으로는 이런 질문이 남습니다.

얼마를 구매했는지
어떤 통화인지
어떤 주문인지
어떤 상품인지

이때 필요한 것이 GA4 이벤트 매개변수입니다.

핵심은 이렇습니다.

이벤트 = 무슨 일이 있었는가?
이벤트 매개변수 = 그 일에 대한 자세한 정보

1. 이벤트 매개변수란 무엇일까?

이벤트 매개변수(Event parameter)는 이벤트에 함께 붙는 추가 정보입니다.

쉽게 구분하면 이렇습니다.

이벤트 = 무슨 일이 있었는가?
이벤트 매개변수 = 그 일의 상세 정보

예를 들어 구매가 발생했다는 사실만으로는 부족합니다.

금액, 통화, 주문번호처럼 “그 구매가 어떤 구매였는지”를 알려주는 값이 필요합니다. 그 값이 GA4 event parameter, 즉 GA4 parameter입니다.

2. 왜 이벤트 이름만으로 부족할까?

purchase만 보면 구매가 발생했다는 사실만 알 수 있습니다.

실제 분석에서는 보통 더 많은 정보가 필요합니다.

예를 들면 이렇습니다.

금액
통화
주문
상품

이벤트 이름은 행동을 구분하고, 매개변수는 그 행동을 자세히 설명합니다.

둘을 같이 봐야 “무슨 일이, 어떤 내용으로 있었는지”를 이해할 수 있습니다.

3. purchase 예시

구매 금액 49,000원, 통화 KRW, 주문번호 ORDER-1001인 경우를 생각해 보세요.

개념적으로는 이렇습니다.

event:
purchase

parameters:
value = 49000
currency = KRW
transaction_id = ORDER-1001

각 역할은 이렇습니다.

purchase = 구매 발생
GA4 value = 구매 금액
GA4 currency = 통화
GA4 transaction_id = 거래 식별값

이벤트 하나가 “구매”를 말하고, 매개변수가 “어떤 구매인지”를 채웁니다.

4. 같은 이벤트라도 매개변수 값은 달라질 수 있다

같은 purchase라도 매개변수 값은 매번 다를 수 있습니다.

예를 들면 이렇습니다.

purchase
value = 49000

purchase
value = 99000

이벤트 이름은 같지만, 금액 정보는 다릅니다.

그래서 보고서에서 같은 이벤트를 볼 때도, 매개변수까지 함께 봐야 실제 내용을 이해할 수 있습니다.

5. page_view에도 매개변수가 있다

구매만 매개변수가 있는 것은 아닙니다.

page_view에도 세부 정보가 함께 들어갈 수 있습니다.

예를 들면 이렇습니다.

페이지 주소
페이지 제목
이전 페이지 관련 정보

그중 페이지 주소는 GA4 page_location처럼 볼 수 있습니다.

페이지를 봤다는 사실뿐 아니라, 어떤 페이지를 봤는지까지 알아야 분석이 됩니다.

6. 이벤트 하나에 여러 매개변수가 붙을 수 있다

이벤트 하나에 매개변수가 하나만 붙는 것은 아닙니다.

예를 들어 purchase에는 여러 정보가 함께 붙을 수 있습니다.

purchase
→ value
→ currency
→ transaction_id
→ items

한 행동을 여러 정보로 설명한다고 생각하면 됩니다.

금액만 있으면 부족하고, 통화와 거래 식별값, 상품 정보까지 있어야 구매를 더 정확히 볼 수 있습니다.

7. 매개변수 이름과 값의 차이

매개변수도 이름과 값으로 나뉩니다.

예를 들면 이렇습니다.

currency = KRW

currency = 매개변수 이름
KRW = 매개변수 값

또 다른 예입니다.

value = 49000

value = 매개변수 이름
49000 = 매개변수 값

이름은 “어떤 정보인가”를 말하고, 값은 “그 정보가 무엇인가”를 말합니다.

8. 같은 매개변수 이름, 다른 값

같은 매개변수 이름이라도, 이벤트마다 값은 달라질 수 있습니다.

예를 들면 이렇습니다.

page_location = https://example.com/
page_location = https://example.com/product

이름은 둘 다 page_location이지만, 값은 서로 다른 페이지입니다.

그래서 “어떤 매개변수가 들어왔는가”와 “값이 무엇인가”를 둘 다 확인해야 합니다.

9. 모든 매개변수를 직접 만들어야 할까?

아닙니다.

GA4나 Google 태그가 자동으로 수집하는 정보가 있고, Google이 추천 이벤트에서 정해 둔 매개변수 구조도 있습니다.

원칙은 이렇습니다.

직접 만들기 전에 Google이 이미 정의한 구조가 있는지 확인

처음부터 임의의 이름을 만들기보다, 이미 있는 표준을 먼저 검토하세요.

10. Google 권장 매개변수를 먼저 쓰는 이유

예를 들어 구매 금액용으로 임의로 purchase_amount를 만들기보다, Google이 정의한 value가 맞는 상황이면 value를 우선합니다.

이유는 이렇습니다.

표준화
GA4 기능과의 호환
협업 이해
향후 이름 변경 감소

팀마다 다른 이름을 쓰면, 같은 의미인데도 데이터가 갈라질 수 있습니다.

권장 구조가 있으면 먼저 맞추는 편이 안전합니다.

11. 매개변수를 너무 많이 만들면 문제

매개변수를 많이 넣을수록 분석이 좋아진다고 생각하면 안 됩니다.

예를 들어 이런 정보까지 전부 넣으면 데이터가 복잡해질 수 있습니다.

button_color
button_width
button_height
button_font

핵심 질문은 이것입니다.

실제 의사결정에 필요한 정보인가?

필요한 정보부터 넣고, 없어도 되는 세부 정보는 줄이세요.

12. 같은 뜻을 여러 이름으로 만들지 말자

같은 의미를 여러 이름으로 만들면 관리가 어려워집니다.

예를 들면 이런 이름들이 섞이는 경우입니다.

category
product_category
item_category
product_type

의미가 같다면 이름을 통일해야 합니다.

단, 전자상거래처럼 Google이 이미 item_category 같은 표준 매개변수를 정한 영역에서는 Google 표준을 우선하세요.

13. 데이터 타입/값의 형태도 일관되게

같은 매개변수 이름은 같은 의미와 형식으로 쓰는 편이 좋습니다.

예를 들면 이렇습니다.

value = 49000
→ 숫자

currency = KRW
→ 문자

같은 이름에 어떤 날은 숫자, 어떤 날은 문자처럼 다른 형태를 넣으면 해석이 어려워집니다.

DB처럼 타입을 깊게 외울 필요는 없습니다.

초보자는 “같은 이름은 같은 의미와 형식”만 기억하면 충분합니다.

14. 빈 값이나 의미 없는 값 주의

값이 비어 있거나 의미 없는 값이 계속 들어오면 분석 품질이 낮아질 수 있습니다.

예를 들면 이렇습니다.

product_name = ""
category = unknown

확인할 내용은 이렇습니다.

실제 값이 들어오는가
빈 값이 과도하지 않은가
예상한 형식인가

매개변수를 보냈다는 사실만으로 끝이 아닙니다. 값이 쓸 만한지도 봐야 합니다.

15. 매개변수는 일반 보고서에 모두 자동 노출될까?

아닙니다.

매개변수를 전송했다고 해서, 모든 값이 원하는 형태로 일반 보고서에 바로 나타나는 것은 아닙니다.

일부는 기본 측정기준이나 측정항목으로 사용할 수 있습니다.

직접 만든 매개변수를 분석에 쓰려면 추가 설정이 필요한 경우도 있습니다.

이때 나오는 개념이 GA4 맞춤 측정기준과 맞춤 측정항목입니다.

상세 설정은 뒤 글에서 다룹니다. 지금은 “보냈다고 바로 보고서에서 다 보이는 것은 아니다”만 기억하세요.

16. 이벤트 매개변수와 차원은 같은 것일까?

같지 않습니다.

쉽게 구분하면 이렇습니다.

이벤트 매개변수 = 이벤트와 함께 수집되는 상세 정보
차원 = 보고서에서 데이터를 나누어 보는 기준

둘은 관계가 있지만 같은 개념은 아닙니다.

매개변수가 수집되고, 그 정보가 보고서에서 측정기준으로 쓰일 수 있는 경우도 있습니다. 하지만 “매개변수 = 차원”이라고 외우면 헷갈립니다.

17. 매개변수가 제대로 들어오는지 확인

새 이벤트나 매개변수를 구현했다면 아래를 모두 확인하세요.

이벤트가 도착하는가
매개변수 이름이 맞는가
매개변수 값이 맞는가

예를 들어 purchase라면 이런 값을 확인합니다.

purchase
→ value
→ currency
→ transaction_id

필요하면 DebugView로 이벤트와 매개변수를 자세히 볼 수 있습니다.

설치 검증의 세부 방법은 앞 PART에서 다뤘으니, 여기서는 “이벤트뿐 아니라 매개변수까지 확인한다”는 점만 기억하면 됩니다.

18. 처음 설계할 때 확인할 5가지

처음에는 아래 다섯 가지만 확인하세요.

실제 분석에 필요한가?
Google 표준/권장 매개변수가 있는가?
같은 의미를 다른 이름으로 만들고 있지 않은가?
값 의미와 형식이 일관되는가?
실제 이벤트에서 값이 정확히 들어오는가?

이 다섯 가지가 맞으면, 매개변수 설계의 기본은 충분합니다.

19. 이벤트와 이벤트 매개변수를 다시 정리하면

개념	쉽게 이해하면
이벤트	무슨 일이 있었는지 기록하는 데이터
이벤트 이름	그 행동을 구분하는 이름
이벤트 매개변수	그 행동의 자세한 정보
매개변수 이름	어떤 정보인가
매개변수 값	그 정보가 무엇인가

예를 들면 이렇습니다.

purchase = 구매 발생
value = 49000 = 구매 금액
currency = KRW = 통화

20. 정리

한 번 더 정리하면 이렇습니다.

이벤트 = 무슨 일이 있었는가?
이벤트 매개변수 = 그 일에 대해 더 자세히 알려주는 정보

좋은 설계 순서는 이렇습니다.

필요한 정보인가?
→ Google 표준이 있는가?
→ 이름/값이 일관되는가?
→ 실제 데이터가 정확한가?

이벤트만 보면 큰 그림이 보이고, 매개변수까지 보면 세부 내용이 보입니다.

다음 글에서는 GA4 자동 수집 이벤트가 무엇인지 알아보겠습니다.