[GA4] 자동으로 수집되는 이벤트

자동으로 수집되는 이벤트는 (아래 표의 이벤트 이름 아래 표시된) 앱 또는 사이트와의 기본적인 상호작용에 의해 트리거됩니다. SDK 또는 gtag.js를 사용하면 추가로 코드를 작성하지 않아도 이러한 이벤트를 수집할 수 있습니다.

별도로 명시되지 않는 한 애널리틱스는 Android iOS 앱의 이벤트를 수집합니다.

이벤트를 관리(예: 대화로 표시, 매개변수 추가)하려면 왼쪽 창에서 이벤트 > 모든 이벤트를 클릭합니다.

이벤트 데이터는 애널리틱스 보고서에 표시됩니다.

Note

The following parameters are collected by default with every event, including custom events:

  • language
  • page_location
  • page_referrer
  • page_title
  • screen_resolution
이벤트 이름 자동으로 트리거되는 시점 매개변수

ad_click

(앱)

사용자가 광고를 클릭할 때

AdMob에서 Google 모바일 광고 SDK를 통해 수신되는 게시자 이벤트

ad_event_id

ad_exposure

(앱)

모바일 광고 SDK에서 게재하는 광고가 화면에 하나 이상 있을 때 firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time

ad_impression

(앱)

사용자가 노출된 광고를 볼 때

AdMob에서 Google 모바일 광고 SDK를 통해 수신되는 게시자 이벤트

ad_event_id

ad_query

(앱)

모바일 광고 SDK에서 광고를 요청할 때 ad_event_id

ad_reward

(앱)

모바일 광고 SDK에서 게재하는 보상형 광고를 통해 리워드가 부여될 때 ad_unit_id, reward_type, reward_value

adunit_exposure

(앱)

모바일 광고 SDK에서 게재하는 광고 단위가 화면에 표시될 때 firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time

app_clear_data

(앱)

사용자가 앱 데이터를 재설정 또는 삭제하여 모든 설정과 로그인 데이터를 삭제할 때

Android만 해당

 

app_exception

(앱)

앱이 다운되거나 예외가 발생할 때 fatal, timestamp, engagement_time_msec

app_remove

(앱)

애플리케이션 패키지가 Android 기기에서 삭제(제거)될 때

Android만 해당

이 이벤트는 Google Play Console에서 보고되는 일일 기기 제거 수일일 사용자 제거 수 측정항목과는 다릅니다. app_remove 이벤트는 설치 소스에 관계없이 애플리케이션 패키지 삭제를 집계하며 값은 보고서에서 지정한 기간에 따라 달라집니다. 일일 기기 제거 수일일 사용자 제거 수 측정항목은 애플리케이션 패키지가 Google Play에서 설치된 경우에만 애플리케이션 패키지 삭제를 집계하며 하루에 한 번 보고됩니다.

 

app_store_refund

(앱)

Google Play에서 인앱 구매를 환불할 때

Android만 해당

이 이벤트는 BigQuery로 내보내지 못합니다.

product_id, value, currency, quantity

app_store_subscription_cancel

(앱)

Google Play에서 유료 구독이 취소될 때

Android만 해당

최초 구독 일자가 2019년 7월 1일 이후여야 합니다.

이 이벤트는 BigQuery로 내보내지 못합니다.

product_id, price, value, currency, cancellation_reason

app_store_subscription_convert

(앱)

무료 체험 구독이 유료 구독으로 전환될 때

이 이벤트는 기본 전환으로 설정됩니다.

최초 구독 일자가 2019년 7월 1일 이후여야 합니다. 최초 무료 체험판 구독은 in_app_purchase로 기록되며 subscription 매개변수가 true로 설정됩니다.

이 이벤트는 BigQuery로 내보내지 못합니다.

product_id, price, value, currency, quantity

app_store_subscription_renew

(앱)

유료 구독이 갱신될 때

이 이벤트는 기본 전환으로 설정됩니다.

최초 구독 일자가 2019년 7월 1일 이후여야 합니다.

이 이벤트는 BigQuery로 내보내지 못합니다.

product_id, price, value, currency, quantity, renewal_count

app_update

(앱)

앱이 새 버전으로 업데이트되고 다시 실행될 때

이전 앱 버전 ID가 매개변수로 전달됩니다.

이 이벤트는 Google Play Console에서 보고하는 일일 기기 업그레이드 수 측정항목과 다른 개념입니다. 업그레이드는 애플리케이션 바이너리의 업데이트를 의미하지만, app_update 이벤트는 업그레이드된 앱이 이후에 트리거될 때 발생합니다.

previous_app_version

click

(웹)

사용자가 현재 도메인에서 나가는 링크를 클릭할 때마다

기본적으로 향상된 측정을 통해 수집됩니다.

매개변수가 수집되지 않습니다.
사용자가 동적 링크를 통해 앱을 다시 열 때 source, medium, campaign, link_id, accept_time

앱이 새 버전으로 업데이트되고 동적 링크를 통해 열릴 때

Android만 해당

source, medium, campaign, link_id, accept_time
사용자가 동적 링크를 통해 처음으로 앱을 열 때 source, medium, campaign, link_id, accept_time

error

(앱)

오류가 있어 기록될 수 없는 이벤트 대신 기록됩니다.

_err(firebase_error), _ev(firebase_error_value), _el(firebase_error_length) 매개변수에 추가 정보가 포함됩니다.
firebase_error, firebase_error_value

file_download

(웹)

사용자가 다음 유형의 파일(일반 파일 확장자 포함)로 연결되는 링크를 클릭할 때
  • 문서
  • 텍스트
  • 실행 파일
  • 프레젠테이션
  • 압축 파일
  • 동영상
  • 오디오

다음 정규식과 일치하는 파일 확장자가 이벤트를 트리거합니다.

pdf|xlsx?|docx?|txt|rtf|csv|exe|key|pp(s|t|tx)|7z|pkg|rar|gz|zip|avi|mov|mp4|mpe?g|wmv|midi?|mp3|wav|wma

이 이벤트는 기본적으로 향상된 측정을 통해 수집됩니다.

file_extension, file_name link_classes, link_domain, link_id, link_text, link_url

firebase_campaign

(앱)

캠페인 매개변수가 있는 상태로 앱이 시작될 때 source, medium, campaign, term, content, gclid, aclid, cp1, anid, click_timestamp, campaign_info_source

firebase_in_app_message_action

(앱)

사용자가 Firebase 인앱 메시지에서 특정 액션을 수행할 때 message_name, message_device_time, message_id

firebase_in_app_message_dismiss

(앱)

사용자가 Firebase 인앱 메시지를 닫을 때 message_name, message_device_time, message_id

firebase_in_app_message_impression

(앱)

사용자에게 Firebase 인앱 메시지가 표시될 때 message_name, message_device_time, message_id

first_open

(앱)

앱 설치 또는 재설치 후 처음으로 앱을 실행할 때

이 이벤트는 사용자가 기기에 앱을 다운로드할 때가 아니라 앱을 처음으로 사용할 때 트리거됩니다. 순수 다운로드 횟수는 Google Play Console 또는 iTunesConnect에서 확인하세요.

Apple의 iOS 14 앱 추적 프롬프트를 수락하는 사용자의 first_open 전환 측정을 지원합니다.
previoius_gmp_app_id, updated_with_analytics, previous_first_open_count, system_app, system_app_update, deferred_analytics_collection, reset_analytics_cause, engagement_time_msec

first_visit

(앱, 웹)

사용자가 웹사이트를 처음 방문하거나 애널리틱스를 사용하는 Android 인스턴트 앱을 처음으로 실행할 때  

in_app_purchase

(앱)

사용자가 iTunes의 App Store 또는 Google Play에서 최초 구독을 포함한 인앱 구매를 완료할 때

제품 ID, 제품 이름, 통화, 수량이 매개변수로 전달됩니다.

Android 앱용 in_app_purchase 데이터를 보려면 애널리틱스를 Google Play에 연결해야 합니다.

