Google Analytics代码更新
不知道从啥时候开始,Google Analytics代码更新了,换成了全局网站代码gtag.js
。
代码换了之后,以前的添加的网页跟踪和事件跟踪都失效了,需要统一的替换(如果没有必要还是别折腾了)!
网页跟踪
全局跟踪代码段中的以下代码会自动向跟踪 ID
为 GA_TRACKING_ID
的 Google Analytics(分析)媒体资源发送网页浏览:
gtag('config', 'GA_TRACKING_ID');
网页浏览参数
参数名称 | 值类型 | 是否必须提供 | 说明 |
---|---|---|---|
page_title | string | 否 | 网页的标题。 |
page_location | string | 否 | 网页的网址。 |
page_path | string | 否 | location 的路径部分。此值应以斜杠 (/) 字符开头。 |
例如:
gtag('config', 'GA_TRACKING_ID', {
'page_title': '王叨叨',
'page_location': 'http://wangdaodao.com/home',
'page_path': '/home'
});
发送事件
要发送已添加跟踪代码段的网页上的事件,请使用以下 event
命令:
gtag('event', 'event_name', {
// Event parameters
'parameter_1': 'value_1',
'parameter_2': 'value_2',
// ...
});
事件参数
参数名称 | 值类型 | 是否必须提供 | 说明 |
---|---|---|---|
event_category | string | 否 | 事件所属的类别(例如 engagement) |
event_action | string | 否 | 互动的类型(例如 login)。event_name 是 event_action 的默认值。 |
event_label | string | 否 | 该事件的附加信息(例如 article (所选内容类型)) |
value | integer | 否 | 与事件关联的非负数值(例如 42) |
例如:
gtag('event', 'download', {
'event_category': 'resource',
'event_label': 'PDF'
});
异常跟踪
发生错误时,向 Google Analytics(分析)发送 exception
事件:
gtag('event', 'exception', {
'description': 'error_description',
'fatal': false // set to true if the error is fatal
});
异常参数
参数名称 | 值类型 | 是否必须提供 | 说明 |
---|---|---|---|
description | string | 否 | 错误的说明。 |
fatal | boolean | 否 | 如果错误很严重,则设为 true。 |
设置 User ID
要使用 gtag.js
实现 User ID
,请更新您的媒体资源的 config
以设置 User ID
:
gtag('config', 'GA_TRACKING_ID', {
'user_id': 'USER_ID'
});
自定义维度和指标
自定义参数
自定义参数 | 数据类型 | 说明 |
---|---|---|
dimension | string | 自定义维度参数(即 dimension3) |
metric | string | 自定义指标参数(即 metric8) |
配置和发送自定义维度
要向 Google Analytics(分析)发送自定义维度,请更新您媒体资源的 config
,以设置维度的 custom_map
参数,然后使用自定义参数发送自定义维度的值:
// Configures custom dimension<Index> to use the custom parameter
// 'dimension_name' for 'GA_TRACKING_ID', where <Index> is a number
// representing the index of the custom dimension.
gtag('config', 'GA_TRACKING_ID', {
'custom_map': {'dimension<Index>': 'dimension_name'}
});
// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'dimension_name': dimension_value});
配置和发送自定义指标
要向 Google Analytics(分析)发送自定义指标,请更新您媒体资源的 config
,以设置指标的 custom_map
参数,然后使用自定义参数发送自定义指标的值:
// Configures custom metric<Index> to use the custom parameter
// 'metric_name' for GA_TRACKING_ID, where <Index> is a number
// representing the index of the custom metric.
gtag('config', 'GA_TRACKING_ID', {
'custom_map': {'metric<Index>': 'metric_name'}
});
// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'metric_name': metric_value});
官方也给出了从 analytics.js 迁移至 gtag.js的帮助文档:https://developers.google.com/analytics/devguides/collection/gtagjs/migration