動的データストリーム設定の作成
デフォルトでは、Experience Platform Edge Networkは、データストリームにリーチするすべてのイベントを、データストリームに対して有効にしたすべてのExperience Cloud サービス に送信します。 ユースケースによっては、必ずしも理想的なワークフローではない可能性があります。
動的データストリーム設定では、データストリームに対して有効な各サービスに対して定義する、ユーザーが設定できる一連のルールを通じて、この懸念に対処します。このルールは、Experience Cloud ソリューションが各タイプのデータを受け取る必要がある内容を決定します。
前提条件 prerequisites
データストリームの動的設定を作成するには、次の2つの条件を満たす必要があります。
- 少なくとも個のデータストリームを作成しておく必要があります。 詳しくは、 データストリームの作成方法に関するドキュメントを参照してください。
- データストリームに 少なくとも 個のExperience Cloud サービスを追加する必要があります。 詳しくは、 データストリームにサービス を追加する方法に関するドキュメントを参照してください。
データストリームを作成してExperience Cloud サービスを追加したら、次に動的設定を作成できます。
ガードレール guardrails
動的データストリーム設定には、最適なシステムパフォーマンスとデータ処理効率を確保するために、特定の制限とパフォーマンスの制約があります。 動的データストリームルールを設定する場合は、次のガードレールが適用されます。
動的データストリーム設定とデータストリーム設定の上書き dynamic-versus-overrides
動的データストリーム設定と データストリーム設定オーバーライド は、相互に排他的な機能です。
つまり、動的データストリーム設定をデータストリーム設定のオーバーライドと共に使用することはできません。 どちらか一方を選ばなければなりません。
動的データストリーム設定とデータストリーム設定の上書きの両方を有効にすると、設定の上書きが優先され、動的データストリーム設定ルールは無視されます。
動的データストリーム設定の作成 create-dynamic-configuration
データストリーム を作成し、 サービス を追加した後、次の手順に従ってサービスに動的設定を追加します。
-
Data Collection > Datastreams ページに移動し、作成したデータストリームを選択します。
-
動的設定を定義するサービスのEdit オプションを選択します。
-
Configure ページで、Save and Edit Dynamic Configurationを選択します。
-
Add Dynamic Configuration を選択します。
-
Resources パネルから、ルールを作成するアイテムをウィンドウの右側にドラッグ&ドロップします。 複数のリソースを組み合わせて、複雑なルールを構築できます。
各リソースのオプション（equals、does not equal、existsなど）を使用して、ルールを微調整します。
-
「Configuration」セクションで、データを各サービスに送信するかどうかに応じて、各ルールに対して有効または無効にするサービスを切り替えます。 トグルをオフにすると、サービスのルーティングが無効になり、データがダウンストリーム サービスに送信されません。
-
ルールの設定が完了したら、Saveを選択します。
ルールの優先度に関する考慮事項 considerations
動的データストリーム設定ごとに複数のルールを定義できます。 ただし、データが複数のルールの条件に一致する場合、リストの最初の一致するルールのみが考慮され、他のすべての一致するルールは無視されます。
目的のデータルーティング動作を実現するには、ルールを配置する順序に注意してください。
ルールの順序を設定するには、ルールウィンドウを目的の順序でドラッグ&ドロップします。
ドラッグ&ドロップでルールの順序を変更する方法を示す
ルールの適格性の基準 eligibility-criteria
動的データストリームの設定は、高いパフォーマンス、メンテナンス性、明瞭性を確保するために、特定の適格性基準を満たす必要があります。 ルールを定義するための主な要件とベストプラクティスを以下に示します。
サポートされているデータタイプ supported-data-types
動的データストリーム設定ルールは、特定のデータタイプと連携して、最適なパフォーマンスと信頼性の高いデータルーティングを実現します。 サポートされているデータタイプを把握することで、データを効率的に処理するための効果的なルールを作成できます。
サポートされている演算子 supported-operators
ルールでは、データ型に応じて次の演算子を使用できます。
equals, starts with, ends with, contains, exists, does not equal, does not start with, does not end with, does not contain, does not existequals、does not equal、greater than、less than、greater than or equal to、less than or equal to、exists、does not existequals true/false, does not equal true/falseequals、does not equal、exists、does not existtoday, yesterday, this month, this year, custom date, in last, from, during, within, before, after, rolling range, in next, exists, does not existINCLUDE, ANY/ALL （AND/ORと同等）ルール構造 rule-structure
動的データストリーム設定のルールを作成する場合は、最適なパフォーマンスとシステムの互換性を確保するための構造要件を理解することが重要です。 ルール構造は、データを処理し、システム内をルーティングする効率に直接影響します。
フラット式のみを使用。 ルールをフラットな論理式として定義する必要があります。 ネストされた論理式（コンテナまたは複数レベルのAND/ORを使用）はサポートされていません。 複雑なロジックが必要な場合は、それを複数のフラットルールに分割します。
例えば、次の画像に示す複雑なルールを考えてみましょう。
複雑なルールを示す
このルールは、次のシンプルなルールに分割できます。
2番目の簡略化されたルールを示す
複雑なルールを避ける。 シンプルなルールにより、評価を迅速化し、メンテナンス性を向上できます。
ベストプラクティス best-practices
動的データストリーム設定ルールを作成する際のベストプラクティスに従うことで、最適なパフォーマンス、システムの信頼性、および保守に適した設定を実現できます。 これらのガイドラインは、陥りがちな落とし穴を回避し、プラットフォームのアーキテクチャとシームレスに連携する効率的なルールを構築するのに役立ちます。