애널리틱스는 Android 및 iOS에서 자동 구독 추적 기능을 지원합니다.

이 이벤트는 Firebase SDK가 포함된 앱 버전에서만 트리거됩니다. 참고: 유료 앱 구매 수익, 환불(iOS만 해당)은 자동으로 추적되지 않습니다. 보고된 수익이 Google Play Console에 표시되는 값과 다를 수도 있습니다. 무효 또는 샌드박스(테스트)로 표시된 이벤트는 무시됩니다. iOS 이벤트만 샌드박스로 신고됩니다. Google Play 결제 테스트에 대해 자세히 알아보세요.

product_id, price, value, currency, quantity, subscription, free_trial, introductory_price

notification_dismiss

(앱)

FCM에서 보낸 알림을 사용자가 닫을 때

Android만 해당

message_name, message_time, message_device_time, message_id, topic, label, message_channel

notification_foreground

(앱)

앱이 포그라운드 상태인 동안에 FCM에서 보낸 알림이 수신될 때 message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type

notification_open

(앱)

FCM에서 보낸 알림을 사용자가 열 때 message_name, message_time, message_device_time, message_id, topic, label, message_channel

notification_receive

(앱)

앱이 백그라운드 상태인 동안 FCM에서 보낸 알림이 기기에 수신될 때

Android만 해당

message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type

notification_send

(앱)

FCM에서 알림을 보낼 때

Android만 해당

message_name, message_time, message_device_time, message_id, topic, label, message_channel

os_update

(앱)

기기 운영체제가 새 버전으로 업데이트될 때. 이전 운영체제 버전 ID가 매개변수로 전달됩니다. previous_os_version

page_view

(웹)

페이지가 로드되거나 활성 사이트에서 브라우저 기록 상태가 변할 때

기본적으로 향상된 측정을 통해 수집됩니다.

page_location(페이지 URL), page_referrer(이전 페이지 URL)

screen_view

(앱)

화면 전환이 발생하고 다음 기준 중 하나가 충족될 때
  • 이전에 설정된 화면이 없음
  • 새 화면 이름이 이전 화면 이름과 다름
  • 새 화면 클래스 이름이 이전 화면 클래스 이름과 다름
  • 새 화면 ID가 이전 화면 ID와 다름
firebase_screen, firebase_screen_class, firebase_screen_id, firebase_previous_screen, firebase_previous_class, firebase_previous_id, engagement_time_msec

scroll

(웹)

사용자가 각 페이지에서 처음으로 하단에 도달할 때(세로 기준으로 페이지의 90% 이상이 표시될 때)

기본적으로 향상된 측정을 통해 수집됩니다.

engagement_time_msec

session_start

(앱, 웹)

사용자가 앱 또는 웹사이트에 참여할 때  

user_engagement

(앱, 웹)

앱이 포그라운드 상태일 때 주기적으로 engagement_time_msec

video_complete

(웹)

동영상이 끝날 때

JS API 지원이 가능한 삽입된 YouTube 동영상의 경우

기본적으로 향상된 측정을 통해 수집됩니다.

video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible(부울)

video_progress

(웹)

동영상 재생 시간이 전체 시간의 10%, 25%, 50%, 75%를 넘을 때

JS API 지원이 가능한 삽입된 YouTube 동영상의 경우

기본적으로 향상된 측정을 통해 수집됩니다.

video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible(부울)

video_start

(웹)

동영상 재생이 시작될 때

JS API 지원이 가능한 삽입된 YouTube 동영상의 경우

기본적으로 향상된 측정을 통해 수집됩니다.

video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible(부울)

view_search_results

(웹)

사용자가 사이트 검색을 할 때마다(URL 쿼리 매개변수가 있을 경우 사이트 검색을 한 것으로 간주)

기본적으로 향상된 측정을 통해 수집됩니다.

search_term, 선택적으로 'q_<additional key="">'(이때 <additional key="">는 고급 설정에서 수집하도록 지정한 추가 쿼리 매개변수와 일치함)
도움이 되었나요?
어떻게 하면 개선할 수 있을까요?