context

最後更新： 2024年8月19日
  • 主題：

建立對象：

  • 開發人員

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

內容關鍵字和XDM元素

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

Web

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

維度說明XDM 路徑範例值
頁面 URL目前頁面的URL。xdm.web.webPageDetails.URLhttps://example.com/index.html
反向連結URL造訪的上一個頁面的URL。xdm.web.webReferrer.URLhttp://example.org/linkedpage.html

裝置

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

維度說明XDM 路徑範例值
畫面高度熒幕的高度（畫素）。xdm.device.screenHeight900
螢幕寬度熒幕的寬度（畫素）。xdm.device.screenWidth1440
螢幕方向熒幕方向。xdm.device.screenOrientationlandscape或portrait

環境

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

維度說明XDM 路徑範例值
環境類型體驗出現的環境型別。 Web SDK一律將此欄位設為browser。xdm.environment.typebrowser
檢視區高度瀏覽器內容區域的高度（畫素）。xdm.environment.browserDetails.viewportHeight679
檢視區寬度瀏覽器內容區域的寬度（畫素）。xdm.environment.browserDetails.viewportWidth642

地方背景

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

維度說明XDM 路徑範例值
本地時間一般使用者的本機時間戳記，採用簡化的延伸ISO 8601格式。xdm.placeContext.localTimeYYYY-08-07T15:47:17.129-07:00
當地時區位移使用者與GMT時差的分鐘數。xdm.placeContext.localTimezoneOffset360
國家/地區代碼一般使用者的國家/地區代碼。xdm.placeContext.geo.countryCodeUS
州/省一般使用者的省/市/自治區代碼。xdm.placeContext.geo.stateProvinceCA
緯度一般使用者位置的緯度。xdm.placeContext.geo._schema.latitude37.3307447
經度一般使用者位置的經度。xdm.placeContext.geo._schema.longitude-121.8945965

時間戳記

timestamp關鍵字會收集有關事件時間戳記的資訊。 無法移除這個部分的內容。

維度說明XDM 路徑範例值
事件的時間戳記使用者的UTC時間戳記，使用簡化的延伸ISO 8601格式。xdm.timestamp2019-08-07T22:47:17.129Z