Firebase Analytics

关于 Analytics

• Google Analytics（分析）是一款免费的应用效果衡量解决方案，可提供关于应用的使用情况和用户互动度的数据分析
• 关于 iOS、Android、web 等项目配置，详细看这里
• 实时查看事件
  • 监控 DebugView 中的事件
    • DebugView 会实时显示从用户那里收集的事件和用户属性，常用于实时问题排查。使用该功能，必须启用调试模式才能使用 DebugView
    • Android 或 iOS 应用启用调试模式，详情看这里

    

    Snip20230913_6.png

• 当事件从应用中发出时，可以通过 Realtime 报告，实时监控网站或应用中发生的活动
  • 最近30分钟内的用户
  • 按第一个用户来源划分
  • 按用户划分
  • 按页面标题和屏幕名称查看
  • 按事件名称计算事件数
  • 按用户属性划分的用户

  

  Snip20230914_12.png

• DebugView 和 Realtime 区别 Realtime 报告 DebugView 报告 显示过去 30 分钟内的用户活动 显示超过 30 分钟内的用户活动（必须开启用户调试模式） 支持网站数据流和应用数据流 支持网站数据流和应用数据流 创建对比项查看特点数据 通过调试设备查看特定数据 可以查看用户概况 不支持 项目中任何人都可用 一般是开发人员使用

事件埋点

概述

通过事件，可以衡量您的网站或应用中发生的具体互动、操作或行为。例如，您可以使用事件来衡量用户加载页面、点击链接或完成购买之类的操作，或者衡量应用使用或展示广告等系统行为

自动收集的事件

• 只要使用 Firebase SDK 或 gtag.js，无需额外编写代码就能收集这些事件。常见如下表
• 查看全部事件参数

增强型衡量事件

• 如果启用了增强型衡量功能，系统就会自动收集的增强型衡量事件。可以通过 GA4 媒体资源中的“管理”页面启用/停用收集各种增强型衡量事件，更偏向与媒体方向。
• 查看全部事件参数

推荐事件

• 自行实现但采用 Google 预定义名称和参数的事件。推荐事件可解锁现有和未来的报告功能。目前有这几类推荐事件：所有媒体资源，零售/电子商务，招聘信息、教育、房地产，旅游，游戏等等
• 查看全部事件参数

自定义事件

可用于专门针对自己的业务和想分析的内容，收集有关用户如何与网站或应用互动的信息

查看全部事件参数

关于 iOS、Android、web 等项目配置，详细看这里

注意事项

• 创建自定义事件，应该避免与自动收集事件或推荐事件重复
• 事件名称区分大小写，即便两个事件的名称只是大小写不同，系统也会将其视作两种不同的事件
• 事件名称长度不得超过 40 个字符，超过则不记录
• 每个事件不得超过25个参数
• 每个用户每天只能上报 500 个事件（自动收集事件与增强推荐事件不记录在内）

以 iOS 为例

通用事件记录

[FIRAnalytics logEventWithName:@"current_page_is_first_page" parameters:@{@"page_name":@"first_page",@"page_count":@"a_1"}];

默认事件参数。一旦设置了默认参数，之后所有的事件记录都会默认加上该参数

[FIRAnalytics setDefaultEventParameters:@{@"current_page_color":@"blue"}];

设置用户属性

概述

• 用户属性是为了描述各个细分用户群而定义的属性，例如语言、地区。。。这些用户属性可用于定义您的应用的受众群体，受众群体可用于过滤报告、远程推送等等
• 对于 iOS 应用程序，启用 AdSupport 框架，才会自动上传年龄、性别和兴趣等属性，详情请见

关于受众群体

• 受众群体：信息传播的接收者，我们称他们为受众群体
• 每个项目最多可以创建 100 个受众群体
• 预定义的受众群体只有俩个。在远程推送中心，可对受众群体定向推送
  • All users：所有用过我们的 APP 的人
  • Buyer：进行过应用内购买或电子商务购买的用户

  

  Snip20230914_15.png

• 受众群体的创建与使用，详情可见

自动上传用户属性

• Analytics 会自动记录一些用户属性，无需添加任何代码
• 每个项目用户属性最多可以设置 25 个，需要注意的是，用户属性名称是区分大小写的
• 不得使用 Google 预留的几个用户属性，预留用户属性详情

设置用户属性

通过设置用户属性，在报告中用这些设置的属性进行对比或用作受众群体评估条件

关于 iOS、Android、web 等项目配置，详细看这里

以 iOS 为例

代码

[FIRAnalytics setUserPropertyString:@"13910733521" forName:@"car_number"];

在远程推送中可以使用按用户属性进行定向推送，如下图

Snip20230914_14.png

设置用户ID

• Analytics 可以设置 userID，通过 userID 可以分析更多的用户数据
• 可以使用我们自己的 userID，但是需要保证该 userID 只有我们可以使用，别人拿到这个 userID 是无法溯源到我们的用户，也可以把我们的 userID 通过哈希处理之后，再作为 Analytics 的 userID，用于分析数据等等
• 如果不设置 userID，Analytics 也可以正常使用，如果您只想查找单个设备上同一应用中属于同一用户的事件数据，则可以使用 user_pseudo_id。该值由 Analytics 自动生成，并随每个事件存储在 BigQuery 中
• 需要按照Google Analytics
• 关于 userID，详情可见

记录 UI 浏览量

• Analytics 会记录 UI 跳转，并将有关当前 UI 的信息附加到事件，可以记录每个 UI 的互动度或用户行为等指标
• 此类数据都是由系统自动收集的，也可以手动记录 UI 浏览量
• 自动记录 UI 跳转 Analytics 会自动记录应用中 UI 的一些信息，例如当前获得焦点的 UIViewController 或 Activity 的类名称。当发生 UI 跳转时，Analytics 会记录一个用于标识新屏幕的 screen_view 事件。系统会使用参数 firebase_screen_class（例如 menuViewController 或 MenuActivity）和生成的 firebase_screen_id 自动对这些 UI 上发生的事件进行标记。如果 APP 对每个 UI 使用不同的 UIViewController 或 Activity，Analytics 便能自动跟踪每个 UI 的转换，并生成按屏幕细分的用户互动度报告。如果 APP 未采用这一方法，也可以通过手动记录 screen_view 事件来生成这些报告
• 手动记录屏幕
  • 无论是否启用了自动记录功能，都可以手动记录 screen_view 事件。可以通过 onAppear 或 viewDidAppear 方法（Apple 平台）和 onResume (Android) 记录这些事件。
  • 如果未设置 screen_class，Analytics 会根据在进行调用时获得焦点的 UIViewController 或 Activity 设置默认值
  • 如果已在 APP 中停用调配，则必须手动设置所有屏幕名称
• 关于 iOS、Android 等项目配置，详细看这里