ファセット
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
ファセットとは、連絡先ややり取りを豊かにする情報のことです。連絡先の場合は名前や住所が含まれることがあります。やり取りの場合は、やり取りの場所が含まれることがあります。 Sitecoreのデフォルトのファセット を使うことも、自分で作成することもできます。
ファセットはファセットモデルとファセット定義で構成されています。異なるキーでファセットモデルを再利用したり、同じキーでコンタクトとインタラクションを定義することもできます。
!重要ファセットキーは大文字で区別されます。
ファセットモデル
ファセットモデルは以下のクラスを継承するものSitecore.XConnect.Facet:
using Sitecore.XConnect; using System;
namespace Documentation.Examples { Serializable FacetKey(DefaultFacetKey) public class FrequentFlyerInformation : Facet { public const string DefaultFacetKey = "FrequentFlyerInformation";
public string FrequentFlyerID { get; set; } // Example: ABC12345 public string PreferredAirport { get; set; } // Example: Kastrup } }
ファセットの定義
ファセット定義はファセットモデルをキーに関連付け、エンティティ(ContactまたはInteraction)に割り当てます。ファセットは コレクションモデルで定義されており、xConnectにデプロイ してから使用できます。
以下のモデルは、FrequentFlyerInformationという単一の接触面を定義しています:
using Sitecore.XConnect; using Sitecore.XConnect.Schema;
namespace Documentation.Examples { public class CollectionModel { public static XdbModel Model { get; } = BuildModel(); private static XdbModel BuildModel() { XdbModelBuilder modelBuilder = new XdbModelBuilder("DocumentationModel", new XdbModelVersion(1, 0));
modelBuilder.DefineFacet<Contact, FrequentFlyerInformation>(); // Uses default facet key
return modelBuilder.BuildModel(); } } }
接触および相互作用の側面
コンタクトの側面は、コンタクトの特性を表すべきであり、その行動を表すものではありません。例えば:
- 常連飛行機のステータス
- スーパーマーケットのロイヤルティカード番号
インタラクション・ファセットは、購入などインタラクション内で起こる 出来事 ではなく、全体のインタラクションを記述すべきです。例えば、コンタクトが特定の靴店を訪れた場合、インタラクション・ファセッツには以下のようなものが含まれることがあります。
- 保管手段
- 訪問時のアクティブストアオファー
- 訪問中の天候
- 訪問中の当直マネージャーのID
面の種類
ファセットには2つのカテゴリがあります。価値ファセットと計算ファセットです。この2つのファセットカテゴリの唯一の違いは、計算されたファセットがxConnectサービスレイヤーのハンドラーに関連付けられていることです。
価値の側面
バリューファセットは連絡先やインタラクションに適用でき、xConnect Client APIを使ってどのクライアントでも設定可能です。ほとんどのコンタクトファセットおよびすべてのインタラクションファセットはこのカテゴリに該当します。Sitecoreには、ご自身のモデルで参照できる 複数の内蔵ファセット が含まれています。
計算された側面
計算されたファセットはコンタクト専用です。計算されたファセットは、コンタクトのインタラクション履歴から推定されるデータ、例えば訪問ごとの平均エンゲージメント値を表します。計算されたファセットは、関連データとのやり取りが提出されるたびにxConnectサービスレイヤーによって更新され、価値ファセットと同様にxConnect Client APIを使って取得できます。キービヘイビアキャッシュやコンタクトビヘイビエーションプロファイルは、組み込みの計算ファセットの例です。
以下のトピックは計算された側面についてさらに詳しい情報を提供します:
ファセット属性
ファセットや個々のファセットプロパティを以下の属性で装飾することができます:
- DoNotIndex - この属性で装飾されたファセットやファセットプロパティはインデックス化されておらず、検索できません。検索に興味がないデータ、例えばバイナリデータにはこの方法を使いましょう。
- PIISensitive - この属性で装飾された接触面や接触面プロパティはインデックス化されず(したがって検索できません)。この属性でマークされたデータはディスクに書き込まれたり、外部システムに送信したり、いかなる形でも公開してはなりません。
!重要PIISensitive属性でインタラクションのファセットを装飾しようとすると、モデルは検証に合格しません。インタラクション中に機密データを保存しないでください。
さらに、ExpandDate (DateTime) 属性でファセットプロパティを装飾することも可能です。これは型固有の属性で、日付値全体ではなく日付DateTime月年でファセットプロパティを検索できます(Solrのみ、Sitecore 10.0以降)。
カスタムファセットのインデックス化
カスタムの接触およびインタラクトのファセットは自動的にxDBインデックスに追加されます。ファセットはインデックス化されますが、保存されません。ファセットデータは以下のシナリオでxDBインデックスから除外されます:
- PIISensitiveとマークされたコンタクト面やファセットプロパティは、PIISensitiveとマークされたファセットのインデックスが無効であればインデックスされません。PIISensitiveファセットのインデックスはデフォルトで無効です。
- DoNotIndexとマークされた接触面や相互作用の面、または面の性質はインデックスされません。