Show Menu
主题×

配置SDK

SDK的配置是使用命令完 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

类型
必需
默认值
字符串
您分配的Experience Cloud组织ID。 在页面内配置多个实例时,必须为每个实例配 orgId 置不同的实例。

数据收集

clickCollectionEnabled

类型
必需
默认值
布尔值
true
指示是否应自动收集与链接单击关联的数据。 对于符合链接单击条件的单击,将收 集以下Web Interaction数据:
属性
链接名称
由链接上下文确定的名称
链接URL
标准化URL
链接类型
设置为下载、退出或其他

onBeforeEventSend

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

隐私选项

defaultConsent

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

个性化选项

prehidingStyle

类型
必需
默认值
字符串
用于创建CSS样式定义,该定义在从服务器加载个性化内容时隐藏网页的内容区域。 如果未提供此选项,则加载个性化内容时SDK不会尝试隐藏任何内容区域,这可能导致“闪烁”。
例如,如果网页上有一个元素,其ID为您想在从服务器加载个性化 container 内容时隐藏其默认内容,则预隐藏样式的示例如下:
  prehidingStyle: "#container { opacity: 0 !important }"

受众选项

cookieDestinationsEnabled

类型
必需
默认值
布尔值
true
启用Cookie目标,允许根据区段资格设置Cookie。

urlDestinationsEnabled

类型
必需
默认值
布尔值
true
启用URL目标,它允许基于段资格触发URL。

标识选项

idSyncContainerId

类型
必需
默认值
数值
容器ID,指定触发哪个ID同步。 这是可从顾问处获取的非负整数。

idSyncEnabled

类型
必需
默认值
布尔值
true
启用ID同步功能,该功能允许触发URL以将Adobe唯一用户ID与第三方数据源的唯一用户ID同步。

thirdPartyCookiesEnabled

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