ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

イベントの追跡

Liferay DXPのサイトページにJavaScriptのコードを追加することで、分析のためにイベントを追跡することができます。コードは Analytic Cloud の API と対話して、ユーザーが Web サイトで何をしているかを取得します。これらのイベントは、イベント分析ツールで分析できます。

そのためには、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 コードを追加する別の方法は、コンテンツページに追加できるページフラグメントを作成することです。ウェブサイトのどのページにも素早くフラグメントを追加することができるため、より高いスケーラビリティを得ることができます。

製品メニュー () をクリックし、 デザイン → フラグメントに移動します。
フラグメントセットの プラス アイコン () をクリックします。
新しいフラグメントを作成するには、追加アイコン () をクリックします。
［Code］ タブをクリックし、JavaScriptフィールドにJavaScriptコードを貼り付けます。

なお、属性値をフェッチするコードや、 Analytics.track コードをトリガーするロジックを追加する必要がある場合もあります。
［保存］ をクリックすると、ページフラグメントが使えるようになります。
フラグメントを追加したいコンテントページに移動します。編集アイコン () をクリックしてページエディターを開きます。先ほど作成したフラグメントを見つけ、自分のページにドラッグします。公開をクリックします。