配置数据流覆盖

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

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

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

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

  1. 首先,必须在数据流UI中的数据流配置页面中定义数据流配置覆盖。 有关如何配置覆盖的说明,请参阅数据流配置覆盖文档。

  2. 在UI中配置数据流覆盖后,必须通过以下方式之一将覆盖发送到Edge Network:

    • 通过Web SDK 标记扩展
    • 通过sendEventconfigure Web SDK命令。
    • 通过Mobile SDK sendEvent命令。

如果在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标记扩展配置数据流覆盖,请在配置标记扩展时设置​ 数据流配置覆盖 ​下的每个所需字段。

  1. 使用您的Adobe ID凭据登录experience.adobe.com
  2. 导航到​ 数据收集 > 标记
  3. 选择所需的标记属性。
  4. 导航到​ 扩展,然后单击Adobe Experience Platform Web SDK卡片上的​ 配置
  5. 向下滚动到​ 数据流配置覆盖 ​部分。 设置每个所需的覆盖值。
  6. 单击​ 保存,然后发布更改。

如果只想为特定命令设置覆盖,请在标记规则的操作中设置每个所需字段。

  1. 使用您的Adobe ID凭据登录experience.adobe.com
  2. 导航到​ 数据收集 > 标记
  3. 选择所需的标记属性。
  4. 导航到​ 规则,然后选择所需的规则。
  5. 在操作下,选择现有操作或创建操作。
  6. 将扩展下拉字段设置为​ Adobe Experience Platform Web SDK,并将操作类型设置为​ 发送事件
  7. 向下滚动到标记为​ 数据流配置覆盖 ​的部分。
  8. 将此部分中的每个字段设置为所需的覆盖值。
  9. 单击​ 保留更改,然后运行发布工作流程。

为开发、暂存和生产环境提供了单独的字段。 确保为每个环境填写每个所需的字段。

通过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[]
一个字符串数组,它确定要将Analytics数据发送到哪些报表包。
com_adobe_identity.idSyncContainerId
要在Audience Manager中使用的第三方ID同步容器。
com_adobe_target.propertyToken
Adobe Target目标资产的令牌。

通过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[]
一个字符串数组,它确定要将Analytics数据发送到哪些报表包。
com_adobe_identity.idSyncContainerId
要在Audience Manager中使用的第三方ID同步容器。
com_adobe_target.propertyToken
Adobe Target目标资产的令牌。
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636