mtracker の Web ユニバーサル自動インストルメンテーションソリューションは、PC とモバイル H5 ページをサポートしています。このソリューションでは、ページビュー、クリック、エクスポージャーの各イベントをトラッキングできます。ページビューは自動的に収集され、クリックはタグのプロパティに基づいて自動的に収集できますが、エクスポージャーの収集には手動での実装が必要です。
mtracker は 3 種類のインストルメンテーションをサポートしています。ユニバーサルインストルメンテーションを設定する前に、次の表を確認し、各タイプの動作と、どれに追加設定が必要かをご確認ください:
|
インストルメンテーションの種類 |
取得内容 |
トリガー |
|
任意のページが読み込まれるたびに記録されるページオープンイベント |
自動:コードは不要です |
|
|
ページ内のボタンおよびリンクのクリック |
タグベース (自動) または手動 JavaScript (JS) 呼び出し |
|
|
ビューポート内に表示されるコンテンツセグメント |
手動 JS 呼び出し |
ページビューのインストルメンテーション
mtracker をインポートすると、ページが読み込まれるたびにページビューイベントが自動的に記録されます。追加のコードは不要です。
クリックのインストルメンテーション
クリックのインストルメンテーションは、ページ内のボタンおよびリンクのクリックを記録します。タグベースのインストルメンテーション (自動) または手動 JS トリガーを使用します。
タグベースのインストルメンテーション
任意の HTML タグに data-seed 属性を追加します。mtracker はクリックイベントをリッスンし、この属性を持つタグのクリックを自動的にログ出力します。
-
基本トラッキング:一意のシード名を指定して
data-seedを追加します:<div data-seed="seedname"></div> ビジネスコード:
seedとともにbizType値をログに含めるには、data-biztypeを追加します:
<div data-seed="seedname" data-biztype="xxx"></div>
拡張プロパティ:data-mtr- をプレフィックスとして持つ属性を追加すると、seed とともにログ出力される追加のメタデータを付与できます。ログ出力では data-mtr- プレフィックスは削除されます。次の例では、シードを seedname として、拡張プロパティ extra1=111 および extra2=222 をログ出力します:
HTML マークアップ:
<div data-seed="seedname" data-mtr-extra1="111" data-mtr-extra2="222"></div>
ログ出力された拡張プロパティ:extra1=111^extra2=222
手動トリガー
タグベースのインストルメンテーションで対応できないシナリオの場合は、JS クリックメソッドを使用します。たとえば、1 つのタグでコンテキストに応じて異なるイベントをログ出力する必要がある場合です。
Tracker.click(eventId, options)
パラメーター
|
パラメーター |
タイプ |
例 |
説明 |
|
eventId |
String |
clickseedname |
イベント ID。 |
|
options |
Object |
- |
設定オプション。 |
|
options.bizType |
String |
Pay |
ビジネスコード。 |
|
options.ext |
Object |
|
拡張パラメーター。 |
コード例
Tracker.click('clickseedname', { bizType: 'Pay', ext: { productId: 'xxx' } });
エクスポージャーのインストルメンテーション
エクスポージャーのインストルメンテーションは、ページ内のコンテンツセグメントのエクスポージャーを記録します。たとえば、画像カルーセルが表示されたときです。
エクスポージャーイベントをログ出力するには、Tracker.expo() を呼び出します:
Tracker.expo(eventId, options)
パラメーター
|
パラメーター |
タイプ |
例 |
説明 |
|
eventId |
String |
exposeedname |
イベント ID。 |
|
options |
Object |
- |
設定オプション。 |
|
options.bizType |
String |
Pay |
ビジネスコード。 |
|
options.ext |
Object |
|
拡張パラメーター。 |
コード例
Tracker.expo('exposeedname', { bizType: 'Pay', ext: { productId: 'xxx' } });