Google Analytics代码更新

不知道从啥时候开始,Google Analytics代码更新了,换成了全局网站代码gtag.js

代码换了之后,以前的添加的网页跟踪和事件跟踪都失效了,需要统一的替换(如果没有必要还是别折腾了)!

网页跟踪

全局跟踪代码段中的以下代码会自动向跟踪 IDGA_TRACKING_ID 的 Google Analytics(分析)媒体资源发送网页浏览:

gtag('config', 'GA_TRACKING_ID');

网页浏览参数

参数名称值类型是否必须提供说明
page_titlestring网页的标题。
page_locationstring网页的网址。
page_pathstringlocation 的路径部分。此值应以斜杠 (/) 字符开头。

例如:

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_categorystring事件所属的类别(例如 engagement)
event_actionstring互动的类型(例如 login)。event_name 是 event_action 的默认值。
event_labelstring该事件的附加信息(例如 article (所选内容类型))
valueinteger与事件关联的非负数值(例如 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
});

异常参数

参数名称值类型是否必须提供说明
descriptionstring错误的说明。
fatalboolean如果错误很严重,则设为 true。

设置 User ID

要使用 gtag.js 实现 User ID,请更新您的媒体资源的 config 以设置 User ID

gtag('config', 'GA_TRACKING_ID', {
  'user_id': 'USER_ID'
});

自定义维度和指标

自定义参数

自定义参数数据类型说明
dimensionstring自定义维度参数(即 dimension3)
metricstring自定义指标参数(即 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

添加新评论