データストリームの上書きの設定
データストリームの上書きにより、データストリームの追加設定を定義できます。この設定は、Web SDKまたはモバイル SDKを介してEdge Networkに渡されます。
これにより、データストリームを作成したり、既存のトリガーを変更したりせずに、デフォルトとは異なるデータストリームの動作を設定できます。
データストリーム設定の上書きは、次の 2 つの手順で行います。
-
最初に、 データストリーム設定ページ でデータストリーム設定の上書きを定義する必要があります。
-
次に、以下のいずれかの方法で、上書きをEdge Networkに送信する必要があります。
sendEvent
またはconfigure
の Web SDK コマンドを使用します。- Web SDK タグ拡張機能 を使用する。
- Mobile SDK sendEvent API を使用するか、Rules を使用する。
この記事では、サポートされているすべてのタイプの上書きに対するエンドツーエンドのデータストリーム設定の上書きプロセスについて説明します。
異なるデータストリームに異なるデータを送信する必要がある場合は、データストリームの上書きを使用する必要があります。パーソナライゼーションのユースケースや同意データに対してデータストリームの上書きを使用しない。
ユースケース 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 サービスを編集し、「プロパティトークンの上書き」セクションを使用して、目的のデータストリームの上書きを追加します(下図を参照)。 1 行につき 1 つのプロパティトークンを追加します。
必要な上書きを追加したら、データストリーム設定を保存します。
これで、Adobe Target のデータストリームの上書きが設定されました。これで Web SDKまたはモバイル SDKを介してEdge Networkに上書きを送信 できます。
Adobe Analytics のデータストリームの上書き analytics-overrides
Adobe Analytics のデータストリームの上書きを設定するには、まず、Adobe Analytics データストリームを作成する必要があります。手順に従って、Adobe Analytics サービスでデータストリームを設定します。
データストリームを作成したら、追加した Adobe Analytics サービスを編集し、「レポートスイートの上書き セクションを使用して、必要なデータストリームの上書きを追加します(下図を参照)。
「バッチモードを表示」を選択して、レポートスイートの上書きのバッチ編集を有効にします。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 サービスを編集し、「イベントデータセットを追加」オプションを選択して、1 つ以上の上書きイベントデータセットを追加します(下図を参照)。
必要な上書きを追加したら、データストリーム設定を保存します。
これで、Adobe Experience Platform データストリームの上書きが設定されました。これで Web SDKまたはモバイル SDKを介してEdge Networkに上書きを送信 できます。
サードパーティ ID 同期コンテナのデータストリームの上書き container-overrides
サードパーティの ID 同期コンテナに対してデータストリームの上書きを設定するには、まずデータストリームを作成する必要があります。手順に従って、データストリームを設定して作成します。
データストリームを作成したら、詳細オプション に移動し、「サードパーティ ID の同期」オプションを有効にします。
次に、以下の画像に示すように、「コンテナ ID の上書き」セクションを使用して、デフォルト設定を上書きするコンテナ ID を追加します。
"1234567"
などの文字列ではなく、1234567
のような数値である必要があります。Web SDK を介してコンテナ ID の上書きとして文字列値を送信した場合、エラーが表示されます。
必要な上書きを追加したら、データストリーム設定を保存します。
これで、ID 同期コンテナの上書きが設定されました。これで Web SDKまたはモバイル SDKを介してEdge Networkに上書きを送信 できます。
上書きをEdge Networkに送信 send-overrides
データ収集 UI でデータストリームの上書きを設定した後、Web SDKまたは Mobile SDKを使用して、上書きをEdge Networkに送信できます。
- Web SDK:タグ拡張手順およびJavaScript ライブラリコードの例については、 データストリーム設定の上書き を参照してください。
- モバイルSDK:データストリーム ID の上書きは、sendEvent API または Rules を使用して送信できます。
ペイロードの例 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": [ ]
}