SDK的配置已完成 configure
命令。
configure
是 始终 第一个命令名为。
alloy("configure", {
"edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
"orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});
可在配置期间设置许多选项。 所有选项均可在下面找到,并按类别分组。
edgeConfigId
Edge Configurations已更名为数据流。 数据流ID与配置ID相同。
类型 | 必需 | 默认值 |
---|---|---|
字符串 | 是 | None |
您分配的配置ID,用于将SDK链接到相应的帐户和配置。 在单个页面中配置多个实例时,必须配置不同的 edgeConfigId
针对每个实例。
context
类型 | 必需 | 默认值 |
---|---|---|
字符串数组 | 否 | ["web", "device", "environment", "placeContext", "highEntropyUserAgentHints"] |
指示要自动收集的上下文类别,如中所述 自动信息. 如果未指定此配置,则默认使用所有类别。
所有上下文属性,以下情况除外: highEntropyUserAgentHints
,默认情况下处于启用状态。 如果您在Web SDK配置中手动指定了上下文属性,则必须启用所有上下文属性以继续收集所需信息。
启用 高熵客户端提示 在Web SDK部署中,您必须包含其他 highEntropyUserAgentHints
上下文选项,以及您现有的配置。
例如,要从Web属性检索高熵客户端提示,您的配置将如下所示:
context: ["highEntropyUserAgentHints", "web"]
debugEnabled
类型 | 必需 | 默认值 |
---|---|---|
布尔值 | 否 | false |
指示是否启用调试。 将此配置设置为 true
启用以下功能:
功能 | 函数 |
---|---|
控制台日志记录 | 允许在浏览器的JavaScript控制台中显示调试消息 |
edgeDomain
使用您的第一方域填充此字段。 欲知更多详情,请参见 文档.
该域类似于 data.{customerdomain.com}
,以访问www网站。{customerdomain.com}。
edgeBasePath
用于与Adobe服务通信及交互的edgeDomain之后的路径。 通常,只有在不使用默认生产环境时,此更改才会更改。
类型 | 必需 | 默认值 |
---|---|---|
字符串 | 否 | ee |
orgId
类型 | 必需 | 默认值 |
---|---|---|
字符串 | 是 | None |
您分配的 Experience Cloud 组织ID。 在页面中配置多个实例时,必须配置不同的 orgId
针对每个实例。
clickCollectionEnabled
类型 | 必需 | 默认值 |
---|---|---|
布尔值 | 否 | true |
指示是否自动收集与链接点击关联的数据。 参见 自动链接跟踪 了解更多信息。 如果链接包含下载属性或以文件扩展名结尾,则还将其标记为下载链接。 可使用正则表达式配置下载链接限定符。 默认值为 "\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$"
onBeforeEventSend
类型 | 必需 | 默认值 |
---|---|---|
函数 | 否 | () =>未定义 |
配置在发送之前为每个事件调用的回调。 具有字段的对象 xdm
被发送到回调。 要更改发送的内容,请修改 xdm
对象。 在回调内部, xdm
对象已具有在event命令中传递的数据,以及自动收集的信息。 有关此回调时间及示例的更多信息,请参阅 全局修改事件.
onBeforeLinkClickSend
类型 | 必需 | 默认值 |
---|---|---|
函数 | 否 | () =>未定义 |
配置在发送之前为每个链接点击跟踪事件调用的回调。 callback发送一个对象,其中 xdm
, clickedElement
、和 data
字段。
使用DOM元素结构过滤链接跟踪时,您可以使用 clickElement
命令。 clickedElement
是被单击并已封装父节点树的DOM元素节点。
要更改发送的数据,请修改 xdm
和/或 data
对象。 在回调内部, xdm
对象已具有在event命令中传递的数据,以及自动收集的信息。
false
将允许处理事件并发送回调。false
值,事件处理将停止,并且不会出现错误,并且不会发送事件。 此机制允许通过检查事件数据并返回来过滤掉某些事件 false
如果不发送该事件。defaultConsent
类型 | 必需 | 默认值 |
---|---|---|
对象 | 否 | "in" |
设置用户的默认同意。 当尚未为用户保存同意首选项时,使用此设置。 其他有效值为 "pending"
和 "out"
. 此默认值不会保留在用户配置文件中。 用户配置文件仅在以下情况下更新 setConsent
称为。
"in"
:如果设置此设置或未提供值,则无需用户同意即可继续工作。"pending"
:设置此设置后,工作将排入队列,直到用户提供同意首选项。"out"
:设置此设置后,将放弃工作,直到用户提供同意首选项。prehidingStyle
类型 | 必需 | 默认值 |
---|---|---|
字符串 | 否 | None |
用于创建在从服务器加载个性化内容时隐藏网页内容区域的CSS样式定义。 如果未提供此选项,则SDK在加载个性化内容时不会尝试隐藏任何内容区域,这可能会导致“闪烁”。
例如,如果网页上的某个元素的ID为 container
,在从服务器加载个性化内容时,要隐藏其默认内容,请使用以下预隐藏样式:
prehidingStyle: "#container { opacity: 0 !important }"
targetMigrationEnabled
从迁移单个页面时应使用此选项 at.js 到Web SDK。
使用此选项可使Web SDK能够读取和写入旧版 mbox
和 mboxEdgeCluster
使用的Cookie at.js. 这有助于您在从使用Web SDK的页面移动到使用 at.js 库或反之。
类型 | 必需 | 默认值 |
---|---|---|
布尔值 | 否 | false |
cookieDestinationsEnabled
类型 | 必需 | 默认值 |
---|---|---|
布尔值 | 否 | true |
启用 Audience Manager Cookie目标,用于根据区段鉴别设置Cookie。
urlDestinationsEnabled
类型 | 必需 | 默认值 |
---|---|---|
布尔值 | 否 | true |
启用 Audience Manager URL目标,允许根据区段鉴别触发URL。
idMigrationEnabled
类型 | 必需 | 默认值 |
---|---|---|
布尔值 | 否 | true |
如果为true,则SDK会读取和设置旧的AMCV Cookie。 当网站的某些部分可能仍使用Visitor.js时,此选项有助于过渡到Adobe Experience Platform Web SDK的使用。
如果页面上定义了访客API,则SDK会查询访客API以获取ECID。 通过此选项,您可以使用Adobe Experience Platform Web SDK对页面进行双重标记,并且仍然具有相同的ECID。
thirdPartyCookiesEnabled
类型 | 必需 | 默认值 |
---|---|---|
布尔值 | 否 | true |
启用设置Adobe第三方Cookie。 SDK可以在第三方上下文中保留访客ID,以便跨网站使用相同的访客ID。 如果您有多个网站或要与合作伙伴共享数据,请使用此选项;但是,出于隐私原因,有时并不需要使用此选项。