`context`

Last update: Tue Mar 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Web SDK

建立對象：

Developer

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

內容關鍵字和XDM元素

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

Web

此 "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 路徑

範例值

環境類型

體驗出現的環境型別。 Web 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

2019-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.

環境

收集資料的環境。此一律設為 browser.

xdm.implementationDetails.environment

browser

高平均資訊量使用者端提示

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

如果您在下列情況下使用裝置查詢：設定您的資料流，資料可以清除，改用裝置查詢值。某些使用者端提示欄位和裝置查詢欄位不得存在於相同點選中。

維度

說明

HTTP 標題

XDM 路徑

範例值

作業系統版本

作業系統的版本。

Sec-CH-UA-Platform-Version

xdm.environment.browserDetails.
userAgentClientHints.platformVersion

架構

底層CPU架構。

Sec-CH-UA-Arch

xdm.environment.browserDetails.
userAgentClientHints.architecture

裝置型號

使用的裝置名稱。

Sec-CH-UA-Model

xdm.environment.browserDetails.
userAgentClientHints.model

位元

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

Sec-CH-UA-Bitness

xdm.environment.browserDetails.
userAgentClientHints.bitness

瀏覽器供應商

建立瀏覽器的公司。低平均資訊量提示 Sec-CH-UA 也會收集此元素。

Sec-CH-UA-Full-Version-List

瀏覽器名稱

使用的瀏覽器。低平均資訊量提示 Sec-CH-UA 也會收集此元素。

Sec-UA-Full-Version-List

xdm.environment.browserDetails.
userAgentClientHints.brand

瀏覽器版本

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

Sec-UA-Full-Version-List

xdm.environment.browserDetails.
userAgentClientHints.version

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

內容資訊設定是選項按鈕和核取方塊的組合，當設定標籤擴充功能. 每個核取方塊都會對應至一個內容關鍵字。

登入 experience.adobe.com 使用您的Adobe ID憑證。
瀏覽至 資料彙集 > 標籤.
選取所需的標籤屬性。
瀏覽至 擴充功能，然後按一下設定於 Adobe Experience Platform Web SDK 卡片。
向下捲動至資料彙集區段，然後選取 所有預設內容資訊 或 特定內容資訊.
如果您選取 特定內容資訊，啟用每個所需內容資訊元素旁的核取方塊。
按一下儲存，然後發佈您的變更。

使用Web SDK JavaScript程式庫收集內容資訊

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

NOTE

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

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

recommendation-more-help

ad108910-6329-42f1-aa1d-5920a2b13636