GTM and GA4 を導入する

[nonz250]

概要

GTM and GA4 を導入する。
envas help として新規 に作成します。

参考

https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-analytics/

[nonz250]

1. Issue の解釈

mkdocs-material 公式ドキュメント（site analytics setup）に沿って、envas help サイトに Google Tag Manager（GTM）と Google Analytics 4（GA4）を新規導入する。GTM コンテナと GA4 プロパティは envas 本体サービスの既存アカウントとは別に、ヘルプサイト専用として新規に作成する。目的はヘルプサイトの閲覧状況やユーザーの検索行動を把握し、コンテンツ改善につなげられるようにすることと解釈した。

2. 受け入れ条件

• 本番サイト（https://help.envas.jp/）の全ページで GTM コンテナが読み込まれる
• GTM 経由で GA4 のページビュー計測が発火し、GA4 のリアルタイムレポートで閲覧が確認できる
• mkdocs-material のサイト内検索イベント計測（GA4 連携時の標準オプション）が有効になっている
• GTM コンテナ ID・GA4 測定 ID が mkdocs.yml またはテーマのカスタムテンプレートに設定され、ローカル開発（docker compose up）・本番ビルド（GitHub Actions の gh-deploy）の両方で正しく反映される

3. 置いた前提

• GTM コンテナ・GA4 プロパティは Issue 本文の指示どおり envas help として新規作成する。既存の envas 本体アプリの GA4/GTM とは別物として扱う
• GTM コンテナ ID（GTM-XXXXXXX）・GA4 測定 ID（G-XXXXXXXXXX）は本 Issue の調査範囲では未発行であり、実装時にユーザー側で発行・提供してもらう前提とする
• これらの ID はブラウザから丸見えになるクライアントサイドの値であり秘匿情報ではないため、GitHub Secrets 経由ではなく mkdocs.yml 等に直接記述してよい。リポジトリが public であることも踏まえた判断
• Cookie 同意バナー（コンセントマネジメント）は Issue で要求されていないため導入しない。mkdocs-material の consent 機能は使わない
• GA4 への個人情報（PII）送信はしない。デフォルト設定のまま利用する

4. 決められなかった点

GTM と GA4 の連携方法

• 選択肢 A: mkdocs-material の標準機能（extra.analytics.provider: google）で GA4 を直接読み込み、GTM は overrides/main.html で <head> に別途追記する。GA4 と GTM が独立して動作する
• 選択肢 B: GTM のみをテーマに追加し、GA4 は GTM の管理画面内でタグとして設定して GTM 経由で発火させる。extra.analytics は使わない
• 推奨: 選択肢 B。GTM 導入の目的はタグの一元管理にあり、GA4 も GTM 配下に置くことで、今後タグを追加・変更する際にコード変更なしで GTM 管理画面から完結できる。Issue タイトルでも GTM が先に挙げられており、GTM 経由での一元管理を意図していると判断した

サイト内検索イベント計測の有効化

• 選択肢 A: 有効化する。検索キーワードを分析でき、FAQ やナビゲーション改善に活用できる
• 選択肢 B: 有効化しない。ページビュー計測のみの最小構成にする
• 推奨: 選択肢 A。ヘルプサイトは検索行動の分析価値が高く、設定コストも数行程度と小さい

5. スコープ外

• GTM コンテナ・GA4 プロパティ自体の作成（Google 管理画面上の作業、ID の発行）
• Cookie 同意バナー等のコンセントマネジメント機能の導入
• GA4 のコンバージョン設定やカスタムイベント設計などの高度な計測設計
• envas 本体アプリケーションへの GTM/GA4 導入（本 Issue はヘルプサイト限定）
• アクセス解析データを用いたダッシュボード作成やレポーティング