`context`

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

開發人員

context屬性是字串陣列，可決定Web SDK可自動收集的內容。雖然此資料可提供絕佳價值，但若省略其中部分資料，則可讓您遵守組織的隱私權政策。

內容關鍵字和XDM元素

如果您包含指定的上下文關鍵字，Web SDK會自動填入其所有關聯的XDM元素。如果您想在允許其他專案時省略特定的XDM專案，可以使用onBeforeEventSend清除值。如果您在頁面上傳送多個事件，Web SDK會在每SendEvent呼叫中包含這些欄位。

網頁

"web"關鍵字會收集有關目前頁面的資訊。

維度

說明

XDM 路徑

範例值

頁面 URL

目前頁面的URL。

xdm.web.webPageDetails.URL

https://example.com/index.html

反向連結URL

造訪的上一個頁面的URL。

xdm.web.webReferrer.URL

http://example.org/linkedpage.html

裝置

"device"關鍵字會收集使用者裝置的相關資訊。

維度

說明

XDM 路徑

範例值

熒幕高度

熒幕的高度（畫素）。

xdm.device.screenHeight

900

熒幕寬度

熒幕的寬度（畫素）。

xdm.device.screenWidth

1440

熒幕方向

熒幕方向。

xdm.device.screenOrientation

landscape或portrait

環境

"environment"關鍵字會收集有關使用者瀏覽器的資訊。

維度

說明

XDM 路徑

範例值

環境類型

體驗出現的環境型別。網頁SDK一律將此欄位設為browser。

xdm.environment.type

browser

檢視區高度

瀏覽器內容區域的高度（畫素）。

xdm.environment.browserDetails.viewportHeight

679

檢視區寬度

瀏覽器內容區域的寬度（畫素）。

xdm.environment.browserDetails.viewportWidth

642

地標內容

"placeContext"關鍵字會收集有關使用者位置的資訊。

維度

說明

XDM 路徑

範例值

當地時間

一般使用者的本機時間戳記，採用簡化的延伸ISO 8601格式。

xdm.placeContext.localTime

YYYY-08-07T15:47:17.129-07:00

當地時區位移

使用者與GMT時差的分鐘數。

xdm.placeContext.localTimezoneOffset

360

國家/地區代碼

一般使用者的國家/地區代碼。

xdm.placeContext.geo.countryCode

US

州/省

一般使用者的省/市/自治區代碼。

xdm.placeContext.geo.stateProvince

CA

緯度

一般使用者位置的緯度。

xdm.placeContext.geo._schema.latitude

37.3307447

經度

一般使用者位置的經度。

xdm.placeContext.geo._schema.longitude

-121.8945965

時間戳記

"timestamp"關鍵字會收集有關事件時間戳記的資訊。此內容一律包含在內，無法移除。

維度

說明

XDM 路徑

範例值

事件的時間戳記

使用者的UTC時間戳記，使用簡化的延伸ISO 8601格式。

xdm.timestamp

YYYY-08-07T22:47:17.129Z

實作詳細資料

implementationDetails關鍵字會收集用來收集事件之SDK版本的相關資訊。

維度

說明

XDM 路徑

範例值

名稱

軟體開發套件(SDK)識別碼。此欄位會使用URI來改善不同軟體程式庫所提供的識別碼之間的唯一性。

xdm.implementationDetails.name

使用獨立程式庫時，值為https://ns.adobe.com/experience/alloy。當資料庫作為標籤延伸的一部分使用時，值為https://ns.adobe.com/experience/alloy+reactor。

版本

軟體開發套件(SDK)版本。

xdm.implementationDetails.version

使用獨立程式庫時，值為程式庫版本。當將程式庫用作標籤擴充功能的一部分時，值為程式庫版本和使用+聯結的標籤擴充功能版本。例如，如果程式庫版本是2.1.0，而標籤延伸版本是2.1.3，則值將是2.1.0+2.1.3。

環境

收集資料的環境。使用JavaScript資料庫時，此欄位一律設為browser。

xdm.implementationDetails.environment

browser

高平均資訊量使用者端提示 high-entropy-client-hints

"highEntropyUserAgentHints"關鍵字會收集使用者裝置的詳細資訊。此資料包含在傳送至Adobe之請求的HTTP標頭中。資料到達Edge網路後，XDM物件會填入其個別的XDM路徑。如果您在sendEvent呼叫中設定個別XDM路徑，則其優先於HTTP標頭值。

如果您在設定您的資料流時使用裝置查詢，則資料可以清除掉，以支援裝置查詢值。某些使用者端提示欄位和裝置查詢欄位不得存在於相同點選中。

屬性

說明

HTTP標頭

XDM 路徑

範例

作業系統版本

作業系統的版本。

Sec-CH-UA-Platform-Version

xdm.environment.browserDetails.
userAgentClientHints.platformVersion

10.15.7

架構

底層CPU架構。

Sec-CH-UA-Arch

xdm.environment.browserDetails.
userAgentClientHints.architecture

x86

裝置型號

使用的裝置名稱。

Sec-CH-UA-Model

xdm.environment.browserDetails.
userAgentClientHints.model

Intel Mac OS X 10_15_7

位元

基礎CPU架構支援的位元數。

Sec-CH-UA-Bitness

xdm.environment.browserDetails.
userAgentClientHints.bitness

64

瀏覽器供應商

建立瀏覽器的公司。低平均資訊量提示Sec-CH-UA也會收集這個專案。

Sec-CH-UA-Full-Version-List

xdm.environment.browserDetails.
userAgentClientHints.vendor

Google

瀏覽器名稱

使用的瀏覽器。低平均資訊量提示Sec-CH-UA也會收集這個專案。

Sec-UA-Full-Version-List

xdm.environment.browserDetails.
userAgentClientHints.brand

Chrome

瀏覽器版本

瀏覽器的重要版本。低平均資訊量提示Sec-CH-UA也會收集這個專案。系統不會自動收集精確的瀏覽器版本。

Sec-UA-Full-Version-List

xdm.environment.browserDetails.
userAgentClientHints.version

105

如需詳細資訊，請參閱使用者代理程式使用者端提示。

執行context命令時設定configure字串陣列。如果您在設定SDK時省略此屬性，預設會收集除"highEntropyUserAgentHints"以外的所有內容資訊。如果您想要收集高平均資訊量使用者端提示，或您想要從資料收集中忽略其他內容資訊，請設定此屬性。字串可以包含在任何順序中。

NOTE

如果您想要收集所有內容資訊，包括高平均資訊量使用者端提示，您必須在context陣列字串中包含每個值。預設context值會省略highEntropyUserAgentHints，如果您設定context屬性，則任何省略的值都不會收集資料。

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  context: ["web", "device", "environment", "placeContext", "highEntropyUserAgentHints"]
});

使用網頁SDK標籤擴充功能收集內容資訊

請參閱Web SDK標籤擴充功能檔案中資料收集組態設定下的內容設定。

recommendation-more-help

1ae86b30-e55e-49c1-ab11-9d0356a5f3e1