Dynamic Datastream Configurationsのベストプラクティス
Dynamic Datastream Configuration ルールを設計および操作する場合は、これらの方法を使用します。 システムガードレール の管理、よくある間違いの回避、理解しやすくトラブルシューティングしやすい設定の維持に役立ちます。
ルールデザイン rule-design
イベントソースごとに個別のデータストリームを使用します。 Web SDK用のデータストリーム、モバイルSDK用のデータストリーム、およびServer API用のデータストリームを1つ作成することを検討してください。 データが別のソースから取得されている場合や、別のXDM スキーマを使用している場合は、別のデータストリームを作成します。 専用のデータセットを持つ専用のデータストリームは、トレーサビリティを向上させ、トラブルシューティングを簡素化します。 動的データストリーム設定ルールは、各データストリーム内のルーティングを処理します。
ルールをシンプルかつフラットに保つ。 動的データストリーム設定では、ネストされた論理式はサポートされていません。 ロジックにネストが必要な場合は、複数のフラットルールに分割します。 単純なルールほど評価が早く、監査が簡単で、予期しない一致が発生する可能性が低くなります。
主な条件としてeventTypeを使用します。 eventTypeは、ルーティング決定に最も信頼性が高く、パフォーマンスも高い識別情報です。 Web SDK、モバイルSDK、サーバーAPIの実装をまたいで一貫してデータが入力され、値のセットが明確に定義されています。 ほぼすべてのユースケースは、eventType ベースの条件で開始し、必要に応じて二次条件と組み合わせる必要があります。
優先度別のルールの注文:最初に消込可能、次に実行可能、次に分析可能。 Edge Networkでは最初のマッチウィン評価を使用するため、ルールの順序によって、複数の条件に一致する可能性のあるイベントの結果が決まります。
おすすめの注文:
- ボットトラフィック:消耗品または強制隔離
- システムイベント (
decisioning.propositionFetch,personalization.request):強制隔離 - 実用的な イベント:プロファイルが有効なデータセットにルーティングします
- Analytical イベント:プロファイル以外のデータセットにルーティングします
Expendable ルールを最初に配置すると、プロファイルの取り込みやインバウンドパーソナライズなど、コストのかかるルーティング決定を行う前に、Edge Networkが有害なトラフィックまたは運用上のトラフィックを取得します。
既定のルートを保守的に設計します。 データストリームのデフォルトのAdobe Experience Platform イベントデータセットを、プロファイルが有効でないデータセットに設定します。 予期しないイベントや未分類のイベントは、プロファイルストアを膨らませるのではなく、データレイクに入ります。 新しく検出されたイベントタイプを分類したら、いつでも特定のルールを追加して、プロファイルにプロモートできます。
データセット戦略 dataset-strategy
ルールを設定する前にデータセットを作成します。 すべてのターゲットデータセットは、ルーティング設定で参照する前に正しいスキーマが存在する必要があります。 Assuranceを使用してルールを検証したら、プロファイルを有効にし、データ保持を設定し、Customer Journey Analytics接続を更新します。
データ保持の設定ガイダンスについては、 エクスペリエンスイベント データセット保持ガイド を参照してください。
一貫した命名規則を使用します。 明確なデータセット名は、設定を確認したり、取り込みを監視したりする際に、各データセットの目的を容易に特定するのに役立ちます。 推奨パターン:
[Brand] Web Events - Profile (90d)[Brand] Web Events - Analytics (12mo)[Brand] Bot Traffic - Quarantine (30d)[Brand] System Events - Quarantine (30d)
データセット戦略に合わせてCustomer Journey Analytics接続を調整します。 Dynamic Datastream Configuration ルールとイベントを個別のデータセットにルーティングするように設定した後、レポートで使用するデータセットのみを含めるようにCustomer Journey Analytics接続を更新します。 ボットトラフィックとシステムイベントの強制隔離データセットを除外します。 詳しくは、Customer Journey Analytics接続ドキュメント を参照してください。
業務慣行 operational
変更を反映するには15分かかります。 新しいDynamic Datastream Configuration ルールや更新された ルールなどのデータストリーム設定の変更は、Edge Network全体に反映するのに最大15分かかります。 変更を保存した直後にテストを行わないでください。 Assurance セッションを実行するか、データセット取り込みボリュームを比較する前に、完全なプロパティウィンドウを待ちます。
ルールを有効にする前に、クライアント側の上書きを削除します。 データストリーム設定の上書きは、Dynamic Datastream Configurationのルールよりも優先されます。 クライアントサイドのオーバーライドを伴うイベントは、エラーや警告を発生させることなく、サイレントにルールをバイパスします。 ルールを有効にする前に、Web SDKまたはMobile SDKの実装を監査して、Dynamic Datastream Configurationsが処理する必要があるイベントのsendEventおよびconfigure呼び出しからedgeConfigOverridesを削除します。
デプロイメント後に監視します。 実稼動環境でルールを有効にした後、次の項目を監視して正しい動作を確認します。
- Adobe Experience Platformのデータセット取り込みボリューム > データセット:イベントが期待されるデータセットに到達し、そのボリュームが予測と一致することを確認します。
- ストリーミング取り込みのスループットと合計データボリューム:プロファイルが有効なデータセットから切り離されたイベントに応じて、ストリーミング取り込みボリュームの影響を確認します。 保持の有効期限ウィンドウの合計データ量の影響会計を確認します。
- Customer Journey Analyticsワークスペース: データセットまたは抑制されたイベントタイプを除外した場合、これらのイベントがレポートに表示されないことを確認します。
次の手順
- ステップバイステップのテストチェックリストについては、 テストと検証 Dynamic Datastream Configurationsを参照してください。
- 参照ルール設定については、動的データストリーム設定のユースケース を確認してください。
- ルールの動作とシステムのインタラクションに関するよくある質問の回答については、FAQを参照してください。