1. ファセット

計算された側面

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

計算されたファセットは、新しいやり取りが提出されるたびにxConnectサービスレイヤーによって更新されます。計算されたファセットの目的は、コンタクトのインタラクション履歴に関する推論データをパフォーマンス的にアクセス可能にすることです。計算されたファセットの利用例には以下が含まれます:

  • 連絡先の平均消費額など、数値を増減します
  • 最小値/最大値を保存します
  • 最近の出来事のリストを保存する
  • ヒストグラム(例えば、インタラクション場所のリストとその場所からの総訪問数)を保存します
  • ヒートマップを保存してください

計算された各ファセットは以下の通りです:

  • ファセットクラス。ファセットクラスの中には、計算されたファセットと価値ファセットを区別するものは何もありません。
  • 計算されたファセットハンドラで、xConnectサービス層で設定されています。

計算されたファセットは自動的に再試行されます

xConnectが計算された面値を保存しようとした際に競合が発生した場合、操作は自動的に再試行されます。

計算されたファセットハンドラーは連絡先データにアクセスできません

計算されたファセットハンドラは、コンタクトオブジェクトやコンタクトファセットにアクセスできません。計算がコンタクトファセットに依存し、そのファセットが変化した場合、計算されたファセットを再構築すると結果が一貫しません。計算に必要なデータはイベントまたはインタラクションファセットとして保存してください。

!注現在、計算されたファセットを再構築することは不可能です。

推奨される実践

計算されたファセットを実施する際には、以下の推奨される実践を念頭に置いてください。

計算されたファセットは控えめに使います

計算されたファセットプラグインは、xConnectにインタラクションが提出されるたびに実行されます。機能が使いすぎになると、システム全体のパフォーマンスに悪影響を及ぼす可能性があります。計算されたファセットを実装する際には以下の点を念頭に置いてください:

  • 計算されたファセット機能は控えめに使ってください。
  • 他のファセットが利用できない場合、Sitecore.XConnect.Service.InteractionFacetDependencyオブジェクトのRequiredプロパティをtrueに設定してください。
  • 計算をできるだけ早く終了してください。もし交互作用が面値に影響を与えるために特定の条件を満たす必要がある場合は、まずそれらを確認してください。交互作用が該当しない場合は、 falseを返します。

計算されたファセットプロパティを手動で設定しないでください

xConnect Client APIを使って計算されたファセットを手動で更新しないでください。計算されたファセットが連絡先の履歴から再構築されると、手動の変更は失われます。

ファセットは計算するか、計算しないかのどちらかであるべきです

計算されたプロパティとバリュープロパティを同じファセット内で混同しないでください。例えば、AverageSpendファセットはAverageSpendHandlerのみ更新されるべきです。

この記事を改善するための提案がある場合は、 お知らせください!