配置

本文档列出了 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 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 的网域。

设置为 '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
});

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