자동 수집 이벤트는 앱 또는 사이트(아래 표에서 이벤트 이름 아래에 표시됨)와의 기본적인 상호작용에 의해 트리거됩니다. Firebase용 Google 애널리틱스 SDK 또는 gtag.js를 사용하면 추가로 코드를 작성하지 않아도 이러한 이벤트를 수집할 수 있습니다.
별도로 명시되지 않는 한 애널리틱스는 Android 및 iOS 앱의 이벤트를 수집합니다. 이러한 이벤트의 이름과 매개변수는 BigQuery의 원시 이벤트 데이터에 액세스할 때 유용합니다.
참고
다음 매개변수는 맞춤 이벤트를 비롯한 모든 이벤트와 함께 기본적으로 수집됩니다. 아래 표에 나열된 매개변수가 없는 자동 수집 이벤트는 다음 매개변수만 수신합니다.
- language
- page_location
- page_referrer
- page_title
- screen_resolution
이벤트 매개변수에 할당된 값은 100자(영문 기준) 이하여야 합니다. 그러나 page_location, page_referrer, page_title 매개변수는 300자(영문 기준) 이하여야 합니다.
이벤트 | 자동으로 트리거되는 시점 | 매개변수 |
---|---|---|
ad_click (앱) |
사용자가 광고를 클릭할 때 AdMob에서 Google 모바일 광고 SDK를 통해 수신되는 게시자 이벤트 이 이벤트는 BigQuery로 내보내지 못합니다. |
ad_event_id |
ad_exposure (앱) |
모바일 광고 SDK에서 게재하는 광고가 화면에 하나 이상 있을 때 이 이벤트는 보고서에 표시되지 않으며 BigQuery로 내보내지 못합니다. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
ad_impression (앱) |
사용자가 노출된 광고를 볼 때 AdMob에서 Google 모바일 광고 SDK를 통해 수신되는 게시자 이벤트 이 이벤트는 BigQuery로 내보내지 못합니다. |
ad_event_id, value |
ad_query (앱) |
모바일 광고 SDK에서 광고를 요청할 때 이 이벤트는 보고서에 표시되지 않으며 BigQuery로 내보내지 못합니다. |
ad_event_id |
ad_reward (앱) |
모바일 광고 SDK에서 게재하는 보상형 광고에 따라 리워드가 부여될 때 | ad_unit_code, reward_type, reward_value |
adunit_exposure (앱) |
모바일 광고 SDK에서 게재하는 광고 단위가 화면에 표시될 때 이 이벤트는 보고서에 표시되지 않으며 BigQuery로 내보내지 못합니다. |
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만 해당 |
|
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 (웹) |
사용자가 현재 도메인에서 나가는 링크를 클릭할 때마다 기본적으로 향상된 측정을 통해 수집됩니다. |
매개변수가 수집되지 않습니다. |
dynamic_link_app_open (앱) |
사용자가 동적 링크를 통해 앱을 다시 열 때 | source, medium, campaign, link_id, accept_time |
dynamic_link_ app_update (앱) |
앱이 새 버전으로 업데이트되고 동적 링크를 통해 열릴 때 Android만 해당 |
source, medium, campaign, link_id, accept_time |
dynamic_link_ first_open (앱) |
사용자가 동적 링크를 통해 처음으로 앱을 열 때 | source, medium, campaign, link_id, accept_time |
error (앱) |
오류가 있어 기록될 수 없는 이벤트 대신 기록됩니다. 이 이벤트는 보고서에 표시되지 않으며 BigQuery로 내보내지 못합니다. |
firebase_error, firebase_error_value |
file_download (웹) |
사용자가 다음 유형의 파일(일반 파일 확장자 포함)로 연결되는 링크를 클릭할 때
이 이벤트는 기본적으로 향상된 측정을 통해 수집됩니다. 이벤트를 트리거하는 파일 확장자 보기 |
file_extension, file_name link_classes, link_domain, link_id, link_text, link_url |
firebase_campaign (앱) |
캠페인 매개변수가 있는 상태로 앱이 실행될 때 이 이벤트는 보고서에 표시되지 않으며 BigQuery로 내보내지 못합니다. |
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 전환 측정을 지원합니다. |
previous_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 및 iOS에서 자동 구독 추적 기능을 지원합니다. |
product_id, price, value, currency, quantity, subscription, free_trial, introductory_price |
notification_dismiss (앱) |
사용자가 FCM(Firebase 클라우드 메시징)에서 보낸 알림을 닫을 때 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), engagement_time_msec |
screen_view (앱) |
화면 전환이 발생하고 다음 기준 중 하나가 충족될 때
|
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 (앱, 웹) |
사용자가 앱 또는 웹사이트에 참여할 때 세션 ID 및 세션 번호는 세션마다 자동으로 생성되어 세션의 각 이벤트와 연결됩니다. 자세히 알아보기 |
|
user_engagement (앱, 웹) |
앱이 포그라운드에 있거나 웹페이지가 최소 1초간 포커스 내에 있을 때 자세히 알아보기 |
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="">는 고급 설정에서 수집하도록 지정한 추가 쿼리 매개변수와 일치함) |
참고: 다음 정규식과 일치하는 파일 확장자는 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