

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Web Analytics 物件的物件類型映射
<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>String</td><td>Web 分析事件的唯一識別符。</td></tr>
  <tr><td>EventType</td><td>String</td><td>Web 分析事件的類型，例如 - 頁面檢視、表單提交、按鈕選擇、提取主線<br />\\u0000<br />搜尋列互動、應用程式錯誤提示、購物車互動、購買、捲動等。</td></tr>
  <tr><td>EventTimestamp</td><td>Number</td><td>事件的 Epoch 毫秒時間戳記。</td></tr>
  <tr><td>EventDuration</td><td>Number</td><td>EventDuration 代表使用者在特定互動期間花費的時間量，以秒為單位。常見的使用案例包括：檢視產品所花費的時間、特定頁面上的瀏覽工作階段長度、功能所花費的時間等。</td></tr>
  <tr><td>EventValue</td><td>Number</td><td>EventValue 是數值屬性，代表互動事件的值或重要性。常見使用案例包括：交易事件的購買金額、產品評分的評分值、影片檢視的完成百分比等。</td></tr>
  <tr><td colspan="3">工作階段屬性</td></tr>
  <tr><td>Session.Id</td><td>String</td><td>工作階段的唯一識別符。</td></tr>
  <tr><td>Session.StartTimestamp</td><td>Number</td><td>Epoch 毫秒表示工作階段的開始時間戳記。</td></tr>
  <tr><td colspan="3">頁面/畫面屬性</td></tr>
  <tr><td>Page.Title</td><td>String</td><td>行動應用程式的 Web 應用程式/螢幕名稱標題。</td></tr>
  <tr><td>Page.Location</td><td>String</td><td>網頁的 URL。對於行動裝置，可能是螢幕的深層連結或路由。</td></tr>
  <tr><td>Page.Referrer</td><td>String</td><td>上一個畫面/頁面。</td></tr>
  <tr><td>Page.Category</td><td>String</td><td>畫面/頁面的邏輯分組。可能有助於將巢狀 URLs/應用程式位置分組。</td></tr>
  <tr><td colspan="3">HTML/DOM 元素</td></tr>
  <tr><td>Element.Id</td><td>String</td><td>HTML 元素 ID</td></tr>
  <tr><td>Element.Type</td><td>String</td><td>元素類型 - 按鈕、錨點連結、等</td></tr>
  <tr><td>Element.Classes</td><td>String</td><td>元素的 CSS 樣式類別</td></tr>
  <tr><td>Element.Text</td><td>String</td><td>元素文字 （適用於按鈕、輸入欄位預留位置等）。</td></tr>
  <tr><td>Element.AltText</td><td>String</td><td>HTML 元素的 AltText （通常用於影像）。</td></tr>
  <tr><td>Element.Source</td><td>String</td><td>影片、影像等的來源</td></tr>
  <tr><td colspan="3">表格</td></tr>
  <tr><td>Form.Id</td><td>String</td><td>輸入表單的唯一識別符</td></tr>
  <tr><td>Form.Name</td><td>String</td><td>表單的名稱</td></tr>
  <tr><td>Form.Length</td><td>String</td><td>表單中的輸入欄位數目。</td></tr>
  <tr><td>Form.ValidationErrors</td><td>Number</td><td>表單中的驗證錯誤數目。</td></tr>
  <tr><td>Form.FieldsCompleted</td><td>Number</td><td>完成的欄位數量。</td></tr>
  <tr><td>Form.FieldsRequired</td><td>Number</td><td>必要欄位的數量。</td></tr>
  <tr><td colspan="3">搜尋</td></tr>
  <tr><td>Search.Query</td><td>String</td><td>輸入中使用的查詢字串</td></tr>
  <tr><td>Search.TotalMatchingResults</td><td>Number</td><td>搜尋結果的總數。</td></tr>
  <tr><td>Search.ResultsPerPage</td><td>Number</td><td>每頁顯示的結果數量。</td></tr>
  <tr><td>Search.CurrentResultsPage</td><td>Number</td><td>使用者正在檢視的目前結果頁面。</td></tr>
  <tr><td>Search.FilterExpression</td><td>String</td><td>使用的任何其他篩選條件表達式。</td></tr>
  <tr><td>Search.SortCriteria</td><td>String</td><td>排序搜尋結果的條件。例如 - 相關性、價格等。</td></tr>
  <tr><td>Search.SortOrder</td><td>String</td><td>搜尋結果的排序順序 - 遞增/遞減。</td></tr>
  <tr><td colspan="3">項目/項目清單</td></tr>
  <tr><td>項目</td><td>項目</td><td>事件中的聚焦項目，指出新增至購物車的項目、檢視的項目等。</td></tr>
  <tr><td>ItemsList</td><td>List<Item></td><td>事件中的項目聚焦清單，指出購買的項目、購物車中的項目、項目搜尋結果等。</td></tr>
  <tr><td colspan="3">項目印象</td></tr>
  <tr><td>AdditionalItemImpressions</td><td>List<Item></td><td>其他項目印模清單</td></tr>
  <tr><td colspan="3">購物車</td></tr>
  <tr><td>Cart.Id</td><td>String</td><td>購物車的唯一識別符。</td></tr>
  <tr><td>Cart.ItemsCount</td><td>Number</td><td>購物車中的項目數量。</td></tr>
  <tr><td>Cart.Currency</td><td>String</td><td>購物車值的貨幣。</td></tr>
  <tr><td>Cart.Value</td><td>Number</td><td>購物車中項目的貨幣值。</td></tr>
  <tr><td colspan="3">訂單資訊</td></tr>
  <tr><td>OrderId</td><td>String</td><td>訂單的唯一識別符。我們只會將訂單識別符存放在此處，與訂單相關的其他資訊會存放在標準訂單物件中。</td></tr>
  <tr><td colspan="3">裝置</td></tr>
  <tr><td>DeviceId</td><td>String</td><td>使用者裝置的唯一識別符。</td></tr>
  <tr><td colspan="3">捲動屬性</td></tr>
  <tr><td>Scroll.DepthPercentage</td><td>String</td><td>垂直捲動深度百分比。這有助於了解使用者捲動網頁的程度。</td></tr>
  <tr><td>Scroll.PositionX</td><td>Number</td><td>從左側以像素為單位的水平捲動位置。</td></tr>
  <tr><td>Scroll.PositionY</td><td>Number</td><td>從頂端以像素為單位的垂直捲動位置。</td></tr>
  <tr><td colspan="3">錯誤</td></tr>
  <tr><td>Error.Description</td><td>String</td><td>錯誤的簡短描述。</td></tr>
  <tr><td>Error.Type</td><td>String</td><td>使用者輸入錯誤/伺服器錯誤。</td></tr>
  <tr><td colspan="3">使用者</td></tr>
  <tr><td>User.Id</td><td>String</td><td>使用者的唯一識別符</td></tr>
  <tr><td>User.AnonymousId</td><td>String</td><td>匿名 UserId。當使用者未登入時，這會是指派給使用者的 uniqueId。</td></tr>
  <tr><td>User.IsReturning</td><td>String</td><td>布林值，指出使用者是否正在重新檢視。</td></tr>
  <tr><td>User.IsLoggedIn</td><td>String</td><td>指出使用者是否登入的布林值。</td></tr>
  <tr><td colspan="3">活動位置</td></tr>
  <tr><td>Location.Country</td><td>String</td><td>使用者活動國家/地區。</td></tr>
  <tr><td>Location.State</td><td>String</td><td>使用者活動狀態。</td></tr>
  <tr><td>位置.省</td><td>String</td><td>使用者活動省份。</td></tr>
  <tr><td>Location.County</td><td>String</td><td>使用者活動郡。</td></tr>
  <tr><td>Location.City</td><td>String</td><td>使用者活動城市。</td></tr>
  <tr><td>Location.Latitude</td><td>String</td><td>使用者活動位置座標</td></tr>
  <tr><td>Location.Longitude</td><td>String</td><td>使用者活動位置座標</td></tr>
  <tr><td colspan="3">應用程式屬性</td></tr>
  <tr><td>Application.Name</td><td>String</td><td>應用程式名稱。</td></tr>
  <tr><td>Application.Version</td><td>String</td><td>如果裝置是 Mobile，我們可以在此處擷取應用程式版本。使用者也可以考慮將此用於人口 A/B 測試或實驗屬性。</td></tr>
  <tr><td>Application.Environment</td><td>String</td><td>應用程式環境，例如 - Beta、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 | String | 項目的唯一識別符。 | 
