自动收集的事件

Firebase 默认会采集这些事件的数据。

自动收集的事件会在用户与您的应用进行基本的互动时触发。只要您已经使用 Firebase SDK,则无需添加任何额外的代码即可收集这些事件。要查看事件报告,请在 Google Analytics(分析)中点击报告导航栏上的事件,或者在 Firebase 控制台中点击事件标签。

除非另有说明,否则 Google Analytics(分析)会针对 Android 和 iOS 应用收集这些事件。

事件名称 何时自动触发 参数
ad_click 当用户点击广告时触发
通过 Google 移动广告 SDK 从 AdMob 发布的发布商活动
ad_event_id
ad_exposure 当移动广告 SDK 投放的广告至少有一个在屏幕上时触发 firebase_screen、firebase_screen_id、firebase_screen_class、exposure_time
ad_impression 当用户看到广告展示时触发
通过 Google 移动广告 SDK 从 AdMob 发布的发布商活动
ad_event_id
ad_query 当移动广告 SDK 发出广告请求时触发 ad_event_id
ad_reward 当移动广告 SDK 投放的激励广告授予奖励时触发 ad_unit_id、reward_type、reward_value
adunit_exposure 当移动广告 SDK 投放的广告单元在屏幕上时触发 firebase_screen、firebase_screen_id、firebase_screen_class、exposure_time
app_clear_data 当用户进行重置/清除应用数据的操作而导致所有设置和登录数据被移除时触发  
app_exception 当应用崩溃或引发异常时触发 fatal、timestamp
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

当用户从免费试阅转换为付费订阅时触发

仅限 Android

此事件设置为默认转化。

必须是 2019 年 7 月 1 日或之后进行的首次订阅。系统会将首次免费试阅记录为 in_app_purchase,并且将订阅参数设为 true。

此事件不会导出到 BigQuery。

product_id、price、value、currency、quantity
app_store_subscription_renew

当用户续订付费订阅时触发

仅限 Android

此事件设置为默认转化。

必须是 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
first_open 当用户在安装或重新安装应用后首次启动该应用时触发
此事件在用户首次使用应用时触发,不会在用户将应用下载到设备上时触发。要查看原始下载量数据,请访问 Google Play 管理中心或 iTunesConnect。
previoius_gmp_app_id、updated_with_analytics、previous_first_open_count、system_app、system_app_update、deferred_analytics_collection、reset_analytics_cause
in_app_purchase

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

产品 ID、产品名称、币种和数量会作为参数传递。

要查看 Android 应用的 in_app_purchase 数据,您需要将 Firebase 关联到 Google Play

Analytics(分析)支持在 Android 设备上自动跟踪订阅情况。很快也将在 iOS 设备上支持此功能。

只有包含 Firebase SDK 的应用版本才会触发此事件。注意:系统不会自动跟踪付费应用购买收入和退款(仅限 iOS)。报告的收入可能与您在 Google Play 管理中心看到的值不同。标记为无效或沙盒(测试)的事件会被忽略。只有 iOS 事件会被标记为沙盒。详细了解如何测试 Google Play 结算服务。

product_id、price、value、currency、quantity、subscription、free_trial、introductory_price
notification_dismiss

当用户关闭 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
screen_view 当发生屏幕转换并符合以下条件之一时触发:
 
  • 之前没有设置屏幕
  • 新的屏幕名称与以前的屏幕名称不同
  • 新的屏幕类名称与以前的屏幕类名称不同
  • 新的屏幕 ID 与以前的屏幕 ID 不同
firebase_screen、firebase_screen_class、firebase_screen_id、firebase_previous_screen、firebase_previous_class、firebase_previous_id
session_start 在用户不活动的时间超过会话超时时长之后,当用户与应用互动的时间超过最短会话时长时触发。  
user_engagement 当应用在前台运行时周期性触发。 engagement_time_msec
该内容对您有帮助吗?
您有什么改进建议?