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

# Web Analytics 物件的物件類型映射
<a name="standard-loyalty-promotion-object-mapping-web-analytics"></a>


**WebAnalytics 標準物件結構描述**  

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


**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>  |  裝置的任何自訂屬性。  |