XDM物件欄位對應到Adobe Analytics

下表顯示 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物件欄位都對應至對應的資料物件欄位。 在Adobe Analytics擷取期間,值會先從XDM對應至Analytics變數。 可辨識的資料物件欄位會接著進行對應,並在對應至相同Analytics變數時覆寫先前設定的任何值。 例如,如果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.viewa.media.timePlayeda.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
串流媒體服務維度資產 ID
xdm.mediaCollection.sessionDetails.friendlyName
串流媒體服務維度影片名稱
xdm.mediaCollection.sessionDetails.originator
串流媒體服務維度發起者
xdm.mediaCollection.sessionDetails.episode
串流媒體服務維度集數
xdm.mediaCollection.sessionDetails.genre
串流媒體服務維度類型
xdm.mediaCollection.sessionDetails.rating
串流媒體服務維度內容評級
xdm.mediaCollection.sessionDetails.season
串流媒體服務維度季節
xdm.mediaCollection.sessionDetails.name
串流媒體服務維度內容 ID
xdm.mediaCollection.sessionDetails.show
串流媒體服務維度節目
xdm.mediaCollection.sessionDetails.showType
串流媒體服務維度節目類型
xdm.mediaCollection.sessionDetails.length
串流媒體服務維度影片長度
xdm.media.mediaTimed.primaryAssetViewDetails.@id
串流媒體服務維度媒體工作階段 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
串流媒體服務量度 10% 進度標記
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[].SKUxdm.productListItems[].name 都包含資料,則使用 xdm.productListItems[].SKU 中的值。
xdm.productListItems[].priceTotal
協助判斷收入量度。另外請查看產品頁面變數。
xdm.productListItems[].quantity
協助判斷單位量度。另外請查看產品頁面變數。
xdm.productListItems[].SKU
產品維度。另外請查看 產品 頁面變數。如果 xdm.productListItems[].SKUxdm.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 欄位元素為情境資料。任何明確對應的 XDM 欄位元素將使用 contextData 元素,作為情境資料發送至 Adobe Analytics,並且不帶前置詞。您可以使用處理規則將此情境資料變數對應到所需的 Analytics 變數。例如,如果您傳送以下事件︰

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

Web SDK 將該資料作為情境資料變數 somevalue 並指定值 1 發送至 Adobe Analytics。然後您可以使用處理規則將該情境資料變數值指派給所需的 Analytics 變數,例如 eVar

搜尋字詞處理規則

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