文档Experience Platform数据流指南

配置数据流覆盖

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

创建对象：

  • Developer

数据流覆盖允许您为数据流定义其他配置，这些配置通过 Web SDK 传递到 Edge Network。

这有助于触发与默认数据流行为不同的数据流行为，而无需创建数据流或修改现有设置。

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

  1. 首先，您必须在以下位置定义数据流配置覆盖 数据流配置页面.

  2. 然后，您必须通过以下方式之一将覆盖发送到Edge Network：

本文介绍每种受支持的覆盖的端到端数据流配置覆盖过程。

IMPORTANT
数据流覆盖仅支持 Web SDK 和 移动SDK 集成。 服务器API 集成当前不支持数据流覆盖。


在需要将不同的数据发送到不同的数据流时应使用数据流覆盖。请勿对个性化用例或同意数据使用数据流覆盖。

用例 use-cases

为了帮助您更好地了解如何以及何时使用数据流覆盖，以下是 Adobe Experience Platform 客户可使用此功能解决的一些用例。

多区域数据收集

一家公司对于其开展经营的不同国家/地区拥有不同的网站或子域。其中配置了单独的数据流，这些数据流具有相应的 Analytics 特有的报表包、国家/地区特有的 Adobe Target 属性令牌、国家/地区特有的架构、数据集、Journey Optimizer 配置等等。该公司还有一套全球配置，其中汇集所有国家/地区特有的数据。

通过使用数据流覆盖，该公司可动态地将数据的流动切换到不同的数据流，取代将数据发送到一个数据流的默认行为。

一个常见的使用案例可能是将数据发送到特定于国家/地区的数据流，也发送到客户在其中执行重要操作（如下订单或更新其用户配置文件）的全球数据流。

为不同的业务部门区分配置文件和标识

具有多个业务部门的公司希望使用多个Experience Platform沙盒来存储特定于每个业务部门的数据。

该公司可使用数据流覆盖确保每个业务部门都有自己的数据流以通过它接收数据，而非将数据发送到默认数据流。

在数据流 UI 中配置数据流覆盖 configure-overrides

数据流配置覆盖允许您修改以下数据流配置：

  • Experience Platform 事件数据集
  • Adobe Target 属性令牌
  • Audience Manager ID 同步容器
  • Adobe Analytics 报告包

Adobe Target 的数据流覆盖 target-overrides

要为 Adobe Target 数据流配置数据流覆盖，您必须首先创建 Adobe Target 数据流。按照说明进行操作，使用 Adobe Target 服务配置数据流。

创建数据流后，编辑 Adobe Target 您已添加并使用 资产令牌覆盖 部分来添加所需的数据流覆盖，如下图所示。 每行添加一个属性令牌。

数据流 UI 屏幕快照，显示了 Adobe Target 服务设置，并突出显示了属性令牌覆盖。

添加所需覆盖后，保存数据流设置。

您现在应已配置 Adobe Target 数据流覆盖。现在，您可以通过 Web SDK 将覆盖发送到 Edge Network。

Adobe Analytics 的数据流覆盖 analytics-overrides

要为 Adobe Analytics 数据流配置数据流覆盖，您必须首先创建 Adobe Analytics 数据流。按照说明进行操作，使用 Adobe Analytics 服务配置数据流。

创建数据流后，编辑 Adobe Analytics 您已添加并使用 报表包覆盖 部分来添加所需的数据流覆盖，如下图所示。

选择​ 显示批处理模式 ​可启用报告包覆盖的批量编辑。您可以复制并粘贴报告包覆盖列表，每行输入一个报告包。

数据流 UI 屏幕快照，显示了 Adobe Analytics 服务设置，并突出显示了报告包覆盖。

添加所需覆盖后，保存数据流设置。

您现在应已配置 Adobe Analytics 数据流覆盖。现在，您可以通过 Web SDK 将覆盖发送到 Edge Network。

Experience Platform 事件数据集的数据流覆盖 event-dataset-overrides

要为 Experience Platform 事件数据集配置数据流覆盖，您必须首先创建 Adobe Experience Platform 数据流。按照说明进行操作，使用 Adobe Experience Platform 服务配置数据流。

创建数据流后，编辑 Adobe Experience Platform 已添加的服务并选择 添加事件数据集 用于添加一个或多个覆盖事件数据集的选项，如下图所示。

数据流 UI 屏幕快照，显示了 Adobe Experience Platform 服务设置，并突出显示了事件数据集覆盖。

添加所需覆盖后，保存数据流设置。

您现在应已配置 Adobe Experience Platform 数据流覆盖。现在，您可以通过 Web SDK 将覆盖发送到 Edge Network。

第三方 ID 同步容器的数据流覆盖 container-overrides

要为第三方 ID 同步容器配置数据流覆盖，您必须首先创建数据流。按照说明进行操作，配置数据流以创建一个数据流。

