トラッカーのコンタクトファセット

セッションでのファセットへのアクセス

Version:

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

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

訪問者がサイトに戻ると、設定可能なファセットのリストがxConnectからセッションに読み込まれます。

大事な

セッションに読み込まれたファセットは編集できますが、セッション終了時にxConnectに自動的に保存されるわけではありません。ファセットを更新するには、xConnectクライアントAPIを使用する必要があります。

セッションでIXConnectFacetsクラスにアクセスします

IXConnectFacetsトラッカーファセットはSitecore.Analytics.Model.Framework.IFacetを継承し、Sitecore.XConnect.Facetを継承するxConnectファセットのディクショナリが含まれています。構成は、ファセットディクショナリにロードされるファセットを決定します。次の例は、デフォルトで使用可能なPersonalInformationファセットにアクセスする方法を示しています。

var xConnectFacet = Sitecore.Analytics.Tracker.Current.Contact.GetFacet<Sitecore.Analytics.XConnect.Facets.IXConnectFacets>("XConnectFacets");

PersonalInformation personal = xConnectFacet.Facets[PersonalInformation.DefaultFacetKey] as PersonalInformation;

メモ

Sitecore 9.3以降では、IContactPersonalInfoなどの従来のファセットクラスは使用できなくなりました。代わりにIXConnectFacetsクラスを使用してください。

App_Config\Sitecore\Marketing.xDB\Sitecore.Analytics.Model.config設定ファイルの<facet>要素のコメントを解除して、レガシーファセットを再度有効にすることができます。ただし、IXConnectFacetsにアップグレードすることをお勧めします。

セッション内のキー動作キャッシュファセットへのアクセス

次の例は、キー動作キャッシュにアクセスする方法を示しています。

var xConnectFacets = Sitecore.Analytics.Tracker.Current.Contact.GetFacet<IXConnectFacets>("XConnectFacets");

KeyBehaviorCache kbc = xConnectFacets.Facets[KeyBehaviorCache.DefaultFacetKey] as KeyBehaviorCache;
var recentCampaigns = kbc.Campaigns;

先端

各キー動作キャッシュエントリには、DefinitionIdプロパティがあります。 Marketing Operations APIを使用して、IDで定義項目を取得します。

セッションで問い合わせ行動プロファイルファセットにアクセスする

次の例は、問い合わせ行動プロファイルにアクセスする方法を示しています。

var xConnectFacets = Sitecore.Analytics.Tracker.Current.Contact.GetFacet<IXConnectFacets>("XConnectFacets");

ContactBehaviorProfile cbp = xConnectFacets.Facets[ContactBehaviorProfile.DefaultFacetKey] as ContactBehaviorProfile;
var matchedProfileIDs = cbp.Scores.Select(x => x.Value.ProfileDefinitionId);

手記

Sitecore 10.1から、コンタクト行動プロファイルの計算ロジックが変更されました。デフォルトでは、古い計算ロジックは無効になっています。有効にするには、「最新のプロファイルスコアで問い合わせ行動プロファイルを有効にする」を参照してください。ProfileScoresファセットとInteractionCacheファセットのProfileScoresプロパティは廃止されました。

セッションでの自動化プラン登録へのアクセス

次の例は、連絡先の自動化アクティビティにアクセスする方法を示しています。

var xConnectFacets = Sitecore.Analytics.Tracker.Current.Contact.GetFacet<IXConnectFacets>("XConnectFacets");

AutomationPlanEnrollmentCache enrolments = xConnectFacets.Facets[AutomationPlanEnrollmentCache.DefaultFacetKey] as AutomationPlanEnrollmentCache;

var specificActivityEnrolments = enrolments.ActivityEnrollments.Where(x => x.ActivityId == Guid.Parse("9098fa76-eaf3-4adc-ada5-e46014ba9f30"));
var specificPlanEnrolments = enrolments.ActivityEnrollments.Where(x => x.AutomationPlanDefinitionId == Guid.Parse("6ce0925e-961e-469e-b085-454a6ba0a931"));

先端

各自動化プラン登録キャッシュ・エントリーには、プラン定義IDとアクティビティー IDがあります。自動化プラン定義マネージャーを使用して、プラン定義項目を取得します。アクティビティ記述子ロケータAPIを使用して、アクティビティ記述子をIDで取得します。

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