本文档列出了 Measurement Protocol 的所有参数。
常规
协议版本
对所有命中类型而言都是必填项。
协议的版本。当前值为“1”。只有出现不向后兼容的更改时,此值才会改变。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
v |
text | 无 | 无 | 全部 |
1
用法示例:
v=1
跟踪 ID/ 网站媒体资源 ID
对所有命中类型而言都是必填项。
跟踪 ID / 网站媒体资源 ID。格式为 UA-XXXX-Y。收集的所有数据都与此 ID 相关联。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
tid |
text | 无 | 无 | 全部 |
UA-XXXX-Y
用法示例:
tid=UA-XXXX-Y
掩盖 IP
选填。
启用后,发送者的 IP 地址将被掩盖。例如,如果有效负载中存在以下任何参数,则 IP 将被掩盖:&aip=、&aip=0 或 &aip=1
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
aip |
boolean | 无 | 无 | 全部 |
1
用法示例:
aip=1
停用广告个性化功能
选填。
使用此参数可将事件标记为已停用广告个性化功能,包括针对某媒体资源中已允许投放个性化广告的事件。例如,如果将某笔交易标记为停用广告个性化功能,那么系统在针对“过往购买者”填充再营销受众群体时将不会使用该交易。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
npa |
boolean | 无 | 无 | 全部 |
1
用法示例:
npa=1
数据源
选填。
表示命中的数据源。从 analytics.js 发送的命中的数据来源设置为“web”,从其中一个移动 SDK 发送的命中的数据来源设置为“app”。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ds |
text | 无 | 无 | 全部 |
web
用法示例:
ds=web
app
用法示例:
ds=app
call center
用法示例:
ds=call%20center
crm
用法示例:
ds=crm
队列时间
选填。
用于收集线下/潜藏命中。此值表示所报告匹配的发生时间和发送时间的间隔(以毫秒表示)。此值必须大于等于 0。大于 4 小时的值会导致此匹配不能得到处理。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
qt |
integer | 无 | 无 | 全部 |
560
用法示例:
qt=560
缓存无效化宏
选填。
用于在 GET 请求中发送一个随机数,确保浏览器和代理服务器不对匹配进行缓存。它应作为请求的最后一个参数发送,因为我们曾发现某些第三方互联网过滤软件向 HTTP 请求错误地附加参数。此值不会用于报告。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
z |
text | 无 | 无 | 全部 |
289372387623
用法示例:
z=289372387623
用户
Client-ID
选填。
如果请求中未指定用户 ID (uid),则必须填写此字段。以假名化方式标识特定用户、设备或浏览器实例。对于网页而言,此值一般以第一方 Cookie 的形式存储在本地,有效期为两年。对于移动应用而言,此值会针对每个应用安装实例随机生成。此字段的值应为一个随机 UUID(版本 4),如 http://www.ietf.org/rfc/rfc4122.txt 所述。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
cid |
text | 无 | 无 | 全部 |
35009a79-1a05-49d7-b876-2b884d0f825b
用法示例:
cid=35009a79-1a05-49d7-b876-2b884d0f825b
用户 ID
选填。
如果请求中未指定客户 ID (cid),则此字段为必填字段。此值应该是由网站所有者/库用户提供的已知用户标识符。此值本身不得为个人身份信息 (PII),也绝不应持久保存在 Google Analytics(分析)Cookie 或 Google Analytics(分析)提供的其他存储中。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
uid |
text | 无 | 无 | 全部 |
as8eknlll
用法示例:
uid=as8eknlll
会话
会话控制
选填。
用于控制会话时长。将值设为“start”将强制以此匹配开始新会话,而“end”则会强制当前对话以此匹配结束。所有其他值都会被忽略。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
sc |
text | 无 | 无 | 全部 |
start
用法示例:
sc=start
end
用法示例:
sc=end
IP 替换
选填。
用户的 IP 地址。这应该是 IPv4 或 IPv6 格式的有效 IP 地址。此值会始终被匿名化,就像使用了&aip(匿名化IP)参数一样。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
uip |
text | 无 | 无 | 全部 |
1.2.3.4
用法示例:
uip=1.2.3.4
用户代理替换
选填。
浏览器的用户代理。请注意,Google 提供了相应的库来辨识真实的用户代理。手动构建代理信息随时都可能失效。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ua |
text | 无 | 无 | 全部 |
Opera/9.80 (Windows NT 6.0) Presto/2.12.388 Version/12.14
用法示例:
ua=Opera%2F9.80%20%28Windows%20NT%206.0%29%20Presto%2F2.12.388%20Version%2F12.14
地理位置替换
选填。
用户所在的地理位置。地理位置 ID 应该是两个字母的国家/地区代码或表示城市或区域的条件 ID(请参阅 http://developers.google.com/analytics/devguides/collection/protocol/v1/geoid)。此参数的优先级高于源自 IP 地址的任何位置信息,包括 IP 替换参数。无效的代码将导致地理位置维度被设置为“(未设置)”。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
geoid |
text | 无 | 无 | 全部 |
US
用法示例:
geoid=US
21137
用法示例:
geoid=21137
流量来源
文档引荐来源网址
选填。
指明哪个引荐来源给网站带来了流量。此值也将用于计算流量来源。此值的格式是网址。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
dr |
text | 无 | 2048 字节 | 全部 |
http://example.com
用法示例:
dr=http%3A%2F%2Fexample.com
活动名称
选填。
指定广告系列名称。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
cn |
text | 无 | 100 字节 | 全部 |
(direct)
用法示例:
cn=%28direct%29
广告系列来源
选填。
指定广告系列来源。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
cs |
text | 无 | 100 字节 | 全部 |
(direct)
用法示例:
cs=%28direct%29
广告系列媒介
选填。
指定广告系列媒介。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
cm |
text | 无 | 50 字节 | 全部 |
organic
用法示例:
cm=organic
广告系列关键字
选填。
指定广告系列关键字。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ck |
text | 无 | 500 字节 | 全部 |
Blue Shoes
用法示例:
ck=Blue%20Shoes
广告系列内容
选填。
指定广告系列内容。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
cc |
text | 无 | 500 字节 | 全部 |
content
用法示例:
cc=content
广告系列 ID
选填。
指定广告系列 ID。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ci |
text | 无 | 100 字节 | 全部 |
ID
用法示例:
ci=ID
Google Ads ID
选填。
指定 Google 广告 ID。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
gclid |
text | 无 | 无 | 全部 |
CL6Q-OXyqKUCFcgK2goddQuoHg
用法示例:
gclid=CL6Q-OXyqKUCFcgK2goddQuoHg
Google 展示广告 ID
选填。
指定 Google 展示广告 ID。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
dclid |
text | 无 | 无 | 全部 |
d_click_id
用法示例:
dclid=d_click_id
系统信息
屏幕分辨率
选填。
指定屏幕分辨率。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
sr |
text | 无 | 20 字节 | 全部 |
800x600
用法示例:
sr=800x600
视口大小
选填。
指定浏览器/设备的可视区域大小。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
vp |
text | 无 | 20 字节 | 全部 |
123x456
用法示例:
vp=123x456
文档编码
选填。
指定用于给网页 / 文档编码的字符集。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
de |
text |
UTF-8
|
20 字节 | 全部 |
UTF-8
用法示例:
de=UTF-8
屏幕颜色
选填。
指定屏幕颜色深度。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
sd |
text | 无 | 20 字节 | 全部 |
24-bits
用法示例:
sd=24-bits
用户语言
选填。
指定语言。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ul |
text | 无 | 20 字节 | 全部 |
en-us
用法示例:
ul=en-us
已启用 Java
选填。
指定是否启用了 Java。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
je |
boolean | 无 | 无 | 全部 |
1
用法示例:
je=1
Flash 版本
选填。
指定 Flash 版本。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
fl |
text | 无 | 20 字节 | 全部 |
10 1 r103
用法示例:
fl=10%201%20r103
命中
命中类型
对所有命中类型而言都是必填项。
命中的类型。必须是“pageview”、“screenview”、“event”、“transaction”、“item”、“social”、“exception”、“timing”中的一个。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
t |
text | 无 | 无 | 全部 |
pageview
用法示例:
t=pageview
非互动命中
选填。
指定是否将命中视为非互动性质。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ni |
boolean | 无 | 无 | 全部 |
1
用法示例:
ni=1
内容信息
文档位置网址
选填。
使用此值来发送内容所在网页的完整网址(文档位置)。您可以使用 &dh 和 &dp 参数来分别替换文档位置中的“主机名”和“路径 + 查询”部分。JavaScript 客户端会将以下浏览器参数连接形成此参数:document.location.origin + document.location.pathname + document.location.search。请务必从网址中移除所有用户身份信息或其他隐私信息(如果有)。对于“pageview”匹配,必须指定 &dl,或同时指定 &dh 与 &dp,以使相应匹配有效。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
dl |
text | 无 | 2048 字节 | 全部 |
http://foo.com/home?a=b
用法示例:
dl=http%3A%2F%2Ffoo.com%2Fhome%3Fa%3Db
文档主机名
选填。
指定托管内容的主机名。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
dh |
text | 无 | 100 字节 | 全部 |
foo.com
用法示例:
dh=foo.com
文档路径
选填。
网页网址的路径部分。应以“/”开头。对于“pageview”命中,必须指定 &dl,或同时指定 &dh 和 &dp,才能使命中有效。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
dp |
text | 无 | 2048 字节 | 全部 |
/foo
用法示例:
dp=%2Ffoo
文档标题
选填。
网页 / 文档的标题。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
dt |
text | 无 | 1500 字节 | 全部 |
Settings
用法示例:
dt=Settings
屏幕名称
对于屏幕浏览命中类型来说是必填项。
在网站媒体资源上,此参数是选填项,而对移动媒体资源上的屏幕浏览命中而言,此参数是必填项,因为在移动媒体资源上,此参数会被用做屏幕浏览命中的“Screen Name”。在网络媒体资源上,此字段将默认设为网页的专属网址,原样使用 &dl 参数或组合使用 &dh 和 &dp。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
cd |
text | 无 | 2048 字节 | 屏幕浏览 |
High Scores
用法示例:
cd=High%20Scores
内容组
选填。
您最多可以有 5 个内容分组,每个内容分组都有关联的索引(1-5,含 1 和 5)。每个内容分组最多可以有 100 个内容组。内容组的值是由“/”分隔的分层文字。所有头尾端斜杠都将被移除,所有重复的斜杠也都会删减为单个斜杠。例如,“/a//b/”将转换为“a/b”。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
cg<groupIndex> |
text | 无 | 100 字节 | 全部 |
news/sports
用法示例:
cg1=news%2Fsports
链接 ID
选填。
用户所点击的 DOM 元素的 ID,在为媒体资源启用了增强的链接归因的情况下,用于在“网页内分析”报告中区分指向同一个网址的多个链接。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
linkid |
text | 无 | 无 | 全部 |
nav_bar
用法示例:
linkid=nav_bar
应用
应用名称
选填。
指定应用名称。此字段对具有应用相关数据(例如,应用版本、应用 ID 或应用安装程序 ID)的任何匹配而言都是必填项。对发送到网络媒体资源的匹配而言,此字段为选填项。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
an |
text | 无 | 100 字节 | 全部 |
My App
用法示例:
an=My%20App
应用 ID
选填。
应用标识符。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
aid |
text | 无 | 150 字节 | 全部 |
com.company.app
用法示例:
aid=com.company.app
应用版本
选填。
指定应用版本。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
av |
text | 无 | 100 字节 | 全部 |
1.2
用法示例:
av=1.2
应用安装程序 ID
选填。
应用安装程序标识符。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
aiid |
text | 无 | 150 字节 | 全部 |
com.platform.vending
用法示例:
aiid=com.platform.vending
活动
事件类别
对于事件命中类型是必填项。
指定事件类别。值不能为空。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ec |
text | 无 | 150 字节 | event |
Category
用法示例:
ec=Category
事件操作
对于事件命中类型是必填项。
指定事件操作。值不能为空。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ea |
text | 无 | 500 字节 | event |
Action
用法示例:
ea=Action
事件标签
选填。
指定事件标签。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
el |
text | 无 | 500 字节 | event |
Label
用法示例:
el=Label
事件价值
选填。
指定事件价值。值不得为负数。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ev |
integer | 无 | 无 | event |
55
用法示例:
ev=55
电子商务
交易 ID
对于交易命中类型是必填项。
对于商品命中类型是必填项。
交易的唯一标识符。对于与某次交易关联的所有交易匹配和商品匹配,此值应当相同。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ti |
text | 无 | 500 字节 | transaction、item |
OD564
用法示例:
ti=OD564
交易关联商户
选填。
指定关联商户或商店的名称。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ta |
text | 无 | 500 字节 | 交易 |
Member
用法示例:
ta=Member
交易收入
选填。
指定与此交易相关联的总收入。此值应包含所有运费或税费。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
tr |
currency |
0
|
无 | 交易 |
15.47
用法示例:
tr=15.47
交易运费
选填。
指定交易的总运费。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ts |
currency |
0
|
无 | 交易 |
3.50
用法示例:
ts=3.50
交易税
选填。
指定交易的总税费。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
tt |
currency |
0
|
无 | 交易 |
11.20
用法示例:
tt=11.20
商品名称
对于商品命中类型是必填项。
指定商品的名称。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
in |
text | 无 | 500 字节 | 项 |
Shoe
用法示例:
in=Shoe
商品价格
选填。
指定商品的单价。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ip |
currency |
0
|
无 | 项 |
3.50
用法示例:
ip=3.50
商品数量
选填。
指定购买的商品数量。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
iq |
integer |
0
|
无 | 项 |
4
用法示例:
iq=4
商品代码
选填。
指定 SKU 或商品代码。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ic |
text | 无 | 500 字节 | 项 |
SKU47
用法示例:
ic=SKU47
商品类别
选填。
指定商品所属的类别。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
iv |
text | 无 | 500 字节 | 项 |
Blue
用法示例:
iv=Blue
增强型电子商务
产品 SKU
选填。
产品 SKU。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pr<productIndex>id |
text | 无 | 500 字节 | 全部 |
P12345
用法示例:
pr1id=P12345
产品名称
选填。
产品的名称。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pr<productIndex>nm |
text | 无 | 500 字节 | 全部 |
Android T-Shirt
用法示例:
pr1nm=Android%20T-Shirt
产品品牌
选填。
与产品相关联的品牌。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pr<productIndex>br |
text | 无 | 500 字节 | 全部 |
Google
用法示例:
pr1br=Google
产品类别
选填。
产品所属的类别。产品索引必须是 1-200(含 1 和 200)之间的正整数。产品类别参数可以分为多个层级。使用 / 作为分隔符可指定最多 5 个层级。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pr<productIndex>ca |
text | 无 | 500 字节 | 全部 |
Apparel
用法示例:
pr1ca=Apparel
Apparel/Mens/T-Shirts
用法示例:
pr1ca=Apparel%2FMens%2FT-Shirts
产品款式
选填。
产品的款式。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pr<productIndex>va |
text | 无 | 500 字节 | 全部 |
Black
用法示例:
pr1va=Black
产品价格
选填。
产品的单价。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pr<productIndex>pr |
currency | 无 | 无 | 全部 |
29.20
用法示例:
pr1pr=29.20
产品数量
选填。
产品的数量。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pr<productIndex>qt |
integer | 无 | 无 | 全部 |
2
用法示例:
pr1qt=2
产品优惠券代码
选填。
与产品关联的优惠券代码。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pr<productIndex>cc |
text | 无 | 500 字节 | 全部 |
SUMMER_SALE13
用法示例:
pr1cc=SUMMER_SALE13
产品位置
选填。
产品在列表或集合中的位置。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pr<productIndex>ps |
integer | 无 | 无 | 全部 |
2
用法示例:
pr1ps=2
产品自定义维度
选填。
产品级自定义维度,其索引为 1-200(含)之间的正整数。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pr<productIndex>cd<dimensionIndex> |
text | 无 | 150 字节 | 全部 |
Member
用法示例:
pr1cd2=Member
产品自定义指标
选填。
产品级自定义指标,其索引为 1-200(含)之间的正整数。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pr<productIndex>cm<metricIndex> |
integer | 无 | 无 | 全部 |
28
用法示例:
pr1cm2=28
产品操作
选填。
命中中所包含产品的角色。如果未指定产品操作,则命中中包含的所有产品定义都将被忽略。必须为下列某个值:detail、click、add、remove、checkout、checkout_option、purchase、refund。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pa |
text | 无 | 无 | 全部 |
detail
用法示例:
pa=detail
交易 ID
选填。
交易 ID。这是一个可以在“产品操作”设置为“purchase”或“refund”时发送的附加参数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ti |
text | 无 | 无 | 全部 |
T1234
用法示例:
ti=T1234
关联商户
选填。
发生此交易的商店或关联商户。这是一个可以在“产品操作”设置为“purchase”或“refund”时发送的附加参数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ta |
text | 无 | 无 | 全部 |
Google Store
用法示例:
ta=Google%20Store
收入
选填。
交易的总价值,包括税费和运费。如果未发送,此值将根据同一匹配中所有产品的数量和价格字段自动计算得出。这是一个可以在“产品操作”设置为“purchase”或“refund”时发送的附加参数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
tr |
currency | 无 | 无 | 全部 |
123.21
用法示例:
tr=123.21
税费
选填。
交易对应的总税费。这是一个可以在“产品操作”设置为“purchase”或“refund”时发送的附加参数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
tt |
currency | 无 | 无 | 全部 |
10.78
用法示例:
tt=10.78
运费
选填。
交易对应的运费。这是一个可以在“产品操作”设置为“purchase”或“refund”时发送的附加参数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
ts |
currency | 无 | 无 | 全部 |
3.55
用法示例:
ts=3.55
优惠券代码
选填。
在交易中使用的优惠券。这是一个可以在“产品操作”设置为“purchase”或“refund”时发送的附加参数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
tcc |
text | 无 | 无 | 全部 |
SUMMER08
用法示例:
tcc=SUMMER08
产品操作列表
选填。
发生产品操作的列表或集合。这是一个可以在“产品操作”设置为“detail”或“click”时发送的附加参数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pal |
text | 无 | 无 | 全部 |
Search Results
用法示例:
pal=Search%20Results
结账步骤
选填。
结账漏斗中的步骤编号。这是一个可以在“产品操作”设置为“checkout”时发送的附加参数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
cos |
integer | 无 | 无 | 全部 |
2
用法示例:
cos=2
结账步骤选项
选填。
关于结账步骤的额外信息。这是一个可以在“产品操作”设置为“checkout”时发送的附加参数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
col |
text | 无 | 无 | 全部 |
Visa
用法示例:
col=Visa
产品展示列表名称
选填。
产品所在的列表或集合。展示列表索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
il<listIndex>nm |
text | 无 | 无 | 全部 |
Search Results
用法示例:
il1nm=Search%20Results
产品展示 SKU
选填。
产品 ID 或 SKU。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
il<listIndex>pi<productIndex>id |
text | 无 | 无 | 全部 |
P67890
用法示例:
il1pi2id=P67890
产品展示名称
选填。
产品的名称。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
il<listIndex>pi<productIndex>nm |
text | 无 | 无 | 全部 |
Android T-Shirt
用法示例:
il1pi2nm=Android%20T-Shirt
产品展示品牌
选填。
与产品相关联的品牌。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
il<listIndex>pi<productIndex>br |
text | 无 | 无 | 全部 |
Google
用法示例:
il1pi2br=Google
产品展示类别
选填。
产品所属的类别。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
il<listIndex>pi<productIndex>ca |
text | 无 | 无 | 全部 |
Apparel
用法示例:
il1pi2ca=Apparel
产品展示款式
选填。
产品的款式。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
il<listIndex>pi<productIndex>va |
text | 无 | 无 | 全部 |
Black
用法示例:
il1pi2va=Black
产品展示位置
选填。
产品在列表或集合中的位置。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
il<listIndex>pi<productIndex>ps |
integer | 无 | 无 | 全部 |
2
用法示例:
il1pi2ps=2
产品展示价格
选填。
产品的价格。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
il<listIndex>pi<productIndex>pr |
currency | 无 | 无 | 全部 |
29.20
用法示例:
il1pi2pr=29.20
产品展示自定义维度
选填。
产品级自定义维度,其索引为 1-200(含)之间的正整数。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
il<listIndex>pi<productIndex>cd<dimensionIndex> |
text | 无 | 无 | 全部 |
Member
用法示例:
il1pi2cd3=Member
产品展示自定义指标
选填。
产品级自定义指标,其索引为 1-200(含)之间的正整数。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含 1 和 200)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
il<listIndex>pi<productIndex>cm<metricIndex> |
integer | 无 | 无 | 全部 |
28
用法示例:
il1pi2cm3=28
促销 ID
选填。
促销 ID。促销索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
promo<promoIndex>id |
text | 无 | 无 | 全部 |
SHIP
用法示例:
promo1id=SHIP
促销活动名称
选填。
促销活动的名称。促销索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
promo<promoIndex>nm |
text | 无 | 无 | 全部 |
Free Shipping
用法示例:
promo1nm=Free%20Shipping
促销广告素材
选填。
与促销活动关联的广告素材。促销索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
promo<promoIndex>cr |
text | 无 | 无 | 全部 |
Shipping Banner
用法示例:
promo1cr=Shipping%20Banner
促销位置
选填。
广告素材的位置。促销索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
promo<promoIndex>ps |
text | 无 | 无 | 全部 |
banner_slot_1
用法示例:
promo1ps=banner_slot_1
促销操作
选填。
指定命中中所包含促销信息的角色。如果未指定促销操作,则会将其值视为默认促销操作“view”。要衡量用户对促销信息的点击,请将值设为“promo_click”。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
promoa |
text | 无 | 无 | 全部 |
click
用法示例:
promoa=click
货币代码
选填。
若指定此参数,则表示所有交易货币值所采用的本地货币。值应当是有效的 ISO 4217 货币代码。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
cu |
text | 无 | 10 字节 | 全部 |
EUR
用法示例:
cu=EUR
社交互动
社交网络
对于社交命中类型是必填项。
指定社交网络,例如 Facebook 或 Google+。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
sn |
text | 无 | 50 字节 | social |
facebook
用法示例:
sn=facebook
社交操作
对于社交命中类型是必填项。
指定社交互动操作。例如,在 Google+ 上,当用户点击“+1”按钮时,社交操作为“plus”。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
sa |
text | 无 | 50 字节 | social |
like
用法示例:
sa=like
社交操作目标
对于社交命中类型是必填项。
指定社交互动的目标。此值通常是网址,但也可以是任意文字。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
st |
text | 无 | 2048 字节 | social |
http://foo.com
用法示例:
st=http%3A%2F%2Ffoo.com
计时
用户计时类别
对于计时命中类型是必填项。
指定用户计时类别。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
utc |
text | 无 | 150 字节 | 时间 : 显示时间 |
category
用法示例:
utc=category
用户计时变量名称
对于计时命中类型是必填项。
指定用户计时变量。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
utv |
text | 无 | 500 字节 | 时间 : 显示时间 |
lookup
用法示例:
utv=lookup
用户计时时间
对于计时命中类型是必填项。
指定用户计时值。值以毫秒为单位。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
utt |
integer | 无 | 无 | 时间 : 显示时间 |
123
用法示例:
utt=123
用户计时标签
选填。
指定用户计时标签。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
utl |
text | 无 | 500 字节 | 时间 : 显示时间 |
label
用法示例:
utl=label
网页加载时间
选填。
指定网页加载所耗时间。值以毫秒为单位。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
plt |
integer | 无 | 无 | 时间 : 显示时间 |
3554
用法示例:
plt=3554
DNS 时间
选填。
指定 DNS 查找所用的时间。该值以毫秒为单位。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
dns |
integer | 无 | 无 | 时间 : 显示时间 |
43
用法示例:
dns=43
网页下载时间
选填。
指定网页下载所耗时间。值以毫秒为单位。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
pdt |
integer | 无 | 无 | 时间 : 显示时间 |
500
用法示例:
pdt=500
重定向响应时间
选填。
指定重定向所耗时间。值以毫秒为单位。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
rrt |
integer | 无 | 无 | 时间 : 显示时间 |
500
用法示例:
rrt=500
TCP 连接时间
选填。
指定 TCP 连接所耗时间。值以毫秒为单位。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
tcp |
integer | 无 | 无 | 时间 : 显示时间 |
500
用法示例:
tcp=500
服务器响应时间
选填。
指定在建立连接后服务器响应所耗的时间。值以毫秒为单位。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
srt |
integer | 无 | 无 | 时间 : 显示时间 |
500
用法示例:
srt=500
DOM 互动时间
选填。
指定 Document.readyState 转为“interactive”所花费的时间。值以毫秒为单位。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
dit |
integer | 无 | 无 | 时间 : 显示时间 |
500
用法示例:
dit=500
内容加载时间
选填。
指定 DOMContentLoaded 事件触发所花费的时间。值以毫秒为单位。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
clt |
integer | 无 | 无 | 时间 : 显示时间 |
500
用法示例:
clt=500
异常
异常说明
选填。
提供对异常情况的说明。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
exd |
text | 无 | 150 字节 | exception |
DatabaseError
用法示例:
exd=DatabaseError
异常是否严重?
选填。
指定异常是否严重。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
exf |
boolean |
1
|
无 | exception |
0
用法示例:
exf=0
自定义维度/指标
自定义维度
选填。
每个自定义维度都有关联的索引。自定义维度最多可以有 20 个(Analytics 360 账号为 200 个)。维度索引必须是 1-200(含)之间的正整数。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
cd<dimensionIndex> |
text | 无 | 150 字节 | 全部 |
Sports
用法示例:
cd1=Sports
自定义指标
选填。
每个自定义指标都有一个关联的索引。最多可以有 20 个自定义指标(对于 Analytics 360 账号,最多可有 200 个)。指标索引必须是 1-200(含)之间的正整数。
参数 | 值类型 | 默认值 | 长度上限 | 支持的命中类型 |
---|---|---|---|---|
cm<metricIndex> |
number | 无 | 无 | 全部 |
47
用法示例:
cm1=47