Cookie 和使用 gtag.js 进行用户识别

gtag.js 使用 Cookie 来识别跨浏览会话的唯一身份用户。本指南介绍了如何自定义 Cookie 设置。

下表显示了 gtag.js 使用的默认 Cookie 字段值:

字段名称 值类型 默认值
cookie_name string _ga
cookie_domain string auto
cookie_expires integer 63072000(两年,以秒为单位)

要更改其中任何值,请更新媒体资源的 config 以在参数列表中加以指定。例如:

gtag('config', 'GA_TRACKING_ID', {
  'cookie_name': 'gaCookie',
  'cookie_domain': 'blog.example.co.uk',
  'cookie_expires': 2419200  // 28 days, in seconds
});

默认情况下,gtag.js 启用了自动 Cookie 网域配置。启用后,自动 Cookie 网域配置将 _ga cookie 设置为所允许的最高级网域。例如,如果您的网站地址是 blog.example.co.uk,则 gtag.js 会将 Cookie 网域设置为 example.co.uk。如果 gtag.js 检测到您正在本地运行服务器(例如 localhost),它会自动将 cookie_domain 设置为 'none'

要关闭自动 Cookie 网域配置,请更新您的媒体资源的 config 以指定 cookie_domain 参数的值:

gtag('config', 'GA_TRACKING_ID', {
  'cookie_domain': 'blog.example.co.uk'
});

每次当匹配发送至 Google Analytics(分析)时,Cookie 过期时间都会更新为当前时间加上 cookie_expires 字段的值。这意味着,如果您使用默认的 cookie_expires 时间(两年),而用户每个月都会访问您的网站,那么他们的 Cookie 永远都不会过期。

如果您将 cookie_expires 时间设为 0(零)秒,Cookie 将变成基于会话的 Cookie,并在当前浏览器会话结束后马上过期。

设置 User ID

User ID 是代表用户的独一无二的永久性非个人身份 ID 字符串。它可以跨设备分析会话组。要了解为何应实现 User ID,请查看使用 User ID 功能的优势

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

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