Configure datastream overrides

Use datastream overrides to define additional configurations for your datastreams, which get passed to the Edge Network via the Web SDK or Mobile SDK.

Trigger different datastream behaviors without creating a new datastream or modifying your existing settings.

Datastream configuration override is a two-step process:

This article explains the end-to-end datastream configuration override process for every type of supported override.

Use cases use-cases

The following use cases show how and when to use datastream overrides.

Multi-region data collection multi-region

A company has different websites or subdomains for different countries in which they operate. They have configured separate datastreams with corresponding analytics-specific report suites, country-specific Adobe Target property tokens, country-specific schemas, datasets, Journey Optimizer configurations, and so on. The company also has a global set of configurations where all country-specific data is aggregated.

By using datastream overrides, the company can dynamically switch the flow of data to different datastreams, instead of the default behavior of sending data to one datastream.

A common use case is sending data to a country-specific datastream and also to a global datastream when customers perform an important action, such as placing an order or updating their user profile.

Differentiating profiles and identities for different business units multiple-business-units

A company with multiple business units wants to use multiple Experience Platform sandboxes to store data specific to each business unit.

Instead of sending data to a default datastream, the company can use datastream overrides to make sure each business unit has its own datastream to receive data through.

Configure datastream overrides in the Datastreams UI configure-overrides

Datastream configuration overrides let you modify the following datastream configurations:

Datastream overrides for Adobe Target target-overrides

To configure datastream overrides for an Adobe Target datastream, you must first have an Adobe Target datastream created. Follow the instructions to configure a datastream with the Adobe Target service.

After creating the datastream, edit the Adobe Target service you added and use the Property Token Overrides section to add the desired datastream overrides. Add one property token per line.

After adding the desired overrides, save your datastream settings.

The Adobe Target datastream overrides are now configured. You can now send the overrides to the Edge Network via the Web SDK or Mobile SDK.

Datastream overrides for Adobe Analytics analytics-overrides

To configure datastream overrides for an Adobe Analytics datastream, you must first have an Adobe Analytics datastream created. Follow the instructions to configure a datastream with the Adobe Analytics service.

After creating the datastream, edit the Adobe Analytics service you added and use the Report Suite Overrides section to add the desired datastream overrides.

Select Show Batch Mode to enable batch editing of the report suite overrides. You can copy and paste a list of report suite overrides, entering one report suite per line.

After adding the desired overrides, save your datastream settings.

The Adobe Analytics datastream overrides are now configured. You can now send the overrides to the Edge Network via the Web SDK or Mobile SDK.

Datastream overrides for Experience Platform event datasets event-dataset-overrides

To configure datastream overrides for Experience Platform event datasets, you must first have an Adobe Experience Platform datastream created. Follow the instructions to configure a datastream with the Adobe Experience Platform service.

After creating the datastream, edit the Adobe Experience Platform service you added and select the Add Event Dataset option to add one or more override event datasets.

After adding the desired overrides, save your datastream settings.

The Adobe Experience Platform datastream overrides are now configured. You can now send the overrides to the Edge Network via the Web SDK or Mobile SDK.

Datastream overrides for third party ID sync containers container-overrides

To configure datastream overrides for third party ID sync containers, you must first have a datastream created. Follow the instructions to configure a datastream to create one.

After creating the datastream, go to Advanced Options and enable the Third Party ID Sync option.

Then, use the Container ID Overrides section to add the container IDs that you want to override the default setting.

After adding the desired overrides, save your datastream settings.

The ID sync container overrides are now configured. You can now send the overrides to the Edge Network via the Web SDK or Mobile SDK.

Send the overrides to the Edge Network send-overrides

After configuring datastream overrides in the Data Collection UI, you can send the overrides to the Edge Network through the Web SDK or Mobile SDK.

Payload example payload-example

The preceding examples generate an Edge Network payload similar to the one below.

{
  "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": [  ]
}