すべてのプロダクト
Search
ドキュメントセンター

Mobile Platform as a Service:一般的なインストルメンテーションの種類

最終更新日:Jun 11, 2026

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

-

設定オプション。bizTypeext を含みます。

options.bizType

String

Pay

ビジネスコード。

options.ext

Object

{ productId: 'xxx' }

拡張パラメーター。

  • コード例

Tracker.click('clickseedname', { bizType: 'Pay', ext: { productId: 'xxx' } });

エクスポージャーのインストルメンテーション

エクスポージャーのインストルメンテーションは、ページ内のコンテンツセグメントのエクスポージャーを記録します。たとえば、画像カルーセルが表示されたときです。

エクスポージャーイベントをログ出力するには、Tracker.expo() を呼び出します:

Tracker.expo(eventId, options)
  • パラメーター

パラメーター

タイプ

説明

eventId

String

exposeedname

イベント ID。

options

Object

-

設定オプション。bizTypeext を含みます。

options.bizType

String

Pay

ビジネスコード。

options.ext

Object

{ productId: 'xxx' }

拡張パラメーター。

  • コード例

Tracker.expo('exposeedname', { bizType: 'Pay', ext: { productId: 'xxx' } });

関連トピック