配置

本文档列出了 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
});

campaign_content

用于 A/B 测试和按内容定位的广告。使用 campaign_content 区分指向同一网址的不同广告或链接。

字段名称	类型	默认值
`campaign_content`	`string`	`undefined`

示例

在全局范围内设置

gtag('set', 'campaign_content', 'logolink');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'campaign_content': 'logolink'
});

campaign_id

用于标识此引荐引用的广告系列。使用 campaign_id 标识具体广告系列。

字段名称	类型	默认值
`campaign_id`	`string`	`undefined`

示例

在全局范围内设置

gtag('set', 'campaign_id', 'abc.123');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'campaign_id': 'abc.123'
});

campaign_medium

使用 campaign_medium 标识媒介，例如电子邮件或每次点击费用。

字段名称	类型	默认值
`campaign_medium`	`string`	`undefined`

示例

在全局范围内设置

gtag('set', 'campaign_medium', 'cpc');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'campaign_medium': 'cpc'
});

campaign_name

用于关键字分析。使用 campaign_name 标识具体的产品促销活动或战略性广告系列。

字段名称	类型	默认值
`campaign_name`	`string`	`undefined`

示例

在全局范围内设置

gtag('set', 'campaign_name', 'spring_sale');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'campaign_name': 'spring_sale'
});

campaign_source

使用 campaign_source 标识搜索引擎、简报名称或其他来源。

字段名称	类型	默认值
`campaign_source`	`string`	`undefined`

示例

在全局范围内设置

gtag('set', 'campaign_source', 'google');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'campaign_source': 'google'
});

campaign_term

用于付费搜索。使用 campaign_term 注明此广告的关键字。

字段名称	类型	默认值
`campaign_term`	`string`	`undefined`

示例

在全局范围内设置

gtag('set', 'campaign_term', 'running+shoes');

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'campaign_term': 'running+shoes'
});

campaign

一个对象，包含可设置的所有广告系列值。

我们提供 campaign 对象是为了支持旧版实现，在大多数情况下不推荐使用。相反，您应该使用各个字段带有 campaign 前缀的版本：

campaign_id
campaign_source
campaign_medium
campaign_name
campaign_term
campaign_content

字段名称	类型	默认值
`campaign`	`object`	`undefined`

示例

在全局范围内设置

gtag('set', 'campaign', {
  'id': 'abc.123',
  'source': 'google',
  'medium': 'cpc',
  'name': 'spring_sale',
  'term': 'running+shoes',
  'content': 'logolink'
});

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'campaign': {
    'id': 'abc.123',
    'source': 'google',
    'medium': 'cpc',
    'name': 'spring_sale',
    'term': 'running+shoes',
    'content': 'logolink'
  }
});

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_domain

指定用于存储分析 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'
});

cookie_expires

每次向 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_flags

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

字段名称	类型	默认值
`cookie_flags`	`string`

示例

在全局范围内设置

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

针对单个数据流设置

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

cookie_path

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

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

示例

在全局范围内设置

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

针对单个数据流设置

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

cookie_prefix

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

字段名称	类型	默认值
`cookie_prefix`	`string`

示例

在全局范围内设置

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

针对单个数据流设置

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

cookie_update

当 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
});

ignore_referrer

设为 true 以向 Google Analytics（分析）表明相应引荐来源网址不应显示为流量来源。了解在什么情况下使用这个字段

字段名称	类型	默认值
`ignore_referrer`	`boolean`	false

示例

在全局范围内设置

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

针对单个数据流设置

gtag('config', 'STREAM_ID', {
  'ignore_referrer': 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`	1000

示例

在全局范围内设置

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`	420

示例

在全局范围内设置

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`	300

示例

在全局范围内设置

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`		256

示例

在全局范围内设置

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

针对单个数据流设置

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

user_properties

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

字段名称	类型	默认值	字符数限制
`user_properties`	`object`		属性名称=24 属性值=36

示例

在全局范围内设置

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

针对单个数据流设置

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