イベントの追跡

組み込みイベントのトリガー

Version:

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

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

このトピックでは、トラッカーから標準イベントGoalおよびOutcomeをトリガーする方法について説明します。また、追加データを含むカスタムイベントをトリガーすることもできます。

ゴールをトリガーする

Sitecore.Analytics.Tracker.Current.CurrentPage.RegisterGoal()メソッドを使用して、現在のページに対する目標を登録します。この方法では、目標定義項目が必要です。次の例では、ゴールIDを使用して、Sitecore.Analytics.Tracker.MarketingDefinitions.Goalsから定義アイテムを取得します。

var goalId = Guid.NewGuid(); // ID of goal
var goalDefinition = Sitecore.Analytics.Tracker.MarketingDefinitions.Goals[goalId];

Sitecore.Analytics.Tracker.Current.CurrentPage.RegisterGoal(goalDefinition);

セッション終了時には、ゴールはSitecore.XConnect.Goalオブジェクトに変換されます。

結果をトリガーする

インタラクション全体または特定のページに対して結果をトリガーできます。結果は、セッション終了時にSitecore.XConnect.Outcomeオブジェクトに変換されます。

インタラクションの結果のトリガー

Tracker.Current.Interaction.RegisterOutcome()メソッドを使用して、現在のインタラクションに対する結果を登録します。このメソッドには、結果定義項目が必要です。次の例では、結果IDを使用して、Sitecore.Analytics.Tracker.MarketingDefinitions.Outcomesから定義アイテムを取得します。

var outcomeDefinitionId = Guid.NewGuid(); // Replace with outcome definition ID

Tracker.Current.Interaction.RegisterOutcome(Tracker.MarketingDefinitions.Outcomes[outcomeDefinitionId], "DKK", 300.5m);

特定のページの結果を表示する

Sitecore.Analytics.Tracker.Current.CurrentPage.RegisterOutcome()メソッドを使用して、現在のページに対する結果を登録します。このメソッドには、結果定義項目が必要です。次の例では、結果IDを使用して、Sitecore.Analytics.Tracker.MarketingDefinitions.Outcomesから定義アイテムを取得します。

var outcomeDefinitionId = Guid.NewGuid(); // Replace with outcome definition ID

Tracker.Current.CurrentPage.RegisterOutcome(Tracker.MarketingDefinitions.Outcomes[outcomeDefinitionId], "DKK", 300.5m);

金銭的価値のない結果をトリガーする

示されているように、0.0mの金銭的価値で結果をトリガーできます。ただし、currencyCodeパラメーターをnullまたは空にすることはできません。

var outcomeDefinitionId = Guid.NewGuid(); // Replace with outcome definition ID

Tracker.Current.CurrentPage.RegisterOutcome(Tracker.MarketingDefinitions.Outcomes[outcomeDefinitionId], "USD", 0.0m);

キャンペーンイベントをトリガーする

Sitecore.Analytics.Tracker.Current.CurrentPage.TriggerCampaign()メソッドを使用して、現在のページに対してキャンペーンイベントを登録します。このメソッドには、キャンペーン定義アイテムが必要です。次の例では、キャンペーンIDを使用して、Sitecore.Analytics.Tracker.MarketingDefinitions.Campaignsから定義アイテムを取得します。

var campaignDefinitionId = Guid.NewGuid(); // Replace with real campaign DEFINITION ID

var definition = Sitecore.Analytics.Tracker.MarketingDefinitions.Campaigns[campaignDefinitionId];

Sitecore.Analytics.Tracker.Current.CurrentPage.TriggerCampaign(definition);

キャンペーンは、セッション終了時にSitecore.XConnect.Collection.Model.CampaignEventオブジェクトに変換されます。キャンペーン定義IDは、CampaignDefinitionIdプロパティで表されます。

ページイベントをトリガーする

RegisterPageEvent()メソッドを使用して、現在のページに対してページイベントを登録します。このメソッドには、ページイベント定義アイテムが必要です。次の例では、ページイベントIDを使用して、Sitecore.Analytics.Tracker.MarketingDefinitions.PageEventsから定義アイテムを取得します。

var pageEventId = Guid.NewGuid(); // ID of goal
var pageEventDefinition = Sitecore.Analytics.Tracker.MarketingDefinitions.PageEvents[pageEventId];

Sitecore.Analytics.Tracker.Current.CurrentPage.RegisterPageEvent(pageEventDefinition);

先端

一般的なページイベントIDはSitecore.Analytics.AnalyticsIdsで確認できます(例: Sitecore.Analytics.AnalyticsIds.FollowHitEvent)。ページイベントは、Sitecoreツリーのsitecore//システム//設定//分析//ページイベントで定義されます。

トリガー検索イベント

Searchイベントは特殊なページイベントであり、カスタムデータが必要です。 Sitecore.Analytics.Tracker.Current.CurrentPage.Register() メソッドを使用して、現在のページに対して検索イベントを登録します。 Dataプロパティを、検索中に使用されたキーワードに設定します。

var searchEvent = Tracker.MarketingDefinitions.PageEvents[AnalyticsIds.SearchEvent.Guid];

Sitecore.Analytics.Tracker.Current.CurrentPage.Register(new PageEventData(searchEvent.Alias, searchEvent.Id)
{
    Data = "sitecore experience platform"
});

このイベントはSitecore.XConnect.Collection.Model.SearchEventオブジェクトに変換されます。 DataプロパティはKeywordsプロパティにマップされます。

ダウンロードイベントのトリガー

ダウンロードイベントは特殊なページイベントであり、カスタムデータが必要です。 Sitecore.Analytics.Tracker.Current.CurrentPage.Register() メソッドを使用して、現在のページに対してダウンロードイベントを登録します。 ItemIdプロパティを、ダウンロードされたメディア項目のIDに設定します。

var mediaItemId = Guid.NewGuid(); // Replace with real media item ID
var downloadDefinition = Tracker.MarketingDefinitions.PageEvents[AnalyticsIds.DownloadEvent.Guid];

Sitecore.Analytics.Tracker.Current.CurrentPage.Register(new PageEventData(downloadDefinition.Alias, downloadDefinition.Id)
{
    Text = "Sitecore installation guide", // Not mandatory
    ItemId = mediaItemId
});

このイベントはSitecore.XConnect.Collection.Model.DownloadEventオブジェクトに変換されます。 ItemIdプロパティは一致するItemIdにマップされ、オプションのTextプロパティは一致Textプロパティにマップされます。

イベント拡張機能

次のシステムイベントは、特殊な拡張メソッドを使用してトリガーできます。

Sitecore.Analytics.Extensions.CampaignExtensions.TriggerCampaignFailed() (AnalyticsIds.CampaignRegistrationFailedEvent.Guid)
Sitecore.Analytics.Extensions.ErrorExtensions.LongWait() (AnalyticsIds.LongRunningRequestEvent.Guid)
Sitecore.Analytics.Extensions.ErrorExtensions.RegisterError() (AnalyticsIds.ErrorEvent.Guid)
Sitecore.Analytics.Extensions.ErrorExtensions.RegisterPageError() (AnalyticsIds.PageErrorEvent.Guid)
Sitecore.Analytics.Extensions.ErrorExtensions.RegisterPageNotFound() (AnalyticsIds.PageNotFoundEvent.Guid)

エイリアスでイベントをトリガーする

イベントは、そのエイリアスによってトリガーできます。イベントの定義IDにアクセスできない場合にのみ使用してください。この方法はパフォーマンスが劣るためです。

// Option 1 - pass event alias into PageEventData
Sitecore.Analytics.Tracker.Current.CurrentPage.Register(new PageEventData("Download") // Use only if ID of event is not available
{
    Text = "Sitecore installation guide",
});

// Option 2 - pass event alias into .Register() method; text parameter maps to 'Text' property on PageEventData
Sitecore.Analytics.Tracker.Current.CurrentPage.Register("Download", "Installation guide downloaded");

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