이벤트 이름과 표기법

본 위키는 웹·앱 모두 click으로 통일합니다. 모바일 환경에서도 ‘탭’이라는 행동이 결국 ‘클릭’과 분석상 같은 의미를 가지기 때문에, 두 단어를 섞어 쓰면 합산할 때마다 불편해집니다. (구분이 꼭 필요하면 매개변수에 device_type을 함께 보내는 방식을 권장합니다.)

본 위키는 5개로 좁혀 둡니다 — click, view, submit, play, search. 그 외의 행동도 대부분 이 다섯 중 하나로 분류됩니다(select_tab 대신 click_tab, open_popup 대신 click_popup). 자세한 동사 어휘는 ‘이벤트 이름 짓는 규칙’ 글에서 다룹니다.

네 — GA4 추천 이벤트는 sign_up·purchase·add_to_cart처럼 ‘의미론적 이름’(동사 단독·동사+대상이 자유 형태)을 씁니다. 추천 이벤트는 GA4가 이미 이름을 정해 둔 영역이라 본 위키의 [행위]_[대상] 패턴을 강제하지 않습니다 — 추천 이벤트는 그 이름 그대로 쓰는 게 표준입니다(→ GA4 이벤트의 종류).

‘기술적으로 안 되는 것’은 아닙니다 — GA4 공식 명세는 이벤트 이름에 ‘English and non-English letters’를 모두 허용한다고 명시하고 있어, click_핫딜 같은 이름도 통과 자체는 됩니다. 다만 실무에서는 권장하지 않습니다:

• 메모리·전송 효율 ↓ — 한글은 UTF-8 기준 한 글자당 3바이트(UTF-16에선 2바이트지만 GA4·BigQuery·웹은 UTF-8 표준). 이름·인덱스·로그 어디에 들어가든 영문보다 부피가 큽니다.
• 오탈자 확률 ↑ — 한·영 키보드 전환과 받침이 있는 조합형 한글 입력 특성상, 사람이 같은 이름을 매번 정확히 적기 어렵습니다.
• 운영 부담 ↑ — BigQuery SQL·URL 인코딩·외부 분석 도구 연동 단계마다 별도 처리가 필요해 유지보수 손이 더 갑니다.

그래서 이름은 영문 소문자로만 만들고, 한글 콘텐츠(예: ‘핫딜’이라는 메뉴 이름)는 매개변수 값으로 보냅니다 — 예: click_gnb + gnb_name="핫딜". 이름은 ‘무엇을 했나’의 유형까지만, 한국어 콘텐츠는 값으로 — 라는 분리가 핵심입니다.

두 가지 동시 처리 — ① 신규 이벤트는 무조건 snake_case로 통일하고, ② GA4의 ‘이벤트 수정’ 기능으로 기존의 clickGnb·ClickGnb 같은 변형을 click_gnb로 매핑해 줍니다. 과거 데이터까지 소급되지는 않지만, ‘앞으로의 데이터는 한 이름으로 모이게’ 만들 수 있습니다.

받는 경우도 있고, 안 받는 경우도 있어 ‘일관되지 않음’이 문제입니다. GA4 공식 명세에는 허용 문자가 letters · digits · underscores로 한정되어 있어 하이픈은 공식 미허용입니다. 다만 실제 동작상 Google이 하이픈을 자동으로 언더바로 치환해 받아 주는 사례가 있어 — click-gnb가 click_gnb로 바뀌어 들어올 수 있습니다. 이 자동 치환은 보장된 동작이 아니므로, ‘하이픈이 항상 안전하다’고 가정하면 곤란합니다.

그리고 보장되더라도 snake_case가 더 편합니다 — GA4 자동/추천 이벤트가 모두 snake_case라 우리 맞춤 이벤트도 같은 스타일을 따르는 게 시각적으로 일관되고, BigQuery SQL에서도 하이픈 식별자는 따옴표 처리가 필요해 번거롭습니다. 그래서 본 위키는 “하이픈 안 됨”보다 “snake_case 하나로 통일”이라는 표현을 씁니다.