配置和自定义 Cookie

如果开发者想要使用 Google 代码或 Google 跟踪代码管理器自定义 Cookie 设置，请参阅本页内容。如果您不确定自己是否需要配置 Cookie，请参阅 Cookie 和用户识别。

默认情况下，Google 代码使用 Cookie 网域自动配置。Cookie 会尽可能在最高一级网域上进行设置。例如，如果您网站的网址为 blog.example.com，则 Cookie 在 example.com 网域上进行设置。如果系统检测到您正在本地运行服务器（例如 localhost），则会自动将 cookie_domain 设置为 'none'，并且 Cookie 将使用文档位置中的完整域名。

如果您只想修改 Cookie 有效期或 Cookie 更新设置，则可以使用 Google Analytics（分析）界面更改默认 Cookie 设置。

对于大多数网站和应用来说，也应根据用户同意情况来控制 Cookie 的存储行为。用户隐私概览一文中介绍了一些用于管理用户意见征求的选项。

在使用 Cookie 网域自动配置的情况下，无需任何额外配置即可跨所有子网域衡量用户活动。

若要更改 Cookie 网域配置，请按以下步骤操作：

gtag.js

若要关闭 Cookie 网域自动配置，请更新您的代码的 config 以指定 cookie_domain 参数的值：

gtag('config', 'TAG_ID', {
  'cookie_domain': 'blog.example.com'
});

跟踪代码管理器

对于 Google 代码：

  1. 在您的工作区中，打开代码菜单。
  2. 修改现有的 Google 代码或创建新代码。

  3. 在配置设置中，添加新参数：

    • 名称：cookie_domain
    • 值：my.example.com

  4. 保存代码并发布容器。

    对于 Google Ads 代码和 Floodlight 代码：

    网域设置可通过转化链接器代码进行修改：

    1. 在跟踪代码管理器中，打开您的现有转化链接器代码，或者创建一个转化链接器代码（如果您的容器中还没有的话）。
    2. 在链接器选项下，点击替换 Cookie 设置（高级）
    3. 在网域字段中，输入应允许设置 Cookie 的最高一级网域。您还可以在路径字段中指定特定路径。只有当您需要将 Cookie 限定到级别较低的子网域或子目录时才使用这些设置。

对于 Universal Analytics 代码：

  1. 在跟踪代码管理器中，打开代码菜单。
  2. 修改现有的 Universal Analytics 代码，或创建新代码。
  3. 创建新的 Google Analytics（分析）设置变量。依次选择变量配置 > 更多设置 > 要设置的字段。
  4. 展开“要设置的字段”部分后，点击添加行。
  5. 在字段名称中，输入 cookieDomain。
  6. 对于值，请输入网域值，例如 my.example.com。
  7. 保存代码并发布。

重命名 Cookie

为避免与其他 Cookie 产生冲突，您可能需要更改 Cookie 名称。

gtag.js

此配置会在其设置的 Cookie 的开头添加 example（例如，_ga 变为 example_ga，或 _gcl_au 变为 example_gcl_au）：

gtag('config', 'TAG_ID', {
  cookie_prefix: 'example'
});

跟踪代码管理器

对于 Google 代码：

  1. 在您的工作区中，打开代码菜单。
  2. 修改现有的 Google 代码或创建新代码。

  3. 在配置设置中，添加新参数：

    • 名称：cookie_prefix
    • 值：example

  4. 保存代码并发布容器。

对于 Universal Analytics 代码：

跟踪代码管理器中的 Universal Analytics 代码可通过 Google Analytics（分析）设置变量将 Cookie 名称替换为 cookieName。

  1. 在跟踪代码管理器中，打开 Google Analytics（分析）设置变量，然后依次选择变量配置 > 更多设置 > 要设置的字段。
  2. 展开“要设置的字段”部分后，点击添加行。
  3. 对于字段名称，请输入 cookieName。
  4. 对于值，请输入 Cookie 名称，例如 myCookie。
  5. 保存代码并发布。

对于 Google Ads 代码和 Floodlight 代码：

名称前缀设置可通过转化链接器代码进行修改：

1.  In Tag Manager, open your existing Conversion Linker tag, or create
    one if the tag doesn't yet exist in your container.
  1. 在链接器选项下，点击替换 Cookie 设置（高级）
  2. 在名称前缀字段中，输入所需的名称前缀。此外，凡是使用这些 Cookie 的代码（例如 Google Ads 转化跟踪代码）也均须配置为使用相同的前缀。

每次加载网页时，Cookie 有效期都会更新为当前时间加上 Google 代码设置的 Cookie 有效期值。也就是说，如果将 Cookie 有效期设置为 1 周（604800 秒），假使某位用户在 5 天内使用同一浏览器进行访问，那么 Cookie 的有效期将从访问时间起延续 1 周，这些访问在您的报告中将显示为由同一用户进行。如果该用户在原始 Cookie 过期之后访问，系统会新建一个 Cookie，那么该用户的第一次访问和第二次访问在您的报告中将显示为来自不同的访问者。

如果您将 Cookie 有效期值设置为 0（零）秒，Cookie 将变成基于会话的 Cookie，并在当前浏览器会话结束后马上过期。

gtag.js

gtag('config', 'TAG_ID', {
  cookie_expires: 28 * 24 * 60 * 60 // 28 days, in seconds
});

跟踪代码管理器

对于 Google 代码：

  1. 在您的工作区中，打开代码菜单。
  2. 修改现有的 Google 代码或创建新代码。

  3. 在配置设置中，添加新参数：

    • 名称：cookie_expires
    • 值：2419200

  4. 保存代码并发布容器。

对于 Universal Analytics 代码：

  1. 在您的工作区中，打开代码菜单。
  2. 修改现有的 Universal Analytics 代码。
  3. 创建新的 Google Analytics（分析）设置变量。依次选择变量配置 > 更多设置 > 要设置的字段。
  4. 展开“要设置的字段”部分后，点击添加行。
  5. 在字段名称中，输入 cookieExpires。
  6. 对于值，请输入 Cookie 过期前的秒数（例如，如果有效期是 28 天，请输入 2419200）。
  7. 保存代码并发布容器。

当 cookie_update 标志设置为 true（默认值）时，Google 代码可能会在每次网页加载时更新 Cookie，并且在更新 Cookie 有效期时可能会以最近一次访问网站的时间为起点。例如，如果将 Cookie 有效期设置为 1 周，假使某位用户每 5 天使用同一浏览器访问一次网站，那么 Cookie 有效期在用户每次访问时都会更新，实际上将永远不会过期。

设置为 false 时，Cookie 不会在每次网页加载时更新。这样一来，Cookie 有效期会以用户首次访问网站的时间为起点。

gtag.js

gtag('config', 'TAG_ID', {
  cookie_update: false
});

跟踪代码管理器

对于 Google 代码：

  1. 在您的工作区中，打开代码菜单。
  2. 修改现有的 Google 代码或创建新代码。

  3. 在配置设置中，添加新参数：

    • 名称：cookie_update
    • 值：false

  4. 保存代码并发布容器。

对于 Universal Analytics 代码：

  1. 在您的工作区中，打开代码菜单。
  2. 修改现有的 Universal Analytics 代码。
  3. 创建新的 Google Analytics（分析）设置变量。依次选择变量配置 > 更多设置 > 要设置的字段。
  4. 展开“要设置的字段”部分后，点击添加行。
  5. 在字段名称中，输入 cookieUpdate。
  6. 对于值，请输入布尔值，例如 false。
  7. 保存代码并发布容器。