`context`

Last update: Mon Aug 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

開發人員

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

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

TIP

如需如何設定的詳細資訊，請參閱使用者代理程式使用者端提示的相關檔案。

"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

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

在設定標籤延伸模組時，內容資訊設定是選項按鈕和核取方塊的組合。每個核取方塊都會對應至一個內容關鍵字。

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

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

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

NOTE

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

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

recommendation-more-help

ad108910-6329-42f1-aa1d-5920a2b13636