[GA4] 自动收集的事件

自动收集的事件会在用户与您的应用和/或网站进行基本互动时触发(如下表中事件名称下所示)。只要您使用 Google 代码Google Analytics for Firebase SDK,则无需额外编写任何代码就能收集这些事件。

除非另有说明,否则 Google Analytics 会针对 Android 和 iOS 应用收集这些事件。BigQuery 中访问原始事件数据时,事件的名称和参数会很有帮助。

如需了解下面列出的每个事件参数以及每个参数如何更新 Google Analytics 中的维度或指标,请参阅 Google Analytics 事件参数

注意

默认情况下,系统会收集每个事件(包括自定义事件)的以下参数:

  • 网站数据流:
    • language
    • page_location
    • page_referrer
    • page_title
    • screen_resolution
  • 应用数据流:
    • app_version
    • firebase_screen_id
    • firebase_screen_class

事件参数的赋值不得超过 100 个字符。page_titlepage_title 参数的赋值不得超过 300 个字符。page_referrerpage_referrer 参数的赋值不得超过 420 个字符。page_locationpage_location 参数的赋值不得超过 1,000 个字符。

若要替换 page_location 参数,请确保网址路径有效。page_location如果指定的网址路径无效,“网页位置”维度将为空。您可以使用广告系列网址构建工具来检查网址路径是否有效。

除非您停用屏幕浏览跟踪,否则系统会自动收集 firebase_screen_id firebase_screen_class 参数。

事件 何时自动触发 参数

ad_click

(应用)

当用户点击广告时触发

这是从 AdMob 通过 Google 移动广告 SDK 或从 Ad Manager 通过 Ad Manager 集成传来的发布商事件

此事件不会导出到 BigQuery。

ad_event_id

ad_exposure

(应用)

当屏幕上至少有一个移动广告 SDK 投放的广告时触发

此事件不会在报告中显示,也不会导出到 BigQuery 中。

firebase_screen、firebase_screen_id、firebase_screen_class、exposure_time

ad_impression

(应用)

当用户看到广告展示时触发

这是从 AdMob 通过 Google 移动广告 SDK 或从 Ad Manager 通过 Ad Manager 集成传来的发布商事件

此事件不会导出到 BigQuery。

注意:默认集成不会传递 ad_impression 的值或币种。

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

(应用)

当应用崩溃或抛出异常时触发

您集成 Firebase Crashlytics 后,系统就会发送这个事件。

fatal、timestamp、engagement_time_msec

app_remove

(应用)

当应用软件包从 Android 设备上移除(卸载)时触发

仅限 Android

此事件与“每日卸载该应用的设备数量”和“每日卸载该应用的用户数”指标不同,后面两个指标由 Google Play 管理中心报告app_remove 事件统计的是应用软件包的移除次数(不管安装来源),此数目会因您使用的报告日期范围的不同而有所变化。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

click

(网站)

每当用户点击会将他们带离当前网域的链接时触发

默认情况下,所有会将用户带离当前网域的链接都会触发出站点击事件。如果链接指向跨网域衡量配置中的网域,则不会触发出站点击事件。

相关参数会填充以下维度:

默认情况下通过增强型衡量功能收集。

link_classes、link_domain、link_id、link_url、outbound(布尔值)

当用户通过动态链接再次打开应用时触发

注意:由于 Firebase Dynamic Links 目前已被弃用,因此将逐步停用此事件。详细了解相应变化

source、medium、campaign、link_id、accept_time

当应用更新到新版本并通过动态链接打开时触发

仅限 Android 设备

注意:由于 Firebase Dynamic Links 目前已被弃用,因此将逐步停用此事件。详细了解相应变化

source、medium、campaign、link_id、accept_time

当用户通过动态链接首次打开应用时触发

注意:由于 Firebase Dynamic Links 目前已被弃用,因此将逐步停用此事件。详细了解相应变化

source、medium、campaign、link_id、accept_time

error

(应用)

当特定事件由于某种原因导致失效而无法记录时,系统就会改为记录此事件

_err (firebase_error)、_ev (firebase_error_value) 和 _el (firebase_error_length) 参数会提供额外的信息。

此事件不会在报告中显示,也不会导出到 BigQuery 中。

firebase_error、firebase_error_value

file_download

(网站)

当用户点击指向以下类型的文件(带有常见文件扩展名)的链接时触发:
  • 文档
  • 文本
  • 可执行文件
  • 演示文稿
  • 压缩文件
  • 视频
  • 音频

此事件在默认情况下通过增强型衡量功能收集。查看触发对应事件的文件扩展名

file_extension、file_name、link_classes、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 管理中心或 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

(应用、网站)

当用户首次访问/启动启用了 Google Analytics 的网站或 Android 免安装应用时触发 client_id, ga_session_id、ga_session_number、ignore_referrer、page_location、page_referrer、page_title、traffic_type

form_start

(网站)

当用户首次在会话中与表单互动时触发

默认情况下通过增强型衡量功能收集。

form_id、form_name、form_destination

form_submit

(网站)

当用户提交表单时触发

默认情况下通过增强型衡量功能收集。

form_id、form_name、form_destination、form_submit_text

in_app_purchase

(应用)

当用户完成由 Apple App Store 或 Google Play 商店处理的应用内购买交易(包括首次订阅)时触发

产品 ID、产品名称、币种和数量会以参数的形式传递。

只有包含 Google Analytics for Firebase SDK 的应用版本才会触发此事件。

Android:

若要查看 Android 应用的应用内购数据,请将 Google Analytics 关联到 Google Play

请注意,Google Analytics 不会自动衡量付费应用的购买收入。此外,您在 Google Analytics 中报告的收入可能与您在 Google Play 管理中心看到的值不同。

Google Analytics 会忽略标记为无效或测试的事件。不妨详细了解如何测试 Google Play 结算服务。

iOS:

请注意,Google Analytics 不会自动衡量付费应用的购买收入和退款。

Google Analytics 会忽略标记为无效或沙盒的事件。

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

os_update

(应用)

当设备操作系统更新为新版本时触发。旧版操作系统的版本 ID 会以参数的形式传递 previous_os_version

page_view

(网站)

每当网页加载或处于活动状态的网站更改浏览器历史记录状态时触发

默认情况下通过增强型衡量功能收集。

page_location(网页网址)、page_referrer(之前的网页网址)、engagement_time_msec

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

(应用、网站)

当用户与应用或网站互动时触发

系统会自动为每个会话生成会话 ID 和会话编号,并将其与会话中的每个事件相关联。了解详情

client_id, ga_session_id、ga_session_number、ignore_referrer、page_location、page_referrer、page_title、traffic_type

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

(网站)

每当用户执行网站搜索时触发,此类事件以网址查询参数表示

默认情况下通过增强型衡量功能收集。

search_term、可选的“q_<additional key="">”(其中 <additional key=""> 与您在“高级设置”下指定要收集的另一个查询参数匹配)

注意:只有当 unique_search_term 参数的值为 1(即相应字符串对该会话而言是唯一的)时,此事件才会发送该参数。

注意:若要在报告中使用这些参数,您必须为其创建自定义维度。您还可以使用探索工具,通过创建使用事件参数的细分,生成关于自定义参数的报告。详细了解细分生成工具

注意:与以下正则表达式匹配的文件扩展名将触发 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

该内容对您有帮助吗?

您有什么改进建议?
搜索
清除搜索内容
关闭搜索框
Google 应用
主菜单