カスタムイベントのトリガー

カスタム目標およびイベントデータの取得

Sitecore.Analytics.Tracker.Current.CurrentPage.Register()メソッドを使ってカスタムデータで目標やページイベントをトリガーします。

以下の表は、カスタムデータを保存するために使用できるSitecore.Analytics.Model.PageEventDataクラスのプロパティを説明しています。イベント変換時に、このデータはカスタムイベントにコピーできます。変換前にカスタムデータの保存方法を決める必要があります。例えば、DownloadEventはダウンロードされたメディアアイテムのIDをItemIdプロパティに保存することを期待します。

財産

概要

ItemId

イベントが発生したページアイテムのID、またはそのイベントに関連付けられたメディアアイテム。

Text

人間が読みやすいイベントの説明 - 例:「インストールガイドをダウンロード済み」

DataKey

「Data」の内容を識別するキー(例:「campaignid」や「keywords」)です

Data

イベントのトリガーとして収集されたデータ、例えばキャンペーンイベントのキャンペーンIDや「スローページ」イベントのページロード時間など。

CustomValues

任意の文字列/オブジェクトの組み合わせを保存してください。

>[!重要]
> このプロパティはxConnectには決して保存されず、 イベント変換パイプラインでカスタムxConnectイベントモデルにコピーされるデータのみを保存するために使用すべきです。

以下の例は、カスタムデータで目標を発動する方法を示しています:

var ev = Sitecore.Analytics.Tracker.MarketingDefinitions.GoalsNewsletterSignupGoal.NewsletterGoalID;

var newsletterId = Guid.NewGuid(); // Fake newsletter ID var pageData = new Sitecore.Analytics.Data.PageEventData(ev.Alias, ev.Id);

pageData.Data = newsletterId.ToString(); pageData.Text = "Signed up for newsletter"; pageData.DataKey = "newsletterid"; pageData.CustomValues"NewsletterImageCategory" = "C"; // Never saved to xConnect, must be converted into a property on a custom model

Sitecore.Analytics.Tracker.Current.CurrentPage.Register(pageData);

カスタムアウトカムデータの取得

Sitecore.Analytics.Tracker.Current.CurrentPage.RegisterOutcome()メソッドを使ってカスタムデータで結果をトリガーしてください。Sitecore.Analytics.Data.OutcomeDataオブジェクトはカスタムデータをCustomValuesプロパティにのみ保存でき、これは型Dictionary<string,object>です。CustomValuesはxConnectに保存されず、セッション中やイベント変換パイプラインのコンテキストでのみアクセス可能です。

以下の例は、現在のページのカスタムデータを使って結果をトリガーする方法を示しています:

var ev = Sitecore.Analytics.Tracker.MarketingDefinitions.OutcomesCarPurchaseOutcome.CarPurchaseOutcomeID;

if (ev != null) { var outcomeData = new Sitecore.Analytics.Data.OutcomeData(ev, "DKK", 100000.00m);

outcomeData.CustomValues.Add("Make", "Mazda"); // Never saved to xConnect, must be converted into a property on a custom model outcomeData.CustomValues.Add("Model", "MX-5"); // Never saved to xConnect, must be converted into a property on a custom model

Sitecore.Analytics.Tracker.Current.CurrentPage.RegisterOutcome(outcomeData); }

!注9.0 Update-1以降は、現在のやり取りに関するカスタムデータで結果をトリガーすることも可能です。

CustomValuesでのイベントデータをキャプチャするオプション

以下の表は、セッション中のイベントのイベントデータをCustomValues辞書に保存する方法を示しています。

!重要CustomValuesプロパティはxConnectに保存されることはありません。各カスタムイベントモデルごとに、CustomValuesからそのモデルにデータをコピーする変換パイプラインを作成しなければなりません。

• 方法
• CustomValuesにシンプルな値を保存する:必要なカスタム値をCustomValues辞書のキーに対して保存する
  、最も容量を節約できます。

pageData.CustomValues"NewsletterID" = "1234"; pageData.CustomValues"NewsletterBannerID" = "1245";

• CustomValuesにシンプルなクラスを保存する:カスタムクラスのインスタンスをCustomValues辞書のキーに対して保存する:

Serializable // Required public class NewsletterGoalSessionData { public string NewsletterID { get; set; } public string NewsletterBannerID { get; set; } }

pageData.CustomValues"NewsletterImageCategory" = new NewsletterGoalSessionData { NewsletterID = "1234", NewsletterBannerID = "1245" }

• CustomValuesにシリアライズされたxConnectイベントモデル全体を保存する
  (例えばMyCustomGoal)をシリアライズしてJSONし、カスタム値として保存し、イベント変換パイプラインでデシリアライズして返すことができます。これを行うにはxConnectのシリアライズヘルパーを使う必要があります。重要
  。トラッカーがSystem.Runtime.Serialization.SerializationException例外を出します。シリアライズされたイベントのサイズに注意してください。セッションに大量のデータを保存するとセッション状態プロバイダーのパフォーマンスに悪影響を及ぼすため、単純な値を辞書に保存するCustomValuesを好むかもしれません。