`context`

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

undefined

context属性是一个字符串数组，用于确定Web SDK可自动收集的内容。虽然此数据可以带来巨大价值，但忽略某些此类数据可能会有助益，这样您就可以遵守组织的隐私政策。

上下文关键字和XDM元素

如果您包含给定的上下文关键词，则Web SDK会自动填充其所有关联的XDM元素。如果要在允许其他元素的同时忽略特定XDM元素，可以使用onBeforeEventSend清除值。如果您在一个页面上发送多个事件，则Web SDK会在每SendEvent调用中包含这些字段。

Web

"web"关键字收集有关当前页面的信息。

维度

描述

XDM 路径

示例值

Page 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 路径

示例值

事件的时间戳

以简化的扩展ISO 8601格式表示的最终用户的UTC时间戳。

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路径。如果您在sendEvent调用中设置相应的XDM路径，则该路径优先于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标记扩展收集上下文信息

在配置标记扩展时，上下文信息设置是单选按钮和复选框的组合。每个复选框都映射到context关键字。

使用您的Adobe ID凭据登录experience.adobe.com。
导航到 数据收集 > 标记。
选择所需的标记属性。
导航到扩展，然后单击Adobe Experience Platform Web SDK卡片上的配置。
向下滚动到数据收集部分，然后选择 所有默认上下文信息 或 特定上下文信息。
如果选择 特定上下文信息，请启用每个所需上下文信息元素旁边的复选框。
单击保存，然后发布更改。

使用Web SDK JavaScript库收集上下文信息

运行configure命令时设置context字符串数组。如果在配置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