---
title: "ファセット"
slug: "facets"
abstract: "xConnectの側面の概要。"
---
# ファセット

ファセットとは、連絡先や相互作用を豊かにする情報のことです。連絡先の場合は名前や住所を含むことがあります。交流の場合は、その交流の場所を含むことがあります。各ファセットは以下で構成されています:

-   ファセットモデルは、 Sitecore.XConnect.Facetを継承するクラスです。
-   ファセットの定義で、ファセットモデルをキーに関連付け、エンティティ(コンタクトまたはインタラクションのいずれか)に割り当てます。ファセットは [コードやコレクションモデル](https://doc.sitecore.com/xp/ja/developers/91/sitecore-experience-platform/create-a-custom-model.html "Create a custom model")で定義されます。

ファセットモデルは異なるキーで再利用したり、同じキーで接触と相互作用を定義したりできます。

> !重要ファセットキーは大文字で区別されます。

## 接触および相互作用の側面

コンタクトの側面は、コンタクトの特性を表すべきであり、その行動を表すものではありません。例えば:

-   常連飛行機のステータス
-   スーパーマーケットのロイヤルティカード番号

インタラクション・ファセットは、購入などインタラクション内で起こる [出来事](https://doc.sitecore.com/xp/ja/developers/91/sitecore-experience-platform/events.html "Events") ではなく、全体のインタラクションを記述すべきです。例えば、コンタクトが特定の靴店を訪れた場合、インタラクション・ファセッツには以下のようなものが含まれることがあります。

-   保管手段
-   訪問時のアクティブストアオファー
-   訪問中の天候
-   訪問中の当直マネージャーのID

## 面の種類

ファセットには2つのカテゴリがあります。価値ファセットと計算ファセットです。この2つのファセットカテゴリの唯一の違いは、計算されたファセットがxConnectサービスレイヤーのハンドラーに関連付けられていることです。

### 価値の側面

バリューファセットは連絡先やインタラクションに適用でき、xConnect Client APIを使ってどのクライアントでも設定可能です。ほとんどのコンタクトファセットおよびすべてのインタラクションファセットはこのカテゴリに該当します。Sitecoreには、ご自身のモデルで参照できる [複数の内蔵ファセット](https://doc.sitecore.com/xp/ja/developers/91/sitecore-experience-platform/use-core-collection-model-facets.html "Use core collection model facets") が含まれています。

### 計算された側面

計算されたファセットはコンタクト専用です。計算されたファセットは、コンタクトのインタラクション履歴から推定されるデータ、例えば訪問ごとの平均エンゲージメント値を表します。計算されたファセットは、関連データとのやり取りが提出されるたびにxConnectサービスレイヤーによって更新され、価値ファセットと同様にxConnect Client APIを使って取得できます。キービヘイビアキャッシュやコンタクトビヘイビエーションプロファイルは、組み込みの計算ファセットの例です。

以下のトピックは計算された側面についてさらに詳しい情報を提供します:

-   [計算された面の概要](https://doc.sitecore.com/xp/ja/developers/91/sitecore-experience-platform/calculated-facets.html "Calculated facets")
-   [関与措置](https://doc.sitecore.com/xp/ja/developers/91/sitecore-experience-platform/engagement-measures.html "Engagement measures")
-   [キービヘイビアキャッシュ](https://doc.sitecore.com/xp/ja/developers/91/sitecore-experience-platform/key-behavior-cache.html "Key behavior cache")
-   [接触行動プロファイル](https://doc.sitecore.com/xp/ja/developers/91/sitecore-experience-platform/contact-behavior-profile.html "Contact Behavior Profile")
-   [インタラクションキャッシュ](https://doc.sitecore.com/xp/ja/developers/91/sitecore-experience-platform/interactions-cache.html "Interactions cache")

## ファセット属性

ファセットや個々のファセットプロパティを以下の属性で装飾することができます:

-   DoNotIndex: この属性で装飾されたファセットやファセットプロパティはインデックス化されておらず、検索できません。検索に興味がないデータ、例えばバイナリデータにはこの方法を使ってください。
-   PIISensitive: この属性で装飾された接触面や接触面プロパティはインデックス化されておらず(したがって検索できません)。この属性でマークされたデータはディスクに書き込まれたり、外部システムに送信したり、いかなる形でも公開してはなりません。

> !重要PIISensitive属性でインタラクションの側面を装飾しようとすると、モデルは検証に合格しません。PIIに敏感な情報をインタラクションの側面に保存すべきではありません。

## カスタムファセットのインデックス化

カスタムの接触およびインタラクトのファセットは自動的にxDBインデックスに追加されます。ファセットはインデックス化されますが、保存されません。ファセットデータは以下のシナリオでxDBインデックスから除外されます:

-   PIISensitiveとマークされたコンタクト面やファセットプロパティは、PIISensitiveとマークされたファセットのインデックスが無効であればインデックスされません。PIISensitiveファセットのインデックスは[デフォルトで無効](https://doc.sitecore.com/xp/ja/developers/91/sitecore-experience-platform/enable-indexing-of-pii-sensitive-data-in-the-xdb-index.html "Enable indexing of PII sensitive data in the xDB index")です。
-   DoNotIndexとマークされた接触面や相互作用の面、または面の性質はインデックスされません。