

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

# 网络分析对象的对象类型映射
<a name="standard-loyalty-promotion-object-mapping-web-analytics"></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>网络分析事件的类型，例如-页面查看、表单提交、按钮选择、s向上拉主线<br />\\u0000<br />搜索栏互动、应用程序错误提示、购物车互动、购买、滚动等</td></tr>
  <tr><td>EventTimestamp</td><td>数字</td><td>事件的纪元毫秒时间戳。</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>移动应用程序的网 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 元素标识</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>名单 <Item></td><td>活动中商品的重点列表，表示已购买的商品、购物车中的商品、商品搜索结果等。</td></tr>
  <tr><td colspan="3">商品印象</td></tr>
  <tr><td>AdditionalItemImpressions</td><td>名单 <Item></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>应用程序环境，比如-测试版、Gamma、Prod。</td></tr>
  <tr><td colspan="3">自定义属性</td></tr>
  <tr><td>属性</td><td>Map<String, String></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> | 设备的任何自定义属性。 | 