GA4采用事件驱动的数据模型,所有用户行为最终都会以事件的形式发送到GA4,统一采用事件名称+ 事件参数来描述用户行为。
因此,理解GA4事件参数,是学习GA4事件追踪、数据分析以及自定义报表的基础。
什么是GA4事件参数?
GA4中的每一个事件,都由两部分组成:
- 事件名称(Event Name):描述用户做了什么。
- 事件参数(Event Parameters):描述行为发生时的详细信息。
可以理解为:
事件名称告诉GA4「发生了什么」,事件参数告诉GA4「行为发生时有哪些上下文信息」。
例如,一个用户将商品加入购物车:
事件名称:add_to_cart
事件参数:
- item_name = GA4
- Book price = 199
- currency = CNY
- quantity = 1
其中:
- add_to_cart 表示用户进行了加入购物车操作。
- item_name 表示商品名称。
- price 表示商品价格。
- currency 表示货币类型。
- quantity 表示购买数量。
事件名称负责描述行为,事件参数则负责提供更多业务信息,后续GA4的探索分析、标准报告以及BigQuery分析,都可以基于这些事件参数进行统计。
事件参数的限制
设计事件参数时,需要注意GA4的限制:
- 每个事件最多可以携带25个事件参数。
- 参数名称最长40个字符。
- 参数名称区分大小写,例如 button_name 与 Button_Name 会被视为两个不同参数。
- 参数名称必须以字母开头,只能包含字母、数字和下划线(_),不能包含空格。
事件参数的类型
GA4中的事件参数可以分为两类。
默认事件参数
GA4会自动附带部分事件参数,无需自行设置。
网站常见默认事件参数包括:
- language:浏览器语言
- page_location:当前页面完整网址(最长 1000 字节)
- page_referrer:来源页面网址(最长 420 字节)
- page_title:页面标题(最长 300 字节)
- screen_resolution:屏幕分辨率
App常见默认事件参数包括:
- app_version:App 版本
- firebase_screen_id:页面 ID
- firebase_screen_class:页面类别
自定义事件参数
除了默认事件参数,还可以根据业务需求建立自定义事件参数。
自定义事件参数根据数据类型可以分为两类:
- 文本型参数(String):用于记录文字信息,例如按钮名称、会员等级、文章分类等,通常注册为事件级别自定义维度。
- 数值型参数(Numeric):用于记录数值信息,例如阅读时长、积分、折扣金额等,通常注册为事件级别自定义指标。
注册事件参数
自定义事件参数发送到GA4后,并不会自动出现在标准报告和探索中。
如果希望作为维度或指标进行分析,需要先在GA4中完成注册。
- 文本型参数(String):需要注册为事件级别自定义维度,最多50 个
- 数值型参数(Numeric):需要注册为事件级别自定义指标,最多50 个
注册自定义维度page_url
在GA4中点击「管理」——「自定义设置」——「创建自定义维度」,然后做如下设置:
注册自定义指标value
在GA4中点击「管理」——「自定义设置」——「自定义指标」——「创建自定义指标」,然后做如下设置:
这样就设置完成了。


