データストリームの上書きの設定

データストリームの上書きにより、データストリームの追加設定を定義できます。この設定は、Web SDK または Mobile SDK を介してEdge Networkーに渡されます。

これにより、データストリームを作成したり、既存のトリガーを変更したりせずに、デフォルトとは異なるデータストリームの動作を設定できます。

データストリーム設定の上書きは、次の 2 つの手順で行います。

この記事では、サポートされているすべてのタイプの上書きに対するエンドツーエンドのデータストリーム設定の上書きプロセスについて説明します。

ユースケース use-cases

データストリームの上書きを使用する方法および使用するタイミングをより深く理解するために、Adobe Experience Platform のお客様がこの機能を使用して解決できるユースケースを次に示します。

複数地域のデータ収集

会社は、事業を展開する国ごとに異なる web サイトまたはサブドメインを持っています。設定済みの個別のデータストリームには、対応する分析別のレポートスイート、国別の Adobe Target プロパティトークン、国別のスキーマ、データセット、Journey Optimizer 設定などがあります。また、会社は、国別のすべてのデータを集計するグローバルな設定も用意されています。

データストリームの上書きを使用すると、会社は、1 つのデータストリームにデータを送信するデフォルトの動作ではなく、異なるデータストリームにデータのフローを動的に切り替えることができます。

一般的なユースケースは、国固有のデータストリームや、顧客が注文やユーザープロファイルの更新などの重要なアクションを実行するグローバルデータストリームにデータを送信する場合もあります。

様々なビジネスユニットに対するプロファイルと ID の区別

複数のビジネスユニットを持つ会社が、複数のExperience Platformサンドボックスを使用して、各ビジネスユニットに固有のデータを保存したいと考えています。

会社は、デフォルトのデータストリームにデータを送信する代わりに、データストリームの上書きを使用して、各ビジネスユニットがデータを受け取るデータストリームを独自に持つようにすることができます。

データストリーム UI でのデータストリームの上書きの設定 configure-overrides

データストリーム設定の上書きを使用して、次のデータストリーム設定を変更できます。

Adobe Target のデータストリームの上書き target-overrides

Adobe Target データストリームのデータストリーム上書きを設定するには、まず Adobe Target のデータストリームを作成する必要があります。手順に従って、Adobe Target サービスでデータストリームを設定します。

データストリームを作成したら、追加した Adobe Target サービスを編集し、「プロパティトークンの上書き」セクションを使用して、目的のデータストリームの上書きを追加します（下図を参照）。 1 行につき 1 つのプロパティトークンを追加します。

必要な上書きを追加したら、データストリーム設定を保存します。

これで、Adobe Target のデータストリームの上書きが設定されました。これで Web SDK または Mobile SDK を介してEdge Networkに上書きを送信できます。

Adobe Analytics のデータストリームの上書き analytics-overrides

Adobe Analytics のデータストリームの上書きを設定するには、まず、Adobe Analytics データストリームを作成する必要があります。手順に従って、Adobe Analytics サービスでデータストリームを設定します。

データストリームを作成したら、追加した Adobe Analytics サービスを編集し、「レポートスイートの上書き セクションを使用して、必要なデータストリームの上書きを追加します（下図を参照）。

「バッチモードを表示」を選択して、レポートスイートの上書きのバッチ編集を有効にします。1 行に 1 つのレポートスイートを入力して、レポートスイートの上書きのリストをコピー＆ペーストできます。

必要な上書きを追加したら、データストリーム設定を保存します。

これで、Adobe Analytics データストリームの上書きが設定されました。これで Web SDK または Mobile SDK を介してEdge Networkに上書きを送信できます。

Experience Platform イベントデータセットのデータストリームの上書き event-dataset-overrides

Experience Platform イベントデータセットのデータストリームの上書きを設定するには、まず Adobe Experience Platform データストリームを作成する必要があります。手順に従って、Adobe Experience Platform サービスでデータストリームを設定します。

データストリームを作成したら、追加した Adobe Experience Platform サービスを編集し、「イベントデータセットを追加」オプションを選択して、1 つ以上の上書きイベントデータセットを追加します（下図を参照）。

必要な上書きを追加したら、データストリーム設定を保存します。

これで、Adobe Experience Platform データストリームの上書きが設定されました。これで Web SDK または Mobile SDK を介してEdge Networkに上書きを送信できます。

サードパーティ ID 同期コンテナのデータストリームの上書き container-overrides

サードパーティの ID 同期コンテナに対してデータストリームの上書きを設定するには、まずデータストリームを作成する必要があります。手順に従って、データストリームを設定して作成します。

データストリームを作成したら、詳細オプション ​に移動し、「サードパーティ ID の同期」オプションを有効にします。

次に、以下の画像に示すように、「コンテナ ID の上書き」セクションを使用して、デフォルト設定を上書きするコンテナ ID を追加します。

必要な上書きを追加したら、データストリーム設定を保存します。

これで、ID 同期コンテナの上書きが設定されました。これで Web SDK または Mobile SDK を介してEdge Networkに上書きを送信できます。

上書きをEdge Networkに送信 send-overrides

データ収集 UI でデータストリームの上書きを設定した後、Web SDK または Mobile SDK を通じてEdge Networkに上書きを送信できます。

ペイロードの例 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": [  ]
}