サーバーサイド CAPI とイベントトラッキング

1. トラッキングモードの概要

MousePlayer V2 は強力な Event Router を導入し、ユーザーのブラウザーから当社のサーバーまでのデータの流れを制御できるようにします。三つのモードから選べます。

• Web Only（初期設定）： すべてのデータを WebSocket で MousePlayer に直接配信します。リアルタイムのライブビューに最適ですが、強力な広告ブロッカーの影響を受けやすい方式です。
• Hybrid モード： 両方式の利点を組み合わせます。軽量なマウス・スクロール座標を WebSocket で送り、滑らかなライブビューを実現します。一方、負荷の大きい DOM の変更とカスタムイベントはバッチ化し、HTTP POST でサーバーサイド GTM を通じて安全に送信します。
• Pure CAPI： 100% HTTP POST のバッチ処理です。プライバシーを最大限に重視し、WebSocket は使わず、完全にファーストパーティーで処理します。 注意：このモードではライブビューは無効です。

2. Google Tag Manager の設定（推奨）

Hybrid または Pure CAPI モードを導入する最も簡単な方法は、当社の公式 GTM コミュニティテンプレートを使うことです。以下の .tpl ファイルをダウンロードし、GTM のワークスペースにインポートしてください。

ステップ1：サーバーサイドのクライアントとタグを設定

サーバーサイド GTM コンテナーに、 Ingest Client テンプレートをインポートします。独自のパス（例： /mp_capi）で待ち受けるように設定します。次に、 Connector Tagをインポートし、次の mouseplayer_batch イベントで発火するよう設定して、コンテナーをデプロイします。

ステップ2：Web GTM タグを設定

Web GTM コンテナーに、 SDK タグをインポートします。タグタイプに「設定と初期化」を選び、 Channel IDを入力し、 Hybrid モードを選択して、ssGTM のエンドポイント URL（例： https://metrics.yourdomain.com/mp_capi）を貼り付けます。

3. 手動インストール（GTM なし）

スクリプトをコードに直接記述する場合は、トラッキングスニペットの読み込み前に、 window.mp_config オブジェクトを定義する必要があります。

4. E コマースファネルのトラッキング

カスタマージャーニー全体を追跡できます。標準化したイベント名を使うと、MousePlayer はプロジェクトのワークスペースに見やすい E コマースファネルレポートを自動生成できます。すべてのイベントは、CAPI モードと Web-Only モードに完全対応しています。

1. view_item

ユーザーが特定の商品ページを閲覧したときに、このイベントを発火させます。

2. add_to_cart

ユーザーが商品をショッピングカートに追加したときに、このイベントを発火させます。

3. begin_checkout

ユーザーがチェックアウト画面に進んだときに、このイベントを発火させます。

4. purchase

決済の成功時、または注文確認時に、このイベントを発火させます。

5. カスタムイベントと見込み客の獲得

E コマースに限りません。フォーム送信、ニュースレター登録、Web アプリケーション独自の操作をトラッキングできます。

見込み客の獲得（フォーム送信）

ユーザーが問い合わせフォームを正常に送信したとき、または見積もりを依頼したときに、このイベントを発火させます。

独自の UI 操作

計算ツール、モーダル、タブ切り替えなど、複雑な要素をユーザーがどう操作するかを把握できます。

6. パラメーターの上限と指針