自动收集的事件会在用户与您的应用和/或网站进行基本互动时触发(如下表中事件名称下所示)。只要您使用 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_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 |
|
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(布尔值) |
dynamic_link_app_open (应用) |
当用户通过动态链接再次打开应用时触发 注意:由于 Firebase Dynamic Links 目前已被弃用,因此将逐步停用此事件。详细了解相应变化。 |
source、medium、campaign、link_id、accept_time |
dynamic_link_ app_update (应用) |
当应用更新到新版本并通过动态链接打开时触发 仅限 Android 设备 注意:由于 Firebase Dynamic Links 目前已被弃用,因此将逐步停用此事件。详细了解相应变化。 |
source、medium、campaign、link_id、accept_time |
dynamic_link_ first_open (应用) |
当用户通过动态链接首次打开应用时触发 注意:由于 Firebase Dynamic Links 目前已被弃用,因此将逐步停用此事件。详细了解相应变化。 |
source、medium、campaign、link_id、accept_time |
error (应用) |
当特定事件由于某种原因导致失效而无法记录时,系统就会改为记录此事件 此事件不会在报告中显示,也不会导出到 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 (应用) |
当发生屏幕转换且符合以下任一条件时触发:
|
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