実装を検証する

イベントの検証が済んだら、実装を検証する必要があります。検証サーバーではイベントが正しい構造になっていることが検証されますが、それらが正しくプロパティに送信されていることを確認するには、以下を行う必要があります。

これらの手順を行ってもイベントが表示されない場合は、トラブルシューティングで実装に関する一般的なエラーをご確認ください。

クライアントからイベントを送信する

クライアントを選択してください。

イベントが有効になるには、gtag.js からイベントを送信するためにすでに使用されている client_id を持っている必要があります。この ID をクライアントサイドで取得し、Measurement Protocol の呼び出しに追加します。プロパティにイベントを送信する際には、"client_id" が client_id として使用されます。「client_id」with a realclient_idfromgtag.js を置き換える必要があります。

プロパティにイベントを送信する

クライアントからイベントを送信し、有効な client_id を取得したら、Measurement Protocol を使ってイベントを送信できるようになります。実装を検証する際は、Measurement Protocol を使って測定しようとしているイベントを送信する必要があります。

たとえば、以下の例では refund イベントが送信されます。

const measurementId = `<measurement_id_value>`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "XXXXXXXXXX.YYYYYYYYYY",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "value": "9.99",
        "transaction_id": "ABC-123"
      }
    }]
  })
});

リアルタイム ビューを確認する

Measurement Protocol を使ってイベントを送信したら、リアルタイム ビューでプロパティを確認します。通常、イベントは数秒以内に表示されます。

Google アナリティクスを開き、左側のナビゲーションで [レポート] > [リアルタイム] に移動して、リアルタイム ビューに移動します。「イベント名別のイベント数」や「イベント名別のキーイベント」など、下部のグラフに注目します。

イベントを表示しているリアルタイム ビュー

DebugView を確認する

実装を検証するのに十分な詳細情報がリアルタイム ビューで表示されない場合は、params コレクションに次のパラメータを指定して、一部のテストイベントでデバッグモードを有効にします。これにより、DebugView でイベントのモニタリングと確認を行うことができます。

  1. "debug_mode": true または "debug_mode": 1
  2. "engagement_time_msec" を正の数に設定しました

次の例では、デバッグモードを有効にして払い戻しを送信します。

const measurementId = `<measurement_id_value>`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "XXXXXXXXXX.YYYYYYYYYY",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "value": "9.99",
        "transaction_id": "ABC-123",
        "engagement_time_msec": 1200,
        "debug_mode": true
      }
    }]
  })
});

デバッグモードを有効にしてイベントを送信したら、DebugView を使用したイベントのモニタリングの手順に沿って実装を確認します。