

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 客户档案标准 Web 分析对象字段
<a name="standard-web-analytics-object-fields"></a>


**WebAnalytics 标准对象架构**  

<table>
<thead>
  <tr><th>字段</th><th>Type</th><th>说明</th></tr>
</thead>
<tbody>
  <tr><td colspan="3">事件属性</td></tr>
  <tr><td>EventId</td><td>字符串</td><td>网络分析事件的唯一标识符。</td></tr>
  <tr><td>EventType</td><td>字符串</td><td>网络分析事件的类型，例如-页面浏览量、表单提交、按钮选择调出主线<br />\u0000<br />搜索栏互动、应用程序错误提示、购物车互动、购买、滚动。</td></tr>
  <tr><td>EventTimestamp</td><td>数字</td><td>事件的 Epoch 毫秒时间戳。</td></tr>
  <tr><td>EventDuration</td><td>数字</td><td>EventDuration 表示用户在特定交互期间花费的时间，以秒为单位。常见用例包括：查看产品所花费的时间、在特定页面上浏览会话的时长、在某项功能上花费的时间。</td></tr>
  <tr><td>EventValue</td><td>数字</td><td>EventValue 是一种数字属性，表示交互事件的价值或重要性。常见用例包括：交易事件的购买金额、产品评级的评级值、视频观看量的完成百分比。</td></tr>
  <tr><td colspan="3">会话属性</td></tr>
  <tr><td>Session.Id</td><td>字符串</td><td>会话的唯一标识符。</td></tr>
  <tr><td>Session.StartTimestamp</td><td>数字</td><td>Epoch 毫秒，表示会话的开始时间戳。</td></tr>
  <tr><td colspan="3">Page/Screen 属性</td></tr>
  <tr><td>Page.Title</td><td>字符串</td><td>移动应用程序的 Web App/Screen 名称的标题。</td></tr>
  <tr><td>Page.Location</td><td>字符串</td><td>网页的网址。对于移动设备，它可能是深度链接或路由到屏幕。</td></tr>
  <tr><td>Page.Referrer</td><td>字符串</td><td>以前 screen/page。</td></tr>
  <tr><td>Page.Category</td><td>字符串</td><td>a 的逻辑分组 screen/page。可能对嵌套 URLs/app 位置进行分组很有用。</td></tr>
  <tr><td colspan="3">HTML/DOM 元素</td></tr>
  <tr><td>Element.Id</td><td>字符串</td><td>HTML 元素 ID</td></tr>
  <tr><td>Element.Type</td><td>字符串</td><td>元素类型-按钮、锚链接等</td></tr>
  <tr><td>Element.Classes</td><td>字符串</td><td>元素的 CSS 样式类</td></tr>
  <tr><td>Element.Text</td><td>字符串</td><td>元素文本（适用于按钮、输入字段占位符等）。</td></tr>
  <tr><td>Element.AltText</td><td>字符串</td><td>AltText 一个 HTML 元素（通常用于图像）。</td></tr>
  <tr><td>Element.Source</td><td>字符串</td><td>视频的来源，图片。</td></tr>
  <tr><td colspan="3">表单</td></tr>
  <tr><td>Form.Id</td><td>字符串</td><td>输入表单的唯一标识符</td></tr>
  <tr><td>Form.Name</td><td>字符串</td><td>表格的名称</td></tr>
  <tr><td>Form.Length</td><td>字符串</td><td>表单中输入字段的数量。</td></tr>
  <tr><td>Form.ValidationErrors</td><td>数字</td><td>表单中的验证错误数量。</td></tr>
  <tr><td>Form.FieldsCompleted</td><td>数字</td><td>已完成的字段数。</td></tr>
  <tr><td>Form.FieldsRequired</td><td>数字</td><td>必填字段的数量。</td></tr>
  <tr><td colspan="3">Search</td></tr>
  <tr><td>Search.Query</td><td>字符串</td><td>输入中使用的查询字符串</td></tr>
  <tr><td>Search.TotalMatchingResults</td><td>数字</td><td>搜索结果总数。</td></tr>
  <tr><td>Search.ResultsPerPage</td><td>数字</td><td>每页显示的结果数。</td></tr>
  <tr><td>Search.CurrentResultsPage</td><td>数字</td><td>用户正在查看的当前结果页面。</td></tr>
  <tr><td>Search.FilterExpression</td><td>字符串</td><td>使用的任何其他过滤器表达式。</td></tr>
  <tr><td>Search.SortCriteria</td><td>字符串</td><td>对搜索结果进行排序的标准。例如-相关性、价格。</td></tr>
  <tr><td>Search.SortOrder</td><td>字符串</td><td>搜索结果的排序顺序- Ascending/Descending.</td></tr>
  <tr><td colspan="3">Item/Item 清单</td></tr>
  <tr><td>Item</td><td>Item</td><td>事件中的重点项目，表示，该项目已添加到购物车，项目已查看。</td></tr>
  <tr><td>ItemsList</td><td>清单 &lt;Item&gt;</td><td>活动中物品的重点列表，指明购买的物品、购物车中的物品、物品搜索结果。</td></tr>
  <tr><td colspan="3">商品曝光量</td></tr>
  <tr><td>AdditionalItemImpressions</td><td>清单 &lt;Item&gt;</td><td>其他物品曝光量列表</td></tr>
  <tr><td colspan="3">购物车</td></tr>
  <tr><td>Cart.Id</td><td>字符串</td><td>购物车的唯一标识符。</td></tr>
  <tr><td>Cart.ItemsCount</td><td>数字</td><td>购物车中的商品数量。</td></tr>
  <tr><td>Cart.Currency</td><td>字符串</td><td>购物车价值的货币。</td></tr>
  <tr><td>Cart.Value</td><td>数字</td><td>购物车中物品的货币价值。</td></tr>
  <tr><td colspan="3">订单信息</td></tr>
  <tr><td>OrderId</td><td>字符串</td><td>订单的唯一标识符。我们只会将订单标识符存储在这里，与订单相关的其他信息将存储在标准订单对象中。</td></tr>
  <tr><td colspan="3">设备</td></tr>
  <tr><td>DeviceId</td><td>字符串</td><td>用户设备的唯一标识符。</td></tr>
  <tr><td colspan="3">滚动属性</td></tr>
  <tr><td>Scroll.DepthPercentage</td><td>字符串</td><td>垂直滚动深度百分比。这有助于了解用户在网页中滚动的程度。</td></tr>
  <tr><td>Scroll.PositionX</td><td>数字</td><td>水平向左滚动位置（以像素为单位）。</td></tr>
  <tr><td>Scroll.PositionY</td><td>数字</td><td>从顶部开始垂直滚动位置（以像素为单位）。</td></tr>
  <tr><td colspan="3">错误</td></tr>
  <tr><td>Error.Description</td><td>字符串</td><td>错误的简短描述。</td></tr>
  <tr><td>Error.Type</td><td>字符串</td><td>用户输入 Error/Server 错误。</td></tr>
  <tr><td colspan="3">用户</td></tr>
  <tr><td>User.Id</td><td>字符串</td><td>用户的唯一标识符</td></tr>
  <tr><td>User.AnonymousId</td><td>字符串</td><td>匿名 UserId。这将是用户未登录时分配给用户的 UniqueID。</td></tr>
  <tr><td>User.IsReturning</td><td>字符串</td><td>一个布尔值，表示用户是否正在重新访问。</td></tr>
  <tr><td>User.IsLoggedIn</td><td>字符串</td><td>一个布尔值，表示用户是否已登录。</td></tr>
  <tr><td colspan="3">活动位置</td></tr>
  <tr><td>Location.Country</td><td>字符串</td><td>用户活动国家。</td></tr>
  <tr><td>Location.State</td><td>字符串</td><td>用户活动状态。</td></tr>
  <tr><td>Location.Province</td><td>字符串</td><td>用户活动省份。</td></tr>
  <tr><td>Location.County</td><td>字符串</td><td>用户活动县。</td></tr>
  <tr><td>Location.City</td><td>字符串</td><td>用户活动城市。</td></tr>
  <tr><td>Location.Latitude</td><td>字符串</td><td>用户活动位置坐标</td></tr>
  <tr><td>Location.Longitude</td><td>字符串</td><td>用户活动位置坐标</td></tr>
  <tr><td colspan="3">应用程序属性</td></tr>
  <tr><td>Application.Name</td><td>字符串</td><td> 应用程序的名称。</td></tr>
  <tr><td>Application.Version</td><td>字符串</td><td>如果设备是移动设备，我们可以在此处捕获应用程序版本。用户也可以考虑将其用于人口 A/B 测试或实验属性。</td></tr>
  <tr><td>Application.Environment</td><td>字符串</td><td>应用程序环境，例如-Beta、Gamma、Prod。</td></tr>
  <tr><td colspan="3">自定义属性</td></tr>
  <tr><td>属性</td><td>Map&lt;String, String&gt;</td><td>要添加到事件的任何自定义属性或元数据。</td></tr>
