イベントの追跡
Analytics Cloudは、Liferay DXPサイトで公開されたコンテンツとのインタラクションを自動的に追跡します。 追加のインタラクションやカスタムインタラクションを捕捉する必要がある場合は、サイトのページにJavaScriptコードを追加することでイベントを追跡できます。 これらのイベントは、イベント分析ツールを使用して分析されます。
公開コンテンツの自動追跡
現在、この機能はリリース機能フラグ（LPD-39437）によって制限されています。 詳細については、 リリース機能フラグ を参照してください。
Analytics Cloudは、ページフラグメントを通じてレンダリングされたコンテンツを含め、サイト上で公開されたコンテンツとのインタラクションを自動的に追跡します。 これには、ネイティブウィジェットまたはフラグメントを使用して表示されるかどうかにかかわらず、Webコンテンツ、ブログ、ドキュメントなどの一般的なアセットが含まれます。
デフォルトのアセット追跡動作でカバーされていないカスタムインタラクションまたはイベントをキャプチャする必要がある場合にのみ、 Analytics.track を使用してください。
公開コンテンツの手動追跡
カスタムイベント名と属性を定義するには、JavaScript コードで Analytics.track を使用します。 JavaScript コードを追加するには、 ページを個別に変更する、 ページフラグメントを追加する、または独自の開発ツールとアプローチを使用する方法があります。
| 項目 | 説明 |
|---|---|
event | イベントの名前。 イベント分析を行う際に理解しやすいように、人間が理解できる名前にすることをお勧めします（例：「Add to Cart Click」など）。 |
attributes | 追跡したいイベントのさまざまな属性（例：価格、商品名、数量など）。 |
例えば、ユーザーがどのようにショッピングカートにアイテムを追加しているかを追跡することができます。 これらのイベントを追跡するには、Webサイトの製品ページにJavaScriptコードを追加します。 イベントで追跡する価格、製品名、数量などの属性を選択します。 以下は簡単な例です：
// Add some event listener logic for when a user clicks the Add to Cart button
Analytics.track("Add to Cart Click",{
'price': productPrice(),
'productName': productName(),
'quantity': productQuantity(),
});
Analytics Cloudは、その属性に対して収集された最初のデータに基づいて、自動的にデータタイプを検出してキャストしようとします。 Analytics Cloud の設定ページにある イベント属性の定義 で、必要に応じて型キャストを変更してください。 あなたが指定する属性に加えて、すべてのイベントに自動的に関連済んだグローバル属性があります。 属性に対して、以下のデータ型キャストを設定できます。
| 属性タイプ | 説明 |
|---|---|
Boolean | trueまたはfalse、大文字でも小文字でもOK |
Date | ISO-8061形式（yyyy-MM-dd'T'HH:mm:ss.SSSX）。 |
Duration | ミリ秒単位、非負 |
Number | 桁区切り記号なし。小数点区切り記号は可。 |
String | 他のフォーマットが一致しない場合、Analytics Cloudは文字列を想定する |
個々のページを変更する
JavaScriptコードを追加する最も簡単な方法は、個々のページを変更することです。 JavaScriptコードを追加できるウィジェットページを使用するようにしてください。
-
製品メニュー（
）をクリックし、 サイトビルダー → ページ に移動します。 -
個々のページの アクション アイコン（
）をクリックし、 設定をクリックします。 -
JavaScriptコードをテキストボックスエリアの JavaScriptに貼り付けます。 これは［詳細設定］タブの下にあります。
-
［保存］ をクリックすると、ページでイベントを追跡する準備が整います。
詳細については、 ページ設定 UI リファレンス を参照してください。
ページフラグメントの追加
JavaScriptコードを追加するもう1つの方法は、コンテンツページに追加できるページフラグメントを作成することです。 ウェブサイトのどのページにも素早くフラグメントを追加することができるため、より高いスケーラビリティを得ることができます。
-
製品メニュー（
）をクリックし、 デザイン → フラグメント に移動します。 -
フラグメントセットを表示するには、 プラス アイコン (
) をクリックします。 -
追加 アイコン (
) をクリックして、新しいフラグメントを作成します。 -
［Code］ タブをクリックし、JavaScriptフィールドにJavaScriptコードを貼り付けます。
なお、属性値をフェッチするコードや、
Analytics.trackコードをトリガーするロジックを追加する必要がある場合もあります。 -
［保存］ をクリックすると、ページフラグメントが使えるようになります。
-
フラグメントを追加したいコンテントページに移動します。 ページエディタを開くには、 編集 アイコン（
）をクリックします。 先ほど作成したフラグメントを見つけ、自分のページにドラッグします。 ［Publish（公開）］をクリックします。
Analytics JavaScript オブジェクトを使用するフラグメントは、Analytics Cloud にリンクされていないサイトでは正しく動作しない場合があります。 複数のサイトで同じフラグメントを使用する場合は、参照する前にAnalyticsオブジェクトが存在するかどうかを確認してください。
詳細については、 フラグメントの開発 を参照してください。