配置数据流覆盖

Last update: Tue Nov 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

edgeConfigOverrides对象允许您覆盖在当前页面上运行的命令的配置设置。此覆盖对象不是命令，而是可包含在大多数Web SDK命令中的对象。

当您在不同的国家/地区拥有不同的网站或子域，或者您拥有多个Experience Platform沙盒来存储特定于不同业务部门的数据时，此对象非常有用。

IMPORTANT

有关数据流覆盖的详细端到端配置说明，请参阅数据流配置覆盖文档。

数据流配置覆盖分为两步：

首先，必须在数据流UI中的数据流配置页面中定义数据流配置覆盖。有关如何配置覆盖的说明，请参阅数据流配置覆盖文档。
在UI中配置数据流覆盖后，必须通过以下方式之一将覆盖发送到Edge Network：
- 通过Web SDK 标记扩展。
- 通过sendEvent或configure Web SDK命令。
- 通过Mobile SDK sendEvent命令。

如果在Web SDK配置和特定命令（例如sendEvent）中设置覆盖，则特定命令中的覆盖优先。

NOTE

如果希望配置覆盖为禁用 Experience Cloud服务，则必须确保该服务在数据流配置中首先是启用。有关如何向数据流添加服务的详细信息，请参阅有关如何配置数据流的文档。

通过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调用支持的所有动态数据流配置选项。

如果您的数据流配置启用了所有受支持的服务，则以下示例将覆盖此设置并禁用所有服务（请参阅每个服务上的enabled: false设置）。

alloy("sendEvent", {
  renderDecisions: true,
  edgeConfigOverrides: {
    datastreamId: "bfa8fe21-6157-42d3-b47a-78310920b39d",
    com_adobe_experience_platform: {
      enabled: false,
      datasets: {
        event: {
          datasetId: "64b6f949a8a6891ca8a28911",
        },
      },
      com_adobe_edge_ode: {
        enabled: false,
      },
      com_adobe_edge_segmentation: {
        enabled: false,
      },
      com_adobe_edge_destinations: {
        enabled: false,
      },
      com_adobe_edge_ajo: {
        enabled: false,
      },
    },
    com_adobe_analytics: {
      enabled: false,
      reportSuites: ["ujslconfigoverrides3"],
    },
    com_adobe_identity: {
      idSyncContainerId: 34374,
    },
    com_adobe_target: {
      enabled: false,
      propertyToken: "f3fd55e1-a06d-8650-9aa5-c8356c6e2223",
    },
    com_adobe_audience_manager: {
      enabled: false,
    },
    com_adobe_launch_ssf: {
      enabled: false,
    },
  },
});

参数

描述

renderDecisions

edgeConfigOverrides.datastreamId

使用此参数可允许单个请求转到与 configure命令定义的数据流不同的数据流。

edgeConfigOverrides.com_adobe_experience_platform

定义Experience Platform服务的动态数据流配置。

edgeConfigOverrides.com_adobe_experience_platform.enabled

定义是否将事件发送到Experience Platform服务。

edgeConfigOverrides.com_adobe_experience_platform.datasets

定义用于事件的数据集。

edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_ode.enabled

定义是否将事件发送到Offer decisioning服务。

edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_segmentation.enabled

定义是否将事件发送到边缘分段服务。

edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_destinations.enabled

定义是否将事件数据发送到边缘目标。

edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_ajo.enabled

定义是否将事件数据发送到Adobe Journey Optimizer服务。

com_adobe_analytics.enabled

定义是否将事件数据发送到Adobe Analytics。

com_adobe_analytics.reportSuites[]

一个字符串数组，用于确定要将Analytics数据发送到哪些报表包。

com_adobe_identity.idSyncContainerId

要在Audience Manager中使用的第三方ID同步容器。要使此ID同步容器正常工作，必须将com_adobe_audience_manager.enabled设置为true。否则，将禁用Audience Manager服务。

com_adobe_target.enabled

定义是否将事件数据发送到Adobe Target。

com_adobe_target.propertyToken

Adobe Target目标资产的令牌。

com_adobe_audience_manager.enabled

定义是否将事件数据发送到Audience Manager服务。

com_adobe_launch_ssf

定义是否将事件数据发送到服务器端转发。

通过Web SDK `configure`命令发送配置覆盖 send-configure

以下示例显示 configure 命令中的配置覆盖的情况。