Measurement Protocol 参数参考

本文档列出了 Measurement Protocol 的所有参数。

  1. 常规
  2. 用户
  3. 会话
  4. 流量来源
  5. 系统信息
  6. 匹配
  7. 内容信息
  8. 应用跟踪
  9. 事件跟踪
  10. 电子商务
  11. 增强型电子商务
  12. 社交互动
  13. 计时
  14. 异常
  15. 自定义维度/指标
  16. 内容实验

常规

协议版本

对于所有匹配类型都是必填项。

协议的版本。当前值为“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

数据来源

选填。

表示匹配的数据来源。从 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

用户

客户 ID

对于所有匹配类型都是必填项。

此值用于以匿名方式标识某个用户、设备或浏览器。对于网页而言,此值一般以第一方 Cookie 的形式存储在本地,有效期为两年。对于移动应用而言,此值会针对每个应用安装实例随机生成。此字段的值应为一个随机 UUID(版本 4),如 http://www.ietf.org/rfc/rfc4122.txt 所述。

参数 值类型 默认值 长度上限 支持的匹配类型
cid text 全部
值示例:35009a79-1a05-49d7-b876-2b884d0f825b
用法示例:cid=35009a79-1a05-49d7-b876-2b884d0f825b

用户 ID

选填。

此值应该是由网站所有者/跟踪库用户提供的已知用户标识符。此值本身不得为个人身份信息,不能长久储存在 GA 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 替换参数)的任何地理位置。无效的代码将导致地理位置维度被设置为“(not set)”。

参数 值类型 默认值 长度上限 支持的匹配类型
geoid text 全部
值示例:US
用法示例:geoid=US

Example value: 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 AdWords ID

可选。

指定 Google AdWords 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

屏幕名称

对于屏幕浏览匹配类型来说是必填项。

在网络媒体资源上,此参数是选填项,而对移动媒体资源上的屏幕浏览匹配而言,此参数是必填项,因为在移动媒体资源上,此参数会被用做屏幕浏览匹配的“屏幕名称”。在网络媒体资源上,此字段将默认设为网页的专属网址,原样使用 &dl 参数或组合使用 &dh 和 &dp。

参数 值类型 默认值 长度上限 支持的匹配类型
cd text 2048 字节 screenview
值示例:High Scores
用法示例:cd=High%20Scores

内容组

选填。

每个内容组都有关联的索引。最多有 10 个内容组。组索引必须是 1-10(含)之间的正整数。内容组的值是由“/”分隔的分层文字,而且所有头尾端斜杠都将被移除,所有重复的斜杠也都会删减为单个斜杠。例如,“/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 字节 transaction
值示例:Member
用法示例:ta=Member

交易收入

可选。

指定与此交易相关联的总收入。此值应包含所有运费或税费。

参数 值类型 默认值 长度上限 支持的匹配类型
tr currency 0 transaction
值示例:15.47
用法示例:tr=15.47

交易运费

可选。

指定交易的总运费。

参数 值类型 默认值 长度上限 支持的匹配类型
ts currency 0 transaction
值示例:3.50
用法示例:ts=3.50

交易税费

可选。

指定交易的总税费。

参数 值类型 默认值 长度上限 支持的匹配类型
tt currency 0 transaction
值示例:11.20
用法示例:tt=11.20

商品名称

对于商品匹配类型是必填项。

指定商品的名称。

参数 值类型 默认值 长度上限 支持的匹配类型
in text 500 字节 item
值示例:Shoe
用法示例:in=Shoe

商品价格

可选。

指定商品的单价。

参数 值类型 默认值 长度上限 支持的匹配类型
ip currency 0 item
值示例:3.50
用法示例:ip=3.50

商品数量

可选。

指定购买的商品数量。

参数 值类型 默认值 长度上限 支持的匹配类型
iq integer 0 item
值示例:4
用法示例:iq=4

商品代码

可选。

指定 SKU 或商品代码。

参数 值类型 默认值 长度上限 支持的匹配类型
ic text 500 字节 item
值示例:SKU47
用法示例:ic=SKU47

商品类别

可选。

指定商品所属的类别。

参数 值类型 默认值 长度上限 支持的匹配类型
iv text 500 字节 item
值示例:Blue
用法示例:iv=Blue

增强型电子商务

产品 SKU

选填。

产品 SKU。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
pr<productIndex>id text 500 字节 全部
值示例:P12345
用法示例:pr1id=P12345

产品名称

选填。

产品名称。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
pr<productIndex>nm text 500 字节 全部
值示例:Android T-Shirt
用法示例:pr1nm=Android%20T-Shirt

产品品牌

选填。

与产品相关联的品牌。产品索引必须是 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(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
pr<productIndex>va text 500 字节 全部
值示例:Black
用法示例:pr1va=Black

产品价格

选填。

产品的单价。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
pr<productIndex>pr currency 全部
值示例:29.20
用法示例:pr1pr=29.20

产品数量

选填。

产品的数量。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
pr<productIndex>qt integer 全部
值示例:2
用法示例:pr1qt=2

产品优惠券代码

选填。

与产品关联的优惠券代码。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
pr<productIndex>cc text 500 字节 全部
值示例:SUMMER_SALE13
用法示例:pr1cc=SUMMER_SALE13

产品位置

选填。

产品在列表或集合中的位置。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
pr<productIndex>ps integer 全部
值示例:2
用法示例:pr1ps=2

产品自定义维度

选填。

产品级自定义维度,其索引为 1-200(含)之间的正整数。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
pr<productIndex>cd<dimensionIndex> text 全部
值示例:Member
用法示例:pr1cd2=Member

产品自定义指标

选填。

产品级自定义指标,其索引为 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(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
il<listIndex>pi<productIndex>id text 全部
值示例:P67890
用法示例:il1pi2id=P67890

产品展示名称

选填。

产品名称。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
il<listIndex>pi<productIndex>nm text 全部
值示例:Android T-Shirt
用法示例:il1pi2nm=Android%20T-Shirt

产品展示品牌

选填。

与产品相关联的品牌。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
il<listIndex>pi<productIndex>br text 全部
值示例:Google
用法示例:il1pi2br=Google

产品展示类别

选填。

产品所属的类别。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
il<listIndex>pi<productIndex>ca text 全部
值示例:Apparel
用法示例:il1pi2ca=Apparel

产品展示款式

选填。

产品的款式。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
il<listIndex>pi<productIndex>va text 全部
值示例:Black
用法示例:il1pi2va=Black

产品展示位置

选填。

产品在列表或集合中的位置。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
il<listIndex>pi<productIndex>ps integer 全部
值示例:2
用法示例:il1pi2ps=2

产品展示价格

选填。

产品的价格。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
il<listIndex>pi<productIndex>pr currency 全部
值示例:29.20
用法示例:il1pi2pr=29.20

产品展示自定义维度

选填。

产品级自定义维度,其索引为 1-200(含)之间的正整数。展示列表索引必须是 1-200(含)之间的正整数。产品索引必须是 1-200(含)之间的正整数。对于 analytics.js,在使用此字段之前必须先安装增强型电子商务插件。

参数 值类型 默认值 长度上限 支持的匹配类型
il<listIndex>pi<productIndex>cd<dimensionIndex> text 全部
值示例:Member
用法示例:il1pi2cd3=Member

产品展示自定义指标

选填。

产品级自定义指标,其索引为 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 字节 timing
值示例:category
用法示例:utc=category

用户计时变量名称

对计时匹配类型而言是必填项。

指定用户计时变量。

参数 值类型 默认值 长度上限 支持的匹配类型
utv text 500 字节 timing
值示例:lookup
用法示例:utv=lookup

用户计时时间

对计时匹配类型而言是必填项。

指定用户计时值。值以毫秒为单位。

参数 值类型 默认值 长度上限 支持的匹配类型
utt integer timing
值示例:123
用法示例:utt=123

用户计时标签

选填。

指定用户计时标签。

参数 值类型 默认值 长度上限 支持的匹配类型
utl text 500 字节 timing
值示例:label
用法示例:utl=label

网页加载时间

可选。

指定网页加载所耗时间。值以毫秒为单位。

参数 值类型 默认值 长度上限 支持的匹配类型
plt integer timing
值示例:3554
用法示例:plt=3554

DNS 时间

可选。

指定 DNS 查询所耗时间。值以毫秒为单位。

参数 值类型 默认值 长度上限 支持的匹配类型
dns integer timing
值示例:43
用法示例:dns=43

网页下载时间

可选。

指定网页下载所耗时间。值以毫秒为单位。

参数 值类型 默认值 长度上限 支持的匹配类型
pdt integer timing
值示例:500
用法示例:pdt=500

重定向响应时间

可选。

指定重定向所耗时间。值以毫秒为单位。

参数 值类型 默认值 长度上限 支持的匹配类型
rrt integer timing
值示例:500
用法示例:rrt=500

TCP 连接时间

可选。

指定 TCP 连接所耗时间。值以毫秒为单位。

参数 值类型 默认值 长度上限 支持的匹配类型
tcp integer timing
值示例:500
用法示例:tcp=500

服务器响应时间

可选。

指定在建立连接后服务器响应所耗的时间。值以毫秒为单位。

参数 值类型 默认值 长度上限 支持的匹配类型
srt integer timing
值示例:500
用法示例:srt=500

DOM 互动时间

可选。

指定 Document.readyState 转为“interactive”所花费的时间。值以毫秒为单位。

参数 值类型 默认值 长度上限 支持的匹配类型
dit integer timing
值示例:500
用法示例:dit=500

内容加载时间

可选。

指定 DOMContentLoaded 事件触发所花费的时间。值以毫秒为单位。

参数 值类型 默认值 长度上限 支持的匹配类型
clt integer timing
值示例: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

内容实验

实验 ID

选填。

此参数指明此用户参与了采用指定 ID 的实验。此参数应与实验变体参数一起发送。

参数 值类型 默认值 长度上限 支持的匹配类型
xid text 40 字节 全部
值示例:Qp0gahJ3RAO3DJ18b0XoUQ
用法示例:xid=Qp0gahJ3RAO3DJ18b0XoUQ

实验变体

选填。

此参数指明此用户参与了特定的实验变体。此参数应与实验 ID 参数一起发送。

参数 值类型 默认值 长度上限 支持的匹配类型
xvar text 全部
值示例:1
用法示例:xvar=1