配置

本文档列出了 GA4 的所有配置字段。

allow_google_signals

要停用所有广告功能,请将 allow_google_signals 设置为 false

字段名称 类型 默认值
allow_google_signals boolean true

示例

在全局范围内设置

gtag('set', 'allow_google_signals', true);

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'allow_google_signals': true
});

allow_ad_personalization_signals

设置为 false 可停用广告个性化功能。

字段名称 类型 默认值
allow_ad_personalization_signals boolean true

示例

在全局范围内设置

gtag('set', 'allow_ad_personalization_signals', true);

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'allow_ad_personalization_signals': true
});

client_id

以假名方式标识浏览器实例。默认情况下,此值作为第一方 Google Analytics(分析)Cookie 的一部分进行存储,有效期为 2 年。

字段名称 类型 默认值
client_id string 为每位用户随机生成的值。

示例

在全局范围内设置

gtag('set', 'client_id', 'aaa.bbb');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'client_id': 'aaa.bbb'
});

content_group

字段名称 类型 默认值
content_group string

示例

在全局范围内设置

gtag('set', 'content_group', '/news/sports');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'content_group': '/news/sports'
});

指定用于存储分析 Cookie 的网域。

设置为 'none' 可在不指定网域的情况下设置 Cookie。

设置为 'auto'(默认值)可将 Cookie 设置为存储到顶级网域和一个子网域 (eTLD +1)。例如,如果 cookie_domain 设置为 'auto'https://example.com 会将 example.com 用作网域,https://subdomain.example.com 也会将 example.com 用作网域。

字段名称 类型 默认值
cookie_domain string 'auto'

在全局范围内设置

gtag('set', 'cookie_domain', 'example.com');

针对单个数据流设置

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

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

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

字段名称 类型 默认值
cookie_expires number 63072000

在全局范围内设置

gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);

针对单个数据流设置

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

如果设置了“Cookie 标记”值,则会在 Cookie 后追加额外的标记。各标记间必须用英文分号分隔。如需查看要设置的标记的一些示例,请参阅写入新 Cookie

字段名称 类型 默认值
cookie_flags string

在全局范围内设置

gtag('set', 'cookie_flags', 'SameSite=None;Secure');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'cookie_flags': 'SameSite=None;Secure'
});

指定用于存储分析 Cookie 的子路径。

字段名称 类型 默认值
cookie_path string '/'

在全局范围内设置

gtag('set', 'cookie_path', '/example_path');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'cookie_path': '/example_path'
});

指定要附加到分析 Cookie 名称前面的前缀。

字段名称 类型 默认值
cookie_prefix string

在全局范围内设置

gtag('set', 'cookie_prefix', 'prefix');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'cookie_prefix': 'prefix'
});

cookie_update 设置为 true 时,gtag.js 会在每次网页加载时更新 Cookie。这样一来,系统在更新 Cookie 有效期时会以最近一次访问网站的时间为起点。例如,如果将 Cookie 有效期设置为 1 周,假使某位用户每 5 天使用同一浏览器访问一次网站,那么 Cookie 有效期在用户每次访问时都会更新,实际上将永远不会过期。

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

字段名称 类型 默认值
cookie_update boolean true

在全局范围内设置

gtag('set', 'cookie_update', true);

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'cookie_update': true
});

language

指定用户的语言偏好设置。默认值为用户的 navigator.language 值。

字段名称 类型 默认值
language string 默认值将为 navigator.language

示例

在全局范围内设置

gtag('set', 'language', 'en-us');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'language': 'en-us'
});

page_location

指定网页的完整网址。默认值为用户的 document.location 值。

字段名称 类型 默认值
page_location string 默认值将为 document.location

示例

在全局范围内设置

gtag('set', 'page_location', 'https://example.com/page1');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'page_location': 'https://example.com/page1'
});

page_referrer

指明哪个引荐来源给网页带来了流量。此值还可用于计算流量来源。此值的格式为网址。默认值为用户的 document.referrer 值。

字段名称 类型 默认值
page_referrer string 默认值将为 document.referrer

示例

在全局范围内设置

gtag('set', 'page_referrer', 'https://example.com');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'page_referrer': 'https://example.com'
});

page_title

网页或文档的标题。默认值为用户的 document.title 值。

字段名称 类型 默认值
page_title string 默认值将为 document.title

示例

在全局范围内设置

gtag('set', 'page_title', 'Settings');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'page_title': 'Settings'
});

send_page_view

设置为 false 可阻止默认代码段发送 page_view。

字段名称 类型 默认值
send_page_view boolean true

示例

在全局范围内设置

gtag('set', 'send_page_view', false);

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'send_page_view': false
});

screen_resolution

指定屏幕的分辨率。此值应为两个由 x 分隔的正整数。例如,对于 800 x 600 像素的屏幕,此值将为 800x600。根据用户的 window.screen 值计算得出。

字段名称 类型 默认值
screen_resolution string 默认值将根据 window.screen 计算得出

示例

在全局范围内设置

gtag('set', 'screen_resolution', '800x600');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'screen_resolution': '800x600'
});

user_id

指定由网站所有者/库用户提供的已知用户标识符。此值本身不得为个人身份信息,也绝不应持久保存在 Google Analytics(分析)Cookie 或 Google Analytics(分析)提供的其他存储中。

字段名称 类型 默认值
user_id string

示例

在全局范围内设置

gtag('set', 'user_id', 'id');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'user_id': 'id'
});

user_properties

用户属性是可用于描述用户群细分的属性,例如语言偏好设置或地理位置。每个项目最多可以设置 25 个其他用户属性。

字段名称 类型 默认值
user_properties object

示例

在全局范围内设置

gtag('set', 'user_properties', {
  'favorite_color': 'blue'
});

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'user_properties': {
    'favorite_color': 'blue'
  }
});