文章目录[隐藏]
更新时间：2025年1月10号
在GA4中，事件是衡量用户行为的核心数据单位。
GA4中的事件主要分为：
本文主要介绍第一类：自动收集事件
什么是GA4自动收集事件？
自动收集事件（Automatically Collected Events）是指：
当你安装GA4跟踪代码（Google Tag）或者集成 Firebase SDK 后，系统无需额外配置，就会自动发送的事件。
例如first_visit、page_view、user_engagement，这些事件无需通过GTM额外配置。
GA4事件采集类型关系
很多用户容易混淆自动收集事件和增强型衡量事件。
实际上：
| 类型 | 是否需要配置 | 示例 |
|---|---|---|
| 自动收集事件 | 默认自动发送 | first_visit、session_start |
| 增强型衡量事件 | 开启增强型衡量后自动发送 | page_view、scroll、click |
| 推荐事件 | 需要手动实现 | purchase、login |
| 自定义事件 | 自己定义 | download_pdf |
需要注意：page_view严格来说属于增强型衡量事件，而不是传统意义上的自动收集事件。
但是由于GA4默认开启增强型衡量，并且无法关闭首次页面浏览，因此很多资料会把它归入自动采集范围。
自动收集的事件分类
自动收集的事件可以分为网站和应用：
网站
对于网站，常见自动采集事件如下：
| 事件 | 何时自动触发 | 参数 |
|---|---|---|
| first_visit | 用户首次访问网站时触发 | |
| page_view | 当网页加载或处于活动状态的网站更改浏览器历史记录状态时触发 默认情况下通过增强型衡量功能收集。 |
page_location（网页网址） page_referrer（之前的网页网址） engagement_time_msec |
| session_start | 新会话开始时触发 | |
| user_engagement | 页面处于活动状态超过1秒时触发 | engagement_time_msec |
应用
对于应用，通常自动收集事件有如下这些：
| 事件 | 何时自动触发 | 参数 |
|---|---|---|
| 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 |
| 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 此事件与“每日卸载该应用的设备数量”和“每日卸载该应用的用户数”指标不同，后面两个指标是由 Google Play 管理中心报告的。“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”，并将订阅参数设为“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 管理中心报告。升级是指更新应用二进制文件，而 app_update 事件是在升级后的应用启动时触发。 |
previous_app_version |
| 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 |
| 错误 | 当特定事件由于某种原因导致失效而无法记录时，系统就会改为记录此事件 _err (firebase_error)、_ev (firebase_error_value) 和 _el (firebase_error_length) 参数会提供额外的信息。 此事件不会在报告中显示，也不会导出到 BigQuery 中。 |
firebase_error、firebase_error_value |
| 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 管理中心或 iTunesConnect。 支持衡量接受 Apple iOS 14 应用跟踪提示的用户的 first_open 转化次数。 |
previous_gmp_app_id updated_with_analytics previous_first_open_count system_app system_app_update deferred_analytics_collectionreset_analytics_cause engagement_time_msec |
| first_visit | 当用户首次访问/启动启用了 Analytics（分析）的网站或 Android 免安装应用时触发 | |
| in_app_purchase | 当用户完成由 iTunes 上的 App Store 或 Google Play 处理的应用内购买交易（包括首次订阅）时触发 产品 ID、产品名称、币种和数量会作为参数传递。 要查看 Android 应用的 in_app_purchase 数据，您需要将 Google Analytics（分析）关联到 Google Play。 Google Analytics（分析）支持在 Android 和 iOS 设备上自动跟踪订阅情况。 只有包含 Google Analytics for Firebase SDK 的应用版本才会触发此事件。注意：系统不会自动跟踪付费应用的购买收入和退款（仅限 iOS）。报告的收入可能与您在 Google Play 管理中心看到的值不同。标记为无效或沙盒（测试）的事件会被忽略。只有 iOS 事件会被标记为沙盒。 |
product_id price value currency quantity subscription free_trial introductory_price |
| notification_dismiss | 当用户关闭 Firebase Cloud Messaging (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 |
| screen_view | 当发生屏幕转换且符合以下任一条件时触发：
|
firebase_screen firebase_screen_class firebase_screen_id firebase_previous_screen firebase_previous_class firebase_previous_id engagement_time_msec |
| session_start | 当用户与应用或网站互动时触发
系统会自动为每个会话生成会话 ID 和会话编号，并将其与会话中的每个事件相关联。 |
|
| user_engagement | 当应用在前台运行或网页在浏览器活动窗口中显示至少 1 秒时触发 | engagement_time_msec |
默认事件参数
所有的事件都会有一些默认事件参数，事件参数默认不超过100个字符，个别例外：
| 网站 | APP | |
|---|---|---|
| 默认事件参数 |
|
|
如何查看自动收集事件？
在GA4点击「报告」——「用户生命周期」——「互动度」——「事件」，就可以看到：
注意点
不要重复发送 page_view
很多网站：Enhanced Measurement开了page_view，GTM又手动发一次
结果：PV翻倍，Session异常，这是最常见GA4问题之一。
SPA网站特别注意
单页应用可以通过勾选
自动事件不能修改名字
自动收集事件是系统保留，预定义的事件。
不要手动发送同名事件，修改参数结构，否则可能导致数据异常。
有疑问可以在底部留言
