アウトカムデータクラス
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
アウトカムデータクラスは、分析データクラスと構造が非常に似ています。
アウトカムデータクラスは、データがインタラクションにシリアライズされる際に2つのメソッドを公開し、1つのメソッドをコンテンツの再水化に使います。
名称
概要
Initialize
結果をトリガーする文脈では、このメソッドを呼び出し、サービスリクエストに渡された引数を渡します。特定のアウトカムデータオブジェクトは、RequestオブジェクトとResultオブジェクトを解析してシリアライズしたいデータを抽出する方法を知る責任があります。
Serialize
このメソッドを呼び出して、内容を指定された辞書にシリアライズし、そのインタラクションのページイベントや目標のカスタム値に書き込まれます。
Deserialize
このメソッドを呼び出してデータクラスの内容を再水和化します。現在、Connect Experience ProfileおよびExperience Analyticsのレポートコンポーネントで使用されています
データをシリアライズする際には、以下のユーティリティ手法が利用可能です:
- 名称
- AddEntityToSimpleValues
: このテンプレート化されたメソッドは、カスタム値辞書にConnectエンティティを追加する際に使用されます。注、このメソッドを使うことが非常に重要です。このメソッドはいくつかのことをします。まず、ECSによって行われた可能性のある拡張を除去したベースエンティティの値のみを保存します。これは、分散環境ではECS固有のデータ型が利用できない可能性があり、デシリアライズフェーズ中にレポーティングサーバーや処理サーバーに問題を引き起こす可能性があるためです。これら両方のサーバーが自分のドメインおよびコントロール内にある場合、元の「カスタム」ECSエンティティを持つことが望ましい場合があります。この場合、Sitecoreで以下の設定が利用可能です。Commerce.configファイル:有効な値は。カスタムは元のエンティティを保存します。両方ともベースエンティティと元のバージョンの両方を保存します。デフォルトではBaseは設定されています。結果のカスタムデータは常に文字列で、このメソッド呼び出しで処理されます。詳細については、Experience Profile Commerce タブのトピックをご覧ください。
データをリハイドレートする際は、以下のユーティリティ手法を使用します。
上記のメソッドは、必要な型のシリアライズ済みリストから値を取得することを可能にします。 GetMandatoryValueAsStringメソッドは、必須パラメータが見つからない場合に備え、適切なnullチェックやログ付けなどの追加のエラー処理コードを追加します。
GetOptionalValueAsObjectメソッドはGetMandatory*メソッドと同じですが、キーが存在しない場合はエラーログが発生します。
以下は、新しい訪問者注文が作成された際に登録される、訪問者注文の作成結果のConnect実装を示しています:
public class SubmittedOrderOutcomeData : BaseOutcomeData
{
public string ExternalId { get; set; }
public string ShopName { get; set; }
public Order Order { get; set; }
public override void Initialize(Pipelines.ServicePipelineArgs args)
{
base.Initialize(args);
this.Order = this.GetOrderFromArgs();
if (this.Order != null)
{
this.ExternalId = this.Order.ExternalId;
this.ShopName = this.Order.ShopName;
}
}
public void Initialize(Order order)
{
this.ServicePipelineArgs = null;
this.Order = order;
if (this.Order != null)
{
this.ExternalId = this.Order.ExternalId;
this.ShopName = this.Order.ShopName;
}
}
public override void Serialize(Dictionary<string, string> values)
{
if (this.Order != null)
{
valuesConstants.KnownPageEventDataNames.ExternalId = this.ExternalId;
valuesConstants.KnownPageEventDataNames.ShopName = this.ShopName;
this.AddEntityToSimpleValues
いくつか言及すべきことがあります:
- 2つの Initialize メソッドがあります。1つ目はトリガーの結果メカニズムが呼び出すServicePipelineArgsを受け取ります。2つ目はオフライン注文の登録時に使われるOrderを受け取ります。
- Serialize法はAddEntityToSimpleValues()テンプレート法を用いて順序を結果に追加します。
以下のコードスニペットは、結果のカスタムデータをどのように利用するかを示しています:
Dictionary<string, string> customValues =
JsonConvert.DeserializeObject<Dictionary<string, string>>
(contactOutcome.CustomValuesConstants.KnownAnalyticsKeys.SitecoreCommerceOutcomeKey);
var outcomeData = OutcomeDataFactory.Create
上記は、コンタクトのSitecore結果が得られたことを前提としています。 ContactOutcomeクラスはカスタム値情報をシリアライズ形式で含みます。つまり、SubmittedOrderOutcomeDataデシリアライズメソッドを呼び出す前にカスタム値辞書をデシリアライズする必要があります。近い将来、この機能をBaseOutcomeDataクラスにカプセル化する予定です。