カスタムアセットのトラッキング

note

カスタムアセットを追跡するには、イベントの追跡の使用が推奨されます。

Liferay Analytics Cloudは、フォーム、ブログ、ドキュメントとメディア、Webコンテンツなどの組み込みのLiferay DXPアセットを検出して分析することができます。ただし、カスタムアプリのアセットを解析するには、Analytics Cloud JavaScript プラグインがアセットとユーザーの相互作用を検出して追跡できるように、アプリのHTMLにタグ付けする必要があります。

アセットイベント

Analytics Cloud JavaScriptプラグインには、追跡できる以下のイベントが含まれています。

AssetClicked：ユーザーがアセット領域をクリック。また、クリックされたタグの情報も掲載しています。

AssetDepthReached: アセットエリアのスクロールイベント。また、ユーザーが到達したコンテンツの深さに関する情報（例えば、ユーザーがどれくらいブログ記事をスクロールしたか）も掲載されています。

AssetViewed: ユーザーがアセットを閲覧。

AssetDownloaded: ユーザーがアセットをダウンロードするリンクをクリック。

AssetSubmitted: アセットエリアでのフォーム送信。これは、HTMLフォーム要素の下にサブミットの入力タイプを配置する必要があります。

必要なメタデータ

カスタムエンティティのトラッキングを有効にするには、以下の情報が必要です。この情報は、リストされた属性を使ってHTMLで指定する必要があります。

アセットタイプ（文字列）： 追跡するアセットタイプ。このためのHTML属性はdata-analytics-asset-typeです。この属性の値は、エンティティの正確な型ではないことに注意してください。カスタムエンティティの場合、この値は常にカスタムです。

アセットID（文字列）： アセットの一異な識別情報。このためのHTML属性はdata-analytics-asset-idです。

アセットのカテゴリ（文字列、オプション）： アセットを含むカスタムアプリのカテゴリ。このためのHTML属性はdata-analytics-asset-categoryです。これを利用して、カスタムアプリを名前で識別することができます（例：「polls」）。カテゴリ内では、すべてのアセットIDは一意でなければならないことに注意してください。

アセットのタイトル（文字列、オプション）： アセットのタイトル。このためのHTML属性はdata-analytics-asset-titleです。

アセットイベントの追跡

例えば、カスタムPollsアプリでアンケートを追跡したい場合、次のようなHTMLを使用することができます。

<div>
<h1> What's your favorite food? </h1>
<form action="/submit.php">
<div>
  <input type="radio" id="sushi" name="food" value="Sushi"
     checked>
  <label for="sushi">Sushi</label>
</div>
<div>
  <input type="radio" id="pizza" name="food" value="Pizza">
  <label for="pizza">Pizza</label>
</div>
<input type="submit" value="Submit" />
</form>
</div>

このアンケートのイベントを追跡するには、上記の属性をdivに追加します。

<div data-analytics-asset-type="custom"
  data-analytics-asset-id="favorite-food-poll"
  data-analytics-asset-category="polls"
  data-analytics-asset-title="What is your favorite food Poll">

<h1> What's your favorite food? </h1>
...
</div>

note

これらの属性は、Analytics Cloudにトラッキングさせたい個々のアセットに追加する必要があります。しかし、スクリプトを使って属性の値を入力することで、アセットごとにこのプロセスを自動化することができます。

ダウンロードの追跡

ダウンロードを追跡するには、アクションをトリガーする要素にこの属性をタグ付けする必要があります。

data-analytics-asset-action="download"

例えば、上記のアンケートは、アンケートの指示を含むPDFファイルのダウンロードリンクを備えています。

<div data-analytics-asset-type="custom"
  data-analytics-asset-id="favorite-food-poll"
  data-analytics-asset-category="polls"
  data-analytics-asset-title="What is your favorite food Poll">

<a href="/poll-instructions.pdf" data-analytics-asset-action="download">Download the Poll Instructions </a>

<h1> What's your favorite food? </h1>
...
</div>