文件Analytics實作指南

XDM物件變數對應至Adobe Analytics

Last update: Tue May 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Admin
  • Developer

下表顯示Adobe Experience PlatformEdge 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.isLaunch
協助判斷何時增加行動生命週期量度首次啟動。
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.ipV4
用作遞補不重複訪客識別方法。通常會使用 X-Forwarded-For HTTP 標頭填入。
xdm.environment.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
Media Analytics 量度內容完成。
xdm.media.mediaTimed.dropBeforeStart.value
c.a.media.view、c.a.media.timePlayed、c.a.media.play
xdm.media.mediaTimed.federated.value
Media Analytics 量度同盟資料。
xdm.media.mediaTimed.firstQuartiles.value
Media Analytics 量度進度標記的 25%。
xdm.media.mediaTimed.mediaSegmentView.value
Media Analytics 量度內容區段檢視。
xdm.media.mediaTimed.midpoints.value
Media Analytics 量度進度標記的 50%。
xdm.media.mediaTimed.pauseTime.value
Media Analytics 量度總暫停期間。
xdm.media.mediaTimed.pauses.value
Media Analytics 量度暫停事件。
xdm.media.mediaTimed.primaryAssetReference.
@id
Media Analytics 維度資產 ID。
xdm.media.mediaTimed.primaryAssetReference.
dc:title
Media Analytics 維度影片名稱。
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Creator[N].iptc4xmpExt:Name
Media Analytics 維度建立者。
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Episode.iptc4xmpExt:Number
Media Analytics 維度劇集。
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Genre
Media Analytics 維度類別。
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Rating[N].iptc4xmpExt:RatingValue
Media Analytics 維度內容評分。
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Season.iptc4xmpExt:Number
Media Analytics 維度季別。
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Series.iptc4xmpExt:Identifier
Media Analytics 維度內容 ID。
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Series.iptc4xmpExt:Name
Media Analytics 維度顯示。
xdm.media.mediaTimed.primaryAssetReference.
showType
Media Analytics 維度顯示類型。
xdm.media.mediaTimed.primaryAssetReference.
xmpDM:duration
Media Analytics 維度影片長度。
xdm.media.mediaTimed.primaryAssetViewDetails.
@id
Media Analytics 維度媒體工作階段 ID。
xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastChannel
Media Analytics 維度內容頻道。
xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastContentType
Media Analytics 維度內容類型。
xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastNetwork
Media Analytics 維度網路。
xdm.media.mediaTimed.primaryAssetViewDetails.
mediaSegmentView.value
Media Analytics 維度內容區段。
xdm.media.mediaTimed.primaryAssetViewDetails.
playerName
Media Analytics 維度內容播放器名稱。
xdm.media.mediaTimed.primaryAssetViewDetails.
playerSDKVersion.version
Media Analytics 維度 SDK 版本。
xdm.media.mediaTimed.primaryAssetViewDetails.
sourceFeed
Media Analytics 維度媒體摘要類型。
xdm.media.mediaTimed.primaryAssetViewDetails.
streamFormat
Media Analytics 維度串流格式。
xdm.media.mediaTimed.progress10.value
Media Analytics 量度進度標記的 10%。
xdm.media.mediaTimed.progress95.value
Media Analytics 量度進度標記的 95%。
xdm.media.mediaTimed.resumes.value
Media Analytics 量度內容履歷。
xdm.media.mediaTimed.starts.value
Media Analytics 量度媒體開始。
xdm.media.mediaTimed.thirdQuartiles.value
Media Analytics 量度進度標記的 75%。
xdm.media.mediaTimed.timePlayed.value
Media Analytics 量度內容花費時間。
xdm.media.mediaTimed.totalTimePlayed.value
Media Analytics 量度媒體花費時間。
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欄位元素都會當作前置詞為的內容資料傳送至Adobe Analytics a.x. 然後您可以使用將此內容資料變數對應到所需的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會將該資料當作內容資料變數傳送給Adobe Analytics somevalue 含值 1. 然後您可以使用處理規則將該內容資料變數值指派給所需的Analytics變數，例如 eVar：

搜尋字詞處理規則

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