マーケティングオペレーション

プログラムによるページイベントの登録

Version:

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

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

Sitecore Experience Platformでは、ページイベントはシステムによってトリガーされるか、Webサイトへの訪問者によってトリガーされます。例えば、訪問者がキャンペーン登録フォームに入力して「送信」をクリックすると、ゴールコンバージョンイベントやキャンペーンイベントなどのイベントがトリガーされる可能性があります。

すべてのページイベント定義は、Sitecoreコンテンツツリーの次の場所に保存されます。

/sitecore/system/Settings/Analytics/Page Events

ここに保存されている各ページイベント定義を設定して、ルールやその他のアクションをトリガーしたり、エンゲージメント値ポイントを各ページイベントに関連付けることができます。コンテンツエディターでは、既存の定義のリストに新しいPage Eventアイテムを追加することで、独自のカスタムページイベント定義を作成および設定できます。

Sitecore.Analytics.Tracking.IPageContextインターフェースを実装する任意のページまたはオブジェクトにページイベントを登録できます。たとえば、現在のページ、前のページ、またはこのインターフェイスを実装するその他のページやオブジェクトなどです。

ページイベントを登録するには:

次の名前空間をソリューションにインポートします。
- Sitecore.Analytics
- Sitecore.Analytics.Data

RegisterPageEventメソッドを使用して、ページイベントを登録します。

private void RegisterPageEvent(string name, Guid definitionId, Guid itemId, string data, string text)

このメソッドは、次のパラメーターを取ります。

パラメーター	形容	例
name	登録するページイベントの名前。	Download, Search, フォームが送信されました。
definitionId	ページイベントの一意の識別子。	ページイベントアイテムのアイテムID。 {F358D040-256F-4FC6-B2A1-739ACA2B2983}
itemId	ページイベントを含むページの一意の識別子。	コンテンツアイテムのアイテムID。 {110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9}
data	ページイベントに関連するカスタムデータまたはその他の情報。例えば、エクスペリエンスプロファイルでは、データフィールドを使用して、検索ページイベントの検索キーワードとキャンペーンページイベントのキャンペーンIDを取得します。	Search、Brochure.pdf秒、または7秒です。
text	ページイベントを読みやすい形式で説明するテキスト。このテキストは、エラーメッセージまたは情報メッセージです。	結果が見つかりませんでした、Brochure downloaded、リクエストは完了するまでに7.263ミリ秒かかりました。

次のコードを含めて、ページイベントを登録する前に、必要なすべての前提条件が満たされていることを確認します。たとえば、現在のセッション、現在のページ、およびページイベントに関連するインタラクションを確認するには、次のようにします。

      Assert.IsNotNull(Tracker.Current, "Tracker.Current");
      Assert.IsNotNull(Tracker.Current.Session, "Tracker.Current.Session");
      var interaction = Tracker.Current.Session.Interaction;
      Assert.IsNotNull(interaction, "Tracker.Current.Session.Interaction");
      Assert.IsNotNull(interaction.CurrentPage, 
"Tracker.Current.Session.Interaction.CurrentPage");

ページイベントを登録するには、次のコードを含めます。

var pageEventData = new PageEventData(name, definitionId)
      {
        ItemId = itemId,
        Data = data,
        Text = text
      };

次の行は、ページイベントが現在のページに登録されていることを確認します。

interaction.CurrentPage.Register(pageEventData);

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