更新时间:2023年4月10号
什么是自动收集的事件
自动收集的事件就是你安装号GA4跟踪代码或SDK后,就会自动收集的事件。
不需要你做任何的设置,这些数据就会显示在GA4中的事件报告里:
自动收集的事件分类
自动收集的事件可以分为网站和应用:
网站
对于网站,通常自动收集事件有如下这些:
事件 | 何时自动触发 | 参数 |
---|---|---|
first_visit | 当用户首次打开网站的时候触发 | |
page_view | 当网页加载或处于活动状态的网站更改浏览器历史记录状态时触发 默认情况下通过增强型衡量功能收集。 |
page_location(网页网址) page_referrer(之前的网页网址) engagement_time_msec |
session_start | 当用户与应用或网站互动时触发,30分钟内无互动,则再次互动将触发新的session_start 事件 系统会自动为每个会话生成会话 ID 和会话编号,并将其与会话中的每个事件相关联。 原则上是每个会话都有一个session_start,但实际上并不是所有的会话都会有session_start ,有些会话是有多个session_start,有些是0 |
|
user_engagement | 当应用在前台运行或网页在浏览器活动窗口中显示至少 1 秒时触发。 | engagement_time_msec |
注意,page_view不是自动收集事件,是增强衡量事件,但它不能关闭,所以是默认收集,可以划分到自动收集的事件。
自动收集的事件可能会有变化的,以官方的为准。
user_engagement事件有时候会跟踪不到,这个是bug。
应用
对于应用,通常自动收集事件有如下这些:
事件 | 何时自动触发 | 参数 |
---|---|---|
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 |
默认事件参数
从前面的分类中可以看到,不同的自动收集的事件的事件参数是不同,但所有的事件(不仅是自动收集的事件,其他所有事件都有)都会有如下5个默认事件参数:
- page_location
- language
- page_referrer
- page_title
- screen_resolution
事件参数的赋值不得超过 100 个字符,而 :
- page_title 参数的赋值不得超过 300 个字符
- page_referrer参数的字符不超过420个字符
- page_location参数的值不超过1000个字符
官方建议是:不要覆盖(自定义)默认事件参数,因为可能会导致事件参数为空,如果你的事件参数为空,检查一下是不是做了覆盖。
报告中查看自动收集的事件数据
在GA4点击「报告」——「用户生命周期」——「互动度」——「事件」,就可以看到。