1. xConnectモデル

ファセット

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

このページの翻訳は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という名前の1つの接触ファセットを定義しています。

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クライアントAPIを使用して取得できます。キー動作キャッシュと問い合わせ動作プロファイルは、組み込みの計算ファセットの例です。

次のトピックでは、計算されたファセットについて詳しく説明します。

ファセット属性

ファセットまたは個々のファセット・プロパティを次の属性で装飾できます。

  • DoNotIndex - この属性で装飾されたファセットまたはファセット プロパティはインデックス化されないため、検索できません。これは、バイナリデータなど、検索に関心のないデータに使用します。

  • PIISensitive - この属性で装飾されたコンタクトファセットまたはコンタクトファセットプロパティはインデックス化されません(したがって、検索できません)。この属性でマークされたデータは、ディスクに書き込んだり、外部システムに送信したり、公開したりしないでください。

大事な

インタラクションファセットをPIISensitive属性で装飾しようとすると、モデルは検証に合格しません。インタラクションに機密データを保存しないでください。

さらに、ファセットプロパティをExpandDate (DateTime) 属性で装飾することもできます。これはタイプ固有の属性であり、日付値全体ではなく 、日、月、年でDateTimeファセットプロパティを検索できます (Solrのみ、Sitecore 10.0以降)。

カスタムファセットのインデックス作成

カスタム コンタクト ファセットとインタラクション ファセットは、xDBインデックスに自動的に追加されます。ファセットはインデックス化されますが、格納されません。ファセット データは、次のシナリオでxDBインデックスから除外されます。

  • PIISensitiveとマークされたコンタクトファセットまたはファセットプロパティは、PIISensitiveとマークされたファセットのインデックス作成が無効になっている場合、インデックス化されません。PIISensitiveファセットのインデックス作成は、デフォルトでは無効になっています。

  • コンタクトとインタラクションのファセット、またはDoNotIndexとマークされたファセットプロパティはインデックス化されません。

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