创建数据流后，请转到​ 高级选项 ​并启用​ 第三方 ID 同步 ​选项。

然后，使用​ 容器 ID 覆盖 ​部分添加要覆盖默认设置的容器 ID，如下图所示。

IMPORTANT
容器 ID 必须是数值，例如 1234567，而不是字符串，例如 "1234567"。如果您通过 Web SDK 发送字符串值作为容器 ID 覆盖，您将收到错误。

数据流 UI 屏幕快照，显示了数据流设置，并突出显示了第三方 ID 同步容器覆盖。

添加所需覆盖后，保存数据流设置。

您现在应已配置 ID 同步容器覆盖。现在，您可以通过 Web SDK 将覆盖发送到 Edge Network。

通过 Web SDK 将覆盖发送到 Edge Network send-overrides-web-sdk

在数据收集UI中配置数据流覆盖后，您可以通过Web SDK或移动SDK将覆盖发送到Edge Network。

  • Web SDK：请参阅 数据流配置覆盖 有关标记扩展说明和JavaScript库代码示例。
  • 移动SDK：请参阅下文。

通过移动SDK覆盖数据流ID id-override-mobile

以下示例显示了数据流ID覆盖在Mobile SDK集成中可能显示的内容。 选择下面的选项卡以查看 iOS 和 Android 示例。

iOS (Swift)

此示例显示数据流ID覆盖在Mobile SDK中会是什么样子 iOS 集成。

code language-swift 
// Create Experience event from dictionary
var xdmData: [String: Any] = [
  "eventType": "SampleXDMEvent",
  "sample": "data",
]
let experienceEvent = ExperienceEvent(xdm: xdmData, datastreamIdOverride: "SampleDatastreamId")

Edge.sendEvent(experienceEvent: experienceEvent) { (handles: [EdgeEventHandle]) in
  // Handle the Edge Network response
}
Android™ (Kotlin)

此示例显示数据流ID覆盖在Mobile SDK中会是什么样子 Android 集成。

code language-kotlin 
// Create experience event from Map
val xdmData = mutableMapOf < String, Any > ()
xdmData["eventType"] = "SampleXDMEvent"
xdmData["sample"] = "data"

val experienceEvent = ExperienceEvent.Builder()
    .setXdmSchema(xdmData)
    .setDatastreamIdOverride("SampleDatastreamId")
    .build()

Edge.sendEvent(experienceEvent) {
    // Handle the Edge Network response
}

通过Mobile SDK覆盖数据流配置 config-override-mobile

以下示例显示了数据流配置覆盖在Mobile SDK集成上可能显示的内容。 选择下面的选项卡以查看 iOS 和 Android 示例。

iOS (Swift)

此示例显示数据流配置覆盖在Mobile SDK中看起来是什么样子 iOS 集成。

code language-swift 
// Create Experience event from dictionary
var xdmData: [String: Any] = [
  "eventType": "SampleXDMEvent",
  "sample": "data",
]

let configOverrides: [String: Any] = [
  "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"
 ],
]

let experienceEvent = ExperienceEvent(xdm: xdmData, datastreamConfigOverride: configOverrides)

Edge.sendEvent(experienceEvent: experienceEvent) { (handles: [EdgeEventHandle]) in
  // Handle the Edge Network response
}
Android (Kotlin)

此示例显示数据流配置覆盖在Mobile SDK中看起来是什么样子 Android 集成。

code language-kotlin 
// Create experience event from Map
val xdmData = mutableMapOf < String, Any > ()
xdmData["eventType"] = "SampleXDMEvent"
xdmData["sample"] = "data"

val configOverrides = mapOf(
    "com_adobe_experience_platform"
    to mapOf(
        "datasets"
        to mapOf(
            "event"
            to mapOf("datasetId"
                to "SampleEventDatasetIdOverride")
        )
    ),
    "com_adobe_analytics"
    to mapOf(
        "reportSuites"
        to listOf(
            "MyFirstOverrideReportSuite",
            "MySecondOverrideReportSuite",
            "MyThirdOverrideReportSuite"
        )
    ),
    "com_adobe_identity"
    to mapOf(
        "idSyncContainerId"
        to "1234567"
    ),
    "com_adobe_target"
    to mapOf(
        "propertyToken"
        to "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
    )
)

val experienceEvent = ExperienceEvent.Builder()
    .setXdmSchema(xdmData)
    .setDatastreamConfigOverride(configOverrides)
    .build()

Edge.sendEvent(experienceEvent) {
    // Handle the Edge Network response
}

负载示例 payload-example

上述示例会生成 Edge Network 有效负载类似于以下有效负载。

{
  "meta": {
    "configOverrides": {
      "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"
      }
    },
    "state": {  }
  },
  "events": [  ]
}
recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac