Documentation

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

注釈

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

Liferay Analytics Cloudは、フォーム、ブログ、ドキュメントとメディア、Webコンテンツなどの組み込みのLiferay DXPアセットを検出して分析することができます。 ただし、カスタム アプリ内のアセットを分析するには、アプリの 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>

注釈

これらの属性は、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>