| Title | String | 項目的標題。 | 
| Category | String | 項目的類別。 | 
| Value | String | 項目的貨幣值。 | 
| Currency | String | 項目的貨幣。 | 
| 數量 | Number | 項目的數量。 | 
| ImpressionType | String | 識別事件印模類型的字串。例如 - 精選、贊助、最佳挑選等。 | 
| ImpressionId | String | 用於唯一識別印模的字串識別符。 | 


**裝置標準物件結構描述**  

| 欄位 | Type | 說明 | 
| --- | --- | --- | 
| DeviceId | String | 裝置的唯一識別符。 | 
| Type | String | 裝置類型 （例如桌上型電腦、行動裝置） | 
| 模型 | String | 裝置模型，例如 - Macbook Pro/Air、IPhone 16 等。 | 
| 製造商 | String | 裝置製造商。 | 
| OperatingSystem | String | 指出 Windows、MacOs、IOS、Android。 | 
| OperatingSystemVersion | String | 作業系統版本 | 
| ScreenWidth | Number | Screen ViewPort 的寬度 | 
| ScreenHeight | Number | Screen ViewPort 的高度 | 
| 瀏覽器 | String | 使用者與之互動的瀏覽器名稱。 | 
| BrowserVersion | String | 瀏覽器版本 | 
| Locale | String | 裝置或應用程式地區設定。 | 
| 屬性 | Map<String, String> | 裝置的任何自訂屬性。 | 