動的データストリーム設定の作成

デフォルトでは、Adobe Experience Platform Edge Networkは、データストリームに到達するすべてのイベントを、データストリームに対して有効にしたすべてのExperience Cloud ​ サービス ​に送信します。 ユースケースによっては、これが必ずしも理想的なワークフローであるとは限りません。

動的データストリーム設定では、データストリームに対して有効になっている各サービスに対して定義する一連のルールを使用して、これに対応します。このルールは、各タイプのデータを受信するExperience Cloud ソリューションを制御します。

前提条件 prerequisites

データストリームの動的設定を作成するには、次の2つの条件を満たす必要があります。

  • 少なくとも​個のデータストリームを作成しておく必要があります。 詳しくは、​ データストリームの作成方法に関するドキュメントを参照してください。
  • データストリームに​ 少なくとも ​個のExperience Cloud サービスを追加する必要があります。 詳しくは、​ データストリームにサービス ​を追加する方法に関するドキュメントを参照してください。

データストリームを作成してExperience Cloud サービスを追加したら、次に動的設定を作成できます

ガードレール guardrails

動的データストリーム設定には、最適なシステムパフォーマンスとデータ処理効率を確保するために、特定の制限とパフォーマンスの制約があります。 動的データストリームルールを設定する場合は、次のガードレールが適用されます。

ガードレール
上限
制限タイプ
Experience Platform サービスのデータストリームごとの動的データストリーム設定の最大数
5
パフォーマンスガードレール
イベント転送用データストリームごとの動的データストリーム設定の最大数
5
パフォーマンスガードレール
Adobe Analyticsのデータストリームごとの動的データストリーム設定の最大数
5
パフォーマンスガードレール
Adobe Targetのデータストリームごとの動的データストリーム設定の最大数
5
パフォーマンスガードレール
Adobe Audience Managerのデータストリームごとの動的データストリーム設定の最大数
5
パフォーマンスガードレール
1つのルール内で結合できる条件(述語)の最大数
100
パフォーマンスガードレール
タイムアウトする前に、データストリームごとにすべての動的データストリーム設定を評価するために許可される最大時間
25 ミリ秒
システム強制ガードレール

動的データストリーム設定とデータストリーム設定の上書き dynamic-versus-overrides

動的データストリーム設定と​ データストリーム設定オーバーライド ​は、相互に排他的な機能です。

動的データストリーム設定をデータストリーム設定のオーバーライドと共に使用することはできません。 どちらか一方を選ばなければなりません。

両方を有効にすると、設定の上書きが優先され、システムは動的データストリーム設定ルールを無視します。

動的データストリーム設定の作成 create-dynamic-configuration

​ データストリーム ​を作成し、​ サービス ​を追加した後、次の手順に従ってサービスに動的設定を追加します。

  1. Data Collection > Datastreams ページに移動し、作成したデータストリームを選択します。

    データストリームのリストを表示するデータストリームのユーザーインターフェイス。

  2. 動的設定を定義するサービスの​Edit オプションを選択します。

    データストリームに追加されたサービスを表示するデータストリームのユーザーインターフェイス。

  3. Configure ページで、Save and Edit Dynamic Configuration​を選択します。

    データストリーム設定ページを表示するデータストリームのユーザーインターフェイス。

  4. Add Dynamic Configuration を選択します。

    ルールが追加される前に、動的設定ページを表示するデータストリームのユーザーインターフェイス。

  5. Resources パネルから、ルールを作成するアイテムをウィンドウの右側にドラッグ&ドロップします。 複数のリソースを組み合わせて、複雑なルールを構築できます。

    各リソースのオプション(equalsdoes not equalexists​など)を使用して、ルールを微調整します。

    リソースがドラッグされている動的設定ルールビルダーを表示するデータストリームのユーザーインターフェイス。

  6. Configuration」セクションで、データを各サービスに送信するかどうかに応じて、各ルールのサービスを有効または無効にします。 サービスを無効にすると、ルーティングは無効になり、データはダウンストリームサービスに送信されません

    サービスの切り替えを含む動的設定ルールを表示するデータストリームのユーザーインターフェイス。

  7. ルールの設定が完了したら、Save​を選択します。

ルールの優先度に関する考慮事項 rule-priority

動的データストリーム設定ごとに複数のルールを定義できます。 ただし、データが複数のルールの条件に一致する場合、リストの最初の一致するルールのみが考慮され、他のすべての一致するルールは無視されます。

目的のデータルーティング動作を実現するには、ルールを配置する順序に注意してください。

ルールの順序を設定するには、ルールウィンドウを目的の順序でドラッグ&ドロップします。

ドラッグドロップを使用した動的データストリームルールの並べ替え

ルールの適格性の基準 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 exist
数値(長、整数、短、バイト)
equalsdoes not equalgreater thanless thangreater than or equal toless than or equal toexistsdoes not exist
ブール値
equals true/false, does not equal true/false
列挙
equalsdoes not equalexistsdoes not exist
日付
today, yesterday, this month, this year, custom date, in last, from, during, within, before, after, rolling range, in next, exists, does not exist
論理
INCLUDE, ANY/ALL (AND/ORと同等)
NOTE
EXCLUDE​演算子は直接サポートされていませんが、INCLUDE​を使用して、否定的な比較演算子を使用して同等のロジックを実現できます(例:「次と等しくない」)。

ルール構造 rule-structure

動的データストリーム設定のルールを作成する場合は、最適なパフォーマンスとシステムの互換性を確保するための構造要件を理解することが重要です。 ルール構造は、データを処理し、システム内をルーティングする効率に直接影響します。

フラット式のみを使用。 ルールをフラットな論理式として定義する必要があります。 ネストされた論理式(AND/ORのコンテナまたは複数レベルを使用)はサポートされていません。 複雑なロジックが必要な場合は、それを複数のフラットルールに分割します。

例えば、次のような複雑なルールを考えてみましょう。

複数のAND/OR条件を持つネストされた複雑なルールの例。

このルールは、次のシンプルなルールに分割できます。

最初の単純化されたルール。ネストされた複雑なルールを置き換えます。

2番目の単純化されたルール。ネストされた複雑なルールを置き換えます。

複雑なルールを避ける。 シンプルなルールにより、評価を迅速化し、メンテナンス性を向上できます。

ベストプラクティス best-practices

動的データストリーム設定ルールを作成する際のベストプラクティスに従うことで、最適なパフォーマンス、システムの信頼性、および保守に適した設定を実現できます。 これらのガイドラインは、陥りがちな落とし穴を回避し、プラットフォームのアーキテクチャとシームレスに連携する効率的なルールを構築するのに役立ちます。

  • ルールをシンプルかつフラットに保つ。 複雑なロジックを表現する必要がある場合は、ネストするのではなく複数のルールを使用します。
  • サポートされているデータ型🔗演算子のみを使用
  • ルールのパフォーマンスをテストします。 過度に複雑なルールやサポートされていないルールは、システムがそれらを拒否したり、システムのパフォーマンスに影響を与えたりする可能性があります。
recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac