配置SDK

SDK的配置是使用命令完 configure 成的。

重要

configure 应该 始终 是第一个名为的命令。

alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

在配置过程中可以设置许多选项。 所有选项均可在下面找到,按类别分组。

常规选项

edgeConfigId

类型 必需 默认值
字符串

您分配的配置ID,它将SDK链接到相应的帐户和配置。 在单个页面中配置多个实例时,必须为每个实例配 edgeConfigId 置不同的实例。

context

类型 必需 默认值
字符串数组 ["web", "device", "environment", "placeContext"]

指示要自动收集的上下文类别,如自 动信息中所述。 如果未指定此配置,则默认情况下将使用所有类别。

debugEnabled

类型 必需 默认值
布尔值 false

指示是否应启用调试。 将此配置设置 true 为启用以下功能:

功能 函数
同步验证 验证根据模式收集的数据,并在以下标签下的响应中返回错误: collect:error OR success
控制台日志记录 允许调试消息显示在浏览器的JavaScript控制台中

edgeDomain

类型 必需 默认值
字符串 beta.adobedc.net

用于与Adobe服务交互的域。 仅当您有第一方域(CNAME)来代理对Adobe边缘基础结构的请求时,才使用此方法。

orgId

类型 必需 默认值
字符串

Your assigned Experience Cloud organization ID. 在页面内配置多个实例时,必须为每个实例配 orgId 置不同的实例。

数据收集

clickCollectionEnabled

类型 必需 默认值
布尔值 true

指示是否应自动收集与链接单击关联的数据。 请参 阅自动链接 ,以了解更多信息。

onBeforeEventSend

类型 必需 默认值
函数 ()=>未定义

设置此设置可配置在发送每个事件之前调用的回调。 包含该字段的 xdm 对象将发送到回调。 修改对 xdm 象以更改发送的内容。 在回调中,对 xdm 象已在事件命令中传递数据,并自动收集信息。 有关此回调的时间安排的详细信息和示例,请参阅全局 修改事件

隐私选项

类型 必需 默认值
对象 "in"

设置用户的默认同意。 当尚未为用户保存同意首选项时,将使用此选项。 另一个有效值是 "pending"。 设置此项后,工作将排队,直到用户提供同意首选项。 提供用户首选项后,工作将根据用户的首选项继续或中止。 有关详 细信息 ,请参阅支持同意。

个性化选项

prehidingStyle

类型 必需 默认值
字符串

用于创建CSS样式定义,该定义在从服务器加载个性化内容时隐藏网页的内容区域。 如果未提供此选项,则加载个性化内容时SDK不会尝试隐藏任何内容区域,这可能导致“闪烁”。

例如,如果网页上有一个元素,其ID为您想在从服务器加载个性化 container 内容时隐藏其默认内容,则预隐藏样式的示例如下:

  prehidingStyle: "#container { opacity: 0 !important }"

受众选项

cookieDestinationsEnabled

类型 必需 默认值
布尔值 true

启 Audience Manager 用Cookie目标,允许根据区段资格设置Cookie。

urlDestinationsEnabled

类型 必需 默认值
布尔值 true

启 Audience Manager 用URL目标,它允许基于段资格触发URL。

标识选项

idMigrationEnabled

类型 必需 默认值
布尔值 true

如果为真,则SDK将阅读并设置旧版AMCV cookie。 这有助于过渡到使用Adobe Experience PlatformWeb SDK,而站点的某些部分可能仍在使用访客.js。 此外,如果页面上定义了访客API,则SDK将查询ECID的访客API。 这使您能够使用AEP Web SDK对两个标签页添加标签,同时仍具有相同的ECID。

thirdPartyCookiesEnabled

类型 必需 默认值
布尔值 true

启用Adobe第三方Cookie的设置。 SDK能够将访客ID保留在第三方上下文中,从而允许在多个站点上使用相同的访客ID。 如果您有多个站点或希望与合作伙伴共享数据,则此功能非常有用;但是,有时出于隐私原因而不需要这样做。

在此页面上