文件Analytics實作指南

XDM物件變數對應至Adobe Analytics

Last update: Fri Oct 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 管理員
  • 開發人員

下表顯示Adobe Experience Platform Edge Network自動對應至Adobe Analytics的XDM變數。 如果您使用這些XDM欄位路徑，則傳送資料給Adobe Analytics不需要額外的設定。 這些欄位包含在​ Adobe Analytics ExperienceEvent範本 ​欄位群組中。 如果您想要將資料傳送至Adobe Analytics和Adobe Experience Platform，建議您使用這些欄位。

如果您的組織計畫移至Customer Journey Analytics，Adobe建議改用data物件，在不符合結構描述的情況下，直接將資料傳送至Adobe Analytics。 此策略可讓您的組織使用自己的結構描述，而不使用Adobe Analytics ExperienceEvent範本 (不太適用於Customer Journey Analytics)。 如需類似的對應表格，請參閱對應至Adobe Analytics的資料物件變數。

值優先順序

此資料表中的大部分XDM物件欄位都與資料物件欄位一致。 如果您同時設定指定的XDM物件欄位及其各自的資料物件欄位，資料物件欄位將會優先。 如果您同時使用XDM物件欄位和資料物件欄位，Adobe建議使用資料物件欄位設定自訂事件。 如果欄位data.__adobe.analytics.events存在，則會覆寫所有與商務和自訂事件相關的XDM物件欄位。

xdm物件欄位對應

您可在本頁之 GitHub 上的認可歷史記錄上找到之前對此表格的更新。

XDM 欄位路徑
Analytics變數和說明
xdm.application.isClose
協助定義行動生命週期量度損毀。
xdm.application.isInstall
協助判斷何時增加行動生命週期量度首次啟動。
xdm.application.closeType
判斷某個關閉事件是否損毀。有效值包括 close (生命週期工作階段結束，並收到上一個工作階段的暫停事件) 和 unknown (生命週期工作階段結束且沒有暫停事件)。幫助設定行動生命週期量度損毀 指標。
xdm.application.isInstall
行動生命週期量度安裝。
xdm.application.isLaunch
行動生命週期量度啟動。
xdm.application.name
協助設定行動生命週期維度應用程式 ID。
xdm.application.isUpgrade
行動生命週期量度升級。
xdm.application.version
協助設定行動生命週期維度應用程式 ID。
xdm.application.sessionLength
行動生命週期量度前一個工作階段長度。
xdm.commerce.checkouts.id
將事件序列化套用到結帳量度。
xdm.commerce.checkouts.value
讓結帳量度遞增所需的金額。
xdm.commerce.order.currencyCode
設定 currencyCode 設定變數。
xdm.commerce.order.purchaseID
設定 purchaseID 頁面變數。
xdm.commerce.order.payments[0].transactionID
設定 transactionID 頁面變數。
xdm.commerce.productListAdds.id
將事件序列化套用到購物車新增量度。
xdm.commerce.productListAdds.value
增加購物車新增量度。
xdm.commerce.productListOpens.id
將事件序列化套用到購物車量度。
xdm.commerce.productListOpens.value
增加購物車量度。
xdm.commerce.productListRemovals.id
將事件序列化套用到購物車移除量度。
xdm.commerce.productListRemovals.value
增加購物車移除量度。
xdm.commerce.productListViews.id
將事件序列化套用到購物車檢視量度。
xdm.commerce.productListViews.value
增加購物車檢視量度。
xdm.commerce.productViews.id
將事件序列化套用到產品檢視量度。
xdm.commerce.productViews.value
增加產品檢視量度。
xdm.commerce.purchases.value
增加訂單量度。
xdm.device.model
行動生命週期維度裝置名稱。
xdm.device.colorDepth
協助設定色彩深度維度。
xdm.device.screenHeight
協助設定顯示器解析度維度。
xdm.device.screenWidth
協助設定顯示器解析度維度。
xdm.device.type
行動裝置類型。
xdm.environment.browserDetails.acceptLanguage
協助設定語言維度。
xdm.environment.browserDetails.cookiesEnabled
設定 Cookie 支援維度。有效值包括 Y (瀏覽器接受 Cookie) 和 N (瀏覽器拒絕 Cookie)。
xdm.environment.browserDetails.javaEnabled
設定 Java 已啟用維度。有效值包括 Y (Java 已啟用) 和 N (Java 已停用)。
xdm.environment.browserDetails.userAgent
用作遞補不重複訪客識別方法。通常會使用 User-Agent HTTP 請求標頭填入。如果您想要在報告中使用這個欄位，可以將它對應到 eVar。
xdm.environment.browserDetails.viewportHeight
設定瀏覽器高度維度。
xdm.environment.browserDetails.viewportWidth
設定瀏覽器寬度維度。
xdm.environment.carrier
行動生命週期維度電信業者名稱。
xdm.environment.connectionType
協助設定連線類型維度。
xdm.environment._dc.language
設定內容資料變數a.locale。 僅在未設定xdm.environment.language時使用。 Adobe建議超過xdm.environment.language使用此欄位。
xdm.environment.ipV4
用作遞補不重複訪客識別方法。通常會使用 X-Forwarded-For HTTP 標頭填入。
xdm.environment.language
設定內容資料變數a.locale。 Adobe建議改用xdm.environment._dc.language。
xdm.environment.operatingSystem
行動生命週期維度作業系統。
xdm.environment.operatingSystemVersion
協助設定行動生命週期維度作業系統版本。
xdm._experience.analytics.customDimensions.
eVars.eVar1
[...]
xdm._experience.analytics.customDimensions.
eVars.eVar250
設定個別 eVar 維度。
xdm._experience.analytics.customDimensions.
hierarchies.hier1
[...]
xdm._experience.analytics.customDimensions.
hierarchies.hier5
設定個別階層維度。
xdm._experience.analytics.customDimensions.
listProps.prop1.delimiter
[...]
xdm._experience.analytics.customDimensions.
listProps.prop75.delimiter
清單屬性分隔符號覆寫。不建議使用此欄位，因為分隔符號是根據報告套裝設定，從流量變數管理員自動擷取。使用此欄位可能會造成所使用的分隔符號與 Analytics 預期使用的分隔符號不相符。
xdm._experience.analytics.customDimensions.
listProps.prop1.values
[...]
xdm._experience.analytics.customDimensions.
listProps.prop75.values
字串陣列含有個別清單流量變數值。
xdm._experience.analytics.customDimensions.
lists.list1.list[].value
[...]
xdm._experience.analytics.customDimensions.
lists.list3.list[].value
將個別 list[] 陣列中的所有 value 字串都串連到其個別清單變數。分隔符號是根據報表套裝設定中的值集自動選擇。
xdm._experience.analytics.customDimensions.
props.prop1
[...]
xdm._experience.analytics.customDimensions.
props.prop75
設定個別流量變數維度。
xdm._experience.analytics.event1to100.
event1.id
[...]
xdm._experience.analytics.event901to1000.
event1000.id
套用事件序列化至個別自訂事件量度。每個事件 ID 位於其 100 群組父系中。例如，若要將序列化應用於 event678，請使用 xdm._experience.analytics.event601to700.event678.id。
xdm._experience.analytics.event1to100.
event1.value
[...]
xdm._experience.analytics.event901to1000.
event1000.value
將個別自訂事件量度增加所需的數量。每個事件位於其 100 群組父系中。例如，event567 的欄位是 xdm._experience.analytics.event501to600.event567.value。
xdm.identityMap.ECID[0].id
Adobe Experience Cloud 身分識別服務 ID。
xdm.marketing.trackingCode
設定追蹤程式碼維度。
xdm.media.mediaTimed.completes.value
串流媒體服務量度內容完成。
xdm.media.mediaTimed.dropBeforeStart.value
a.media.view、a.media.timePlayed、a.media.play
xdm.media.mediaTimed.federated.value
串流媒體服務量度同盟資料。
xdm.media.mediaTimed.firstQuartiles.value
串流媒體服務量度25%進度標籤。
xdm.media.mediaTimed.mediaSegmentView.value
串流媒體服務量度內容區段檢視。
xdm.media.mediaTimed.midpoints.value
串流媒體服務量度50%進度標籤。
xdm.media.mediaTimed.pauseTime.value
串流媒體服務量度總暫停期間。
xdm.media.mediaTimed.pauses.value
串流媒體服務量度暫停事件。
xdm.mediaCollection.sessionDetails.assetID
串流媒體服務維度資產識別碼。
xdm.mediaCollection.sessionDetails.friendlyName
串流媒體服務維度視訊名稱。
xdm.mediaCollection.sessionDetails.originator
串流媒體服務維度創作者。
xdm.mediaCollection.sessionDetails.episode
串流媒體服務維度Episode。
xdm.mediaCollection.sessionDetails.genre
串流媒體服務維度型別。
xdm.mediaCollection.sessionDetails.rating
串流媒體服務維度內容評等。
xdm.mediaCollection.sessionDetails.season
串流媒體服務維度季。
xdm.mediaCollection.sessionDetails.name
串流媒體服務維度內容識別碼。
xdm.mediaCollection.sessionDetails.show
串流媒體服務維度節目。
xdm.mediaCollection.sessionDetails.showType
串流媒體服務維度節目型別。
xdm.mediaCollection.sessionDetails.length
串流媒體服務維度視訊長度。
xdm.media.mediaTimed.primaryAssetViewDetails.@id
串流媒體服務維度媒體工作階段識別碼。
xdm.mediaCollection.sessionDetails.channel
串流媒體服務維度內容頻道。
xdm.mediaCollection.sessionDetails.contentType
串流媒體服務維度內容型別。
xdm.mediaCollection.sessionDetails.network
串流媒體服務維度網路。
xdm.media.mediaTimed.primaryAssetViewDetails.
mediaSegmentView.value
串流媒體服務維度內容區段。
xdm.mediaCollection.sessionDetails.playerName
串流媒體服務維度內容播放器名稱。
xdm.mediaCollection.sessionDetails.appVersion
串流媒體服務維度SDK版本。
xdm.mediaCollection.sessionDetails.feed
串流媒體服務維度媒體摘要型別。
xdm.mediaCollection.sessionDetails.streamFormat
串流媒體服務維度串流格式。
xdm.media.mediaTimed.progress10.value
串流媒體服務量度1%進度標籤。
xdm.media.mediaTimed.progress95.value
串流媒體服務量度95%進度標籤。
xdm.mediaCollection.sessionDetails.hasResume
串流媒體服務量度內容繼續。
xdm.media.mediaTimed.starts.value
串流媒體服務量度媒體開始。
xdm.media.mediaTimed.thirdQuartiles.value
串流媒體服務量度75%進度標籤。
xdm.media.mediaTimed.timePlayed.value
串流媒體服務量度內容逗留時間。
xdm.media.mediaTimed.totalTimePlayed.value
串流媒體服務量度媒體逗留時間。
xdm.placeContext.geo._schema.latitude
訪客的緯度位置。 協助設定行動生命週期位置維度。
xdm.placeContext.geo._schema.longitude
訪客的經度位置。 協助設定行動生命週期位置維度。
xdm.placeContext.geo.postalCode
郵遞區號維度。
xdm.placeContext.geo.stateProvince
美國州別維度。
xdm.placeContext.localTime
在資料摘要中顯示為 t_time_info。
xdm.productListItems[]._experience.analytics.
customDimensions.eVars.eVar1
[...]
xdm.productListItems[]._experience.analytics.
customDimensions.eVars.eVar250
將產品語法銷售套用至 eVars。
xdm.productListItems[]._experience.analytics.
event1to100.event1.value
[...]
xdm.productListItems[]._experience.analytics.
event901-1000.event1000.value
將產品語法銷售套用至事件。
xdm.productListItems[].productCategories[].categoryID
類別維度。另外請查看產品頁面變數。
xdm.productListItems[].name
產品維度。另外請查看 產品 頁面變數。如果 xdm.productListItems[].SKU 和 xdm.productListItems[].name 都包含資料，則使用 xdm.productListItems[].SKU 中的值。
xdm.productListItems[].priceTotal
協助判斷收入量度。另外請查看產品頁面變數。
xdm.productListItems[].quantity
協助判斷單位量度。另外請查看產品頁面變數。
xdm.productListItems[].SKU
產品維度。另外請查看 產品 頁面變數。如果 xdm.productListItems[].SKU 和 xdm.productListItems[].name 都包含資料，則使用 xdm.productListItems[].SKU 中的值。
xdm.web.webInteraction.URL
linkURL 實作變數。
xdm.web.webInteraction.name
自訂連結、下載連結或退出連結維度 (視 xdm.web.webInteraction.type 中的值而定)
xdm.web.webInteraction.type
判斷點擊的連結類型。有效值包括 other (自訂連結)、download (下載連結) 和 exit (退出連結)。
xdm.web.webPageDetails.URL
頁面 URL 維度。
xdm.web.webPageDetails.isErrorPage
有助於判斷「找不到頁面」維度和量度的旗標。
xdm.web.webPageDetails.name
頁面維度。
xdm.web.webPageDetails.server
伺服器維度。
xdm.web.webPageDetails.siteSection
網站區段維度。
xdm.web.webReferrer.URL
反向連結維度。

將其他 XDM 欄位對應到 Analytics 變數

如果有任何維度或量度要新增至Adobe Analytics，您可以透過內容資料變數來進行。

隱含對應

任何未自動對應的XDM欄位元素都會當作前置詞為a.x.的內容資料傳送至Adobe Analytics。 您可以使用處理規則，將此內容資料變數對應到所需的Analytics變數。 例如，如果您傳送以下事件︰

alloy("event",{
    "xdm":{
        "_atag":{
            "search":{
                "term":"Example search term"
            }
        }
    }
})

Web SDK 會將該資料當作內容資料變數 a.x._atag.search.term 傳送給 Adobe Analytics。然後，您可以使用處理規則將該內容資料變數值指派給所需的Analytics變數，例如eVar：

搜尋字詞處理規則

明確對應

您也可以將XDM欄位元素明確對應為內容資料。 使用contextData元素明確對應的任何XDM欄位元素都會當作無首碼的內容資料傳送至Adobe Analytics。 您可以使用處理規則，將此內容資料變數對應到所需的Analytics變數。 例如，如果您傳送以下事件︰

alloy("event",{
    "xdm":{
        "_atag":{
            "analytics": {
                "contextData" : {
                    "someValue" : "1"
                }
            }
        }
    }
})

Web SDK會將該資料以內容資料變數somevalue的形式傳送至Adobe Analytics，其值為1。 然後，您可以使用處理規則將該內容資料變數值指派給所需的Analytics變數，例如eVar：

搜尋字詞處理規則

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690