配置数据流覆盖
edgeConfigOverrides
对象允许您覆盖在当前页面上运行的命令的配置设置。 此覆盖对象不是命令,而是可包含在大多数Web SDK命令中的对象。
当您在不同的国家/地区拥有不同的网站或子域,或者您拥有多个Experience Platform沙盒来存储特定于不同业务部门的数据时,此对象非常有用。
数据流配置覆盖分为两步:
如果在Web SDK配置和特定命令(例如sendEvent
)中设置覆盖,则特定命令中的覆盖优先。
对象属性
以下属性在此对象中可用:
- 数据流覆盖:将调用发送到其他数据流。 如果设置此值,则必须在此处设置的数据流中配置需要数据流配置的其他覆盖。
- 第三方ID同步容器: Adobe Audience Manager中目标第三方ID同步容器的ID。 使用此字段之前,需要在数据流的设置中配置第三方ID容器覆盖。
- 目标属性令牌: Adobe Target中目标属性的令牌。 使用此字段之前,需要先在数据流的设置中配置Target属性令牌覆盖。
- 报表包:要在Adobe Analytics中覆盖的报表包ID。 使用此字段之前,需要先在数据流的设置中配置报表包覆盖。
通过Web SDK标记扩展向Edge Network发送数据流覆盖 tag-extension
有关详细的配置说明,请参阅有关Web SDK标记扩展中的配置数据流覆盖的文档。
如果要从Web SDK标记扩展配置数据流覆盖,请在配置标记扩展时设置 数据流配置覆盖 下的每个所需字段。
- 使用您的Adobe ID凭据登录experience.adobe.com。
- 导航到 数据收集 > 标记。
- 选择所需的标记属性。
- 导航到 扩展,然后单击Adobe Experience Platform Web SDK卡片上的 配置。
- 向下滚动到 数据流配置覆盖 部分。 设置每个所需的覆盖值。
- 单击 保存,然后发布更改。
如果只想为特定命令设置覆盖,请在标记规则的操作中设置每个所需字段。
- 使用您的Adobe ID凭据登录experience.adobe.com。
- 导航到 数据收集 > 标记。
- 选择所需的标记属性。
- 导航到 规则,然后选择所需的规则。
- 在操作下,选择现有操作或创建操作。
- 将扩展下拉字段设置为 Adobe Experience Platform Web SDK,并将操作类型设置为 发送事件。
- 向下滚动到标记为 数据流配置覆盖 的部分。
- 将此部分中的每个字段设置为所需的覆盖值。
- 单击 保留更改,然后运行发布工作流程。
为开发、暂存和生产环境提供了单独的字段。 确保为每个环境填写每个所需的字段。
通过Web SDK JavaScript库将覆盖发送到Edge Network library
在数据收集UI中配置数据流覆盖后,您现在可以通过Web SDK JavaScript库将覆盖发送到Edge Network。
如果您使用的是Web SDK,通过edgeConfigOverrides
命令将覆盖发送到Edge Network是激活数据流配置覆盖的第二步,也是最后一步。
数据流配置覆盖通过 edgeConfigOverrides
Web SDK 命令发送到 Edge Network。此命令创建数据流覆盖,这些覆盖在下一个命令中传递到Edge Network。 如果您使用configure
命令,则会为每个请求传递覆盖。
edgeConfigOverrides
命令创建数据流覆盖,这些数据流覆盖在下一个命令上传递到Edge Network。
当使用 configure
命令发送配置覆盖时,它包含在以下 Web SDK 命令中。
全局指定的选项可由各个命令上的配置选项覆盖。
通过Web SDK sendEvent
命令发送配置覆盖 send-event
以下示例显示 sendEvent
命令中的配置覆盖的情况。
alloy("sendEvent", {
xdm: {
/* ... */
},
edgeConfigOverrides: {
datastreamId: "{DATASTREAM_ID}"
com_adobe_experience_platform: {
datasets: {
event: {
datasetId: "SampleEventDatasetIdOverride"
}
}
},
com_adobe_analytics: {
reportSuites: [
"MyFirstOverrideReportSuite",
"MySecondOverrideReportSuite",
"MyThirdOverrideReportSuite"
]
},
com_adobe_identity: {
idSyncContainerId: "1234567"
},
com_adobe_target: {
propertyToken: "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
}
}
});
edgeConfigOverrides.datastreamId
configure
命令定义的数据流不同的数据流。com_adobe_analytics.reportSuites[]
com_adobe_identity.idSyncContainerId
com_adobe_target.propertyToken
通过Web SDK configure
命令发送配置覆盖 send-configure
以下示例显示 configure
命令中的配置覆盖的情况。
alloy("configure", {
defaultConsent: "in",
edgeDomain: "etc",
edgeBasePath: "ee",
datastreamId: "{DATASTREAM_ID}",
orgId: "org",
debugEnabled: true,
edgeConfigOverrides: {
"com_adobe_experience_platform": {
"datasets": {
"event": {
datasetId: "SampleProfileDatasetIdOverride"
}
}
},
"com_adobe_analytics": {
"reportSuites": [
"MyFirstOverrideReportSuite",
"MySecondOverrideReportSuite",
"MyThirdOverrideReportSuite"
]
},
"com_adobe_identity": {
"idSyncContainerId": "1234567"
},
"com_adobe_target": {
"propertyToken": "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
}
},
onBeforeEventSend: function() { /* … */ });
};
edgeConfigOverrides.datastreamId
configure
命令定义的数据流不同的数据流。com_adobe_analytics.reportSuites[]
com_adobe_identity.idSyncContainerId
com_adobe_target.propertyToken