Measurement Protocol 参数参考

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

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

常规

协议版本

对所有命中类型而言都是必填项。

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