データストリームの上書きの設定
データストリームの上書きを使用して、データストリームの追加の設定を定義します。この設定は、Web SDKまたはモバイルSDKを介してEdge Networkに渡されます。
これにより、データストリームを作成したり、既存のトリガーを変更したりすることなく、デフォルトのデータストリームとは異なるデータストリーム動作を設定できます。
データストリーム設定の上書きは、次の2つの手順で行います。
-
まず、 データストリーム設定ページ でデータストリーム設定の上書きを定義する必要があります。
-
次に、次のいずれかの方法でEdge Networkにオーバーライドを送信する必要があります。
この記事では、サポートされているすべてのタイプの上書きに対するエンドツーエンドのデータストリーム設定の上書きプロセスについて説明します。
異なるデータストリームに異なるデータを送信する必要がある場合は、データストリームの上書きを使用する必要があります。パーソナライゼーションのユースケースや同意データにデータストリームの上書きを使用しないでください。
ユースケース use-cases
データストリームの上書きを使用する方法および使用するタイミングをより深く理解するために、Adobe Experience Platform のお客様がこの機能を使用して解決できるユースケースを次に示します。
複数地域のデータ収集
会社は、事業を展開する国ごとに異なる web サイトまたはサブドメインを持っています。設定済みの個別のデータストリームには、対応する分析別のレポートスイート、国別の Adobe Target プロパティトークン、国別のスキーマ、データセット、Journey Optimizer 設定などがあります。また、会社は、国別のすべてのデータを集計するグローバルな設定も用意されています。
データストリームの上書きを使用すると、会社は、1 つのデータストリームにデータを送信するデフォルトの動作ではなく、異なるデータストリームにデータのフローを動的に切り替えることができます。
一般的なユースケースとしては、国別のデータストリームや、顧客が注文やユーザープロファイルの更新などの重要なアクションを実行するグローバルデータストリームにデータを送信することが考えられます。
様々なビジネスユニットに対するプロファイルと ID の区別
複数の事業部門を持つ企業は、複数の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 サービスを編集し、Property Token Overrides セクションを使用して、次の図に示すように、目的のデータストリームオーバーライドを追加します。 1 行につき 1 つのプロパティトークンを追加します。
必要な上書きを追加したら、データストリーム設定を保存します。
これで、Adobe Target のデータストリームの上書きが設定されました。これで、Web SDKまたはモバイル SDKを介してEdge Networkに上書きを送信できます。
Adobe Analytics のデータストリームの上書き analytics-overrides
Adobe Analytics のデータストリームの上書きを設定するには、まず、Adobe Analytics データストリームを作成する必要があります。手順に従って、Adobe Analytics サービスでデータストリームを設定します。
データストリームを作成したら、追加したAdobe Analytics サービスを編集し、Report Suite Overrides セクションを使用して、次の図に示すように、目的のデータストリームオーバーライドを追加します。
レポートスイートの上書きのバッチ編集を有効にするには、Show Batch Modeを選択します。 1 行に 1 つのレポートスイートを入力して、レポートスイートの上書きのリストをコピー&ペーストできます。
必要な上書きを追加したら、データストリーム設定を保存します。
これで、Adobe Analytics データストリームの上書きが設定されました。これで、Web SDKまたはモバイル SDKを介してEdge Networkに上書きを送信できます。
Experience Platform イベントデータセットのデータストリームの上書き event-dataset-overrides
Experience Platform イベントデータセットのデータストリームの上書きを設定するには、まず Adobe Experience Platform データストリームを作成する必要があります。手順に従って、Adobe Experience Platform サービスでデータストリームを設定します。
データストリームを作成したら、追加したAdobe Experience Platform サービスを編集し、Add Event Dataset オプションを選択して、次の図に示すように、1つ以上のオーバーライドイベントデータセットを追加します。
必要な上書きを追加したら、データストリーム設定を保存します。
これで、Adobe Experience Platform データストリームの上書きが設定されました。これで、Web SDKまたはモバイル SDKを介してEdge Networkに上書きを送信できます。
サードパーティ ID 同期コンテナのデータストリームの上書き container-overrides
サードパーティの ID 同期コンテナに対してデータストリームの上書きを設定するには、まずデータストリームを作成する必要があります。手順に従って、データストリームを設定して作成します。
データストリームを作成したら、Advanced Optionsに移動し、Third Party ID Sync オプションを有効にします。
次に、Container ID Overrides セクションを使用して、次の画像に示すように、デフォルト設定を上書きするコンテナ IDを追加します。
"1234567" などの文字列ではなく、1234567 のような数値である必要があります。Web SDK を介してコンテナ ID の上書きとして文字列値を送信した場合、エラーが表示されます。
必要な上書きを追加したら、データストリーム設定を保存します。
これで、ID 同期コンテナの上書きが設定されました。これで、Web SDKまたはモバイル SDKを介してEdge Networkに上書きを送信できます。
Edge Networkにオーバーライドを送信する send-overrides
データ収集UIでデータストリームのオーバーライドを設定した後、Web SDKまたはモバイルSDKを介してEdge Networkにオーバーライドを送信できます。
- Web SDK: JavaScript ライブラリのコード例については、 データストリーム設定の上書きを参照してください。
- モバイル SDK: sendEvent APIを使用するか、 ルール を使用して、データストリーム IDの上書きを送信できます。
ペイロードの例 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": [ ]
}