XDM物件變數對應至Adobe Analytics

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
實施基礎知識

建立對象：

管理員
開發人員

下表顯示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.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

串流媒體量度內容完成。

xdm.media.mediaTimed.dropBeforeStart.value

c.a.media.view、c.a.media.timePlayed、c.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.media.mediaTimed.primaryAssetReference.
@id

串流媒體維度資產識別碼。

xdm.media.mediaTimed.primaryAssetReference.
dc:title

串流媒體維度視訊名稱。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Creator[N].iptc4xmpExt:Name

串流媒體維度創作者。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Episode.iptc4xmpExt:Number

串流媒體維度Episode。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Genre

串流媒體維度型別。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Rating[N].iptc4xmpExt:RatingValue

串流媒體維度內容評等。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Season.iptc4xmpExt:Number

串流媒體維度季。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Series.iptc4xmpExt:Identifier

串流媒體維度內容識別碼。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Series.iptc4xmpExt:Name

串流媒體維度節目。

xdm.media.mediaTimed.primaryAssetReference.
showType

串流媒體維度節目型別。

xdm.media.mediaTimed.primaryAssetReference.
xmpDM:duration

串流媒體維度視訊長度。

xdm.media.mediaTimed.primaryAssetViewDetails.
@id

串流媒體維度媒體工作階段識別碼。

xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastChannel

串流媒體維度內容頻道。

xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastContentType

串流媒體維度內容型別。

xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastNetwork

串流媒體維度網路。

xdm.media.mediaTimed.primaryAssetViewDetails.
mediaSegmentView.value

串流媒體維度內容區段。

xdm.media.mediaTimed.primaryAssetViewDetails.
playerName

串流媒體維度內容播放器名稱。

xdm.media.mediaTimed.primaryAssetViewDetails.
playerSDKVersion.version

串流媒體維度SDK版本。

xdm.media.mediaTimed.primaryAssetViewDetails.
sourceFeed

串流媒體維度媒體摘要型別。

xdm.media.mediaTimed.primaryAssetViewDetails.
streamFormat

串流媒體維度串流格式。

xdm.media.mediaTimed.progress10.value

串流媒體量度1%進度標籤。

xdm.media.mediaTimed.progress95.value

串流媒體量度95%進度標籤。

xdm.media.mediaTimed.resumes.value

串流媒體量度內容繼續。

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