</tbody>
</table>



**WebAnalytics 物品对象架构**  

| 字段 | Type | 说明 | 
| --- | --- | --- | 
| Id | 字符串 | 商品的唯一标识符。 | 
| 标题 | 字符串 | 商品的标题。 | 
| 类别 | 字符串 | 物品的类别。 | 
| 值 | 字符串 | 物品的货币价值。 | 
| 货币 | 字符串 | 物品的货币。 | 
| Quantity | 数字 | 物品的数量。 | 
| ImpressionType | 字符串 | 标识活动曝光类型的字符串。例如-精选、赞助、热门精选。 | 
| ImpressionId | 字符串 | 用于唯一识别印象的字符串标识符。 | 


**设备标准对象架构**  

| 字段 | Type | 说明 | 
| --- | --- | --- | 
| DeviceId | 字符串 | 设备的唯一标识符。 | 
| Type | 字符串 | 设备类型（例如，台式机、移动设备） | 
| 模型 | 字符串 | 设备型号，例如-Macbook Pro/Air、iPhone 16。 | 
| Manufacturer | 字符串 | 设备的制造商。 | 
| OperatingSystem | 字符串 | 表示Windows、 MacOs、IOS、安卓。 | 
| OperatingSystemVersion | 字符串 | 操作系统版本 | 
| ScreenWidth | 数字 | 屏幕的宽度 ViewPort | 
| ScreenHeight | 数字 | 屏幕的高度 ViewPort | 
| 浏览器 | 字符串 | 用户正在与之交互的浏览器的名称。 | 
| BrowserVersion | 字符串 | 浏览器的版本 | 
| Locale | 字符串 | 设备或应用程序区域。 | 
| 属性 | Map<String, String> | 设备的任何自定义属性。 | 