Google 애널리틱스 이벤트 측정

이 페이지에서는 gtag.js를 사용하여 Google 애널리틱스 이벤트를 전송하는 방법을 설명합니다.

이벤트 전송

Google 태그가 추가된 웹페이지에서 Google 애널리틱스 이벤트를 보내려면 다음 구문과 함께 gtag.js event 명령어를 사용합니다.

gtag('event', <action>, {
  'event_category': <category>,
  'event_label': <label>,
  'value': <value>
});

이름	유형	기본값	설명
`<action>`	`string`		Google 애널리틱스 이벤트 보고서에서 이벤트 액션으로 표시될 값입니다.
`<category>`	`string`	`"general"`	이벤트의 카테고리입니다.
`<label>`	`string`		이벤트 라벨입니다.
`<value>`	`number`		이벤트 값으로 표시될 음수가 아닌 정수입니다.

다음은 'aaa' 작업, 'bbb' 카테고리, 'ccc' 라벨이 있는 이벤트를 전송합니다.

gtag('event', 'aaa', {
  'event_category' : 'bbb',
  'event_label' : 'ccc'
});

<category> 또는 <label>를 생략하면 "(not set)"의 기본값으로 설정됩니다.

Google 애널리틱스에서 이벤트 구조를 해석하는 방법에 대한 자세한 내용은 Google 애널리틱스 이벤트 매개변수 분석을 참조하세요.

기본 Google 애널리틱스 이벤트

미리 설정된 카테고리와 라벨이 있는 기본 Google 애널리틱스 이벤트를 사용해야 합니다. 이러한 이벤트를 사용하면 일관된 보고 및 향후 기능과의 상호 운용성을 촉진할 수 있습니다.

다음 표에는 기본 Google 애널리틱스 이벤트, 기본 카테고리, 기본 라벨 유형 (사용 가능한 경우)이 나와 있습니다. 이 표에 나열되지 않은 이벤트 이름 (예: 개발자가 만든 임의의 이벤트 이름)의 경우 기본 카테고리는 "engagement"이고 기본 라벨은 "(not set)"입니다.

이벤트 이름	기본 카테고리	기본 라벨 유형
`add_payment_info`	`ecommerce`
`add_to_cart`	`ecommerce`
`add_to_wishlist`	`ecommerce`
`begin_checkout`	`ecommerce`
`checkout_progress`	`ecommerce`
`generate_lead`	`engagement`
`login`	`engagement`	`method`
`purchase`	`ecommerce`
`refund`	`ecommerce`
`remove_from_cart`	`ecommerce`
`search`	`engagement`	`search_term`
`select_content`	`engagement`	`content_type`
`set_checkout_option`	`ecommerce`
`share`	`engagement`	`method`
`sign_up`	`engagement`	`method`
`view_item`	`engagement`
`view_item_list`	`engagement`
`view_promotion`	`engagement`
`view_search_results`	`engagement`	`search_term`

상호작용 이외의 이벤트 전송

비상호작용 이벤트를 보내려면 non_interaction 매개변수를 true로 설정합니다.

gtag('event', 'video_auto_play_start', {
  'event_label': 'My promotional video',
  'event_category': 'video_auto_play',
  'non_interaction': true
});