Next.js のサイトに Google Tag Manager 経由でGoogle Analytics(GA4)を導入する

はじめに

このサイトのアクセス解析をするために Google Analytics を設置した。他にも同等な記事は検索するとよく見つかるが、下記の課題があった。

  • 直接 Google Analytics を使うのか、Google Tag Manager 経由で Google Analytics を使うのか
  • GA4, UA どちらを使っているか

というのがパット見で分かりづらかった。そういう経緯もありタイトルが長くなってしまった。 また、今回は Next.js v12 , TypeScript 環境下で動作させている。

TL;DR

この通りにやったらほぼできた。(@keita さんに感謝)

Next.js で GTM + GA4 を利用する

途中に出てくるコードもかなり参考にさせていただいたことも、先に述べておく。

また Next.js に慣れていないと言うこともあり Google Tag Manager を設置する過程で勉強になったことも挟んでいきたい。

Google Analytics 側の作業

事前に Google Analytics でアカウントを作成し、G- から始まる測定 ID を取得しておく必要がある。下記の手順で測定 ID を取得できる。

  1. アナリティクスホーム からアカウントを作成

アカウント作成

  1. プロパティを作成

プロパティ作成

  1. データストリームを設定

プラットフォームに「ウェブ」を選択し、任意のウェブサイトの URL を入力する。

データストリームを設定

Google Tag Manager 側の作業

  1. タグマネージャーホーム よりアカウントの作成

コンテナ設定では  Google Analytics 同様にウェブを選択し、 URL を入力する。

アカウント作成

  1. 「新しくタグを追加」より「Google アナリティクス: GA4 設定」を選択

GA4 用タグ追加

  1. 取得した Google Analytics の測定 ID を入力

測定 ID 取得

ここまでできれば事前準備は完了なので、後はコードを書いていく。

Google Tag Manager コンポーネントの作成

まずは Google Tag Manager の Script を埋め込むためのコンポーネント作成する。

components/GoogleTagManager.tsx
import Script from 'next/script'
import { FC } from 'react'

export type GtmId = `GTM-${string}`

type Props = {
  gtmId: GtmId
}

const GoogleTagManager: FC<Props> = ({ gtmId }) => {
  return (
    <Script
      id="gtm"
      strategy="afterInteractive"
      dangerouslySetInnerHTML={{
        __html: `
        (function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);})(window,document,'script','dataLayer','${gtmId}');
        `
      }}
    />
  )
}

export default GoogleTagManager

_app.tsx で読み込み

Google Tag Manager を見ると、このコードは、次のようにページの <head> 内のなるべく上のほうに貼り付けてください。 と書いてあるので、 てっきり _document.tsx の <Head> の中に書くのかなと思っていたが、どうやら違うらしい。

公式ドキュメントを見ると分かる通り、next/script は _app.tsx に書きなさいとのこと。

script-in-document-page | Next.js

pages/_app.tsx
import GoogleTagManager, { GtmId } from '@/components/GoogleTagManager'
import { gtmId } from '@/lib/utils/gtm'

export default function App({ Component, pageProps }: AppProps) {
  return (
    <ThemeProvider>
      <GoogleTagManager gtmId={gtmId as GtmId} />
      <LayoutWrapper>
        <Component {...pageProps} />
      </LayoutWrapper>
    </ThemeProvider>
  )
}

Google Tag Manager へ情報を渡す dataLayer を使えるように window interface を拡張する。

lib/utils/gtm.ts
export const gtmId = process.env.NEXT_PUBLIC_GTM_ID || ''

declare global {
  interface Window {
    dataLayer: Record<string, unknown>[]
  }
}

Google Tag Manager の ID は、NEXT_PUBLIC_ プレフィックスを使用して、ビルド時に参照する。(プレフィックスなしの process.env.HOGE_FUGA はサーバーサイドでのみ参照できる)

.env
NEXT_PUBLIC_GTM_ID=GTM-XXXXXX

Google Tag Manager のデバッグ

ここまでできたら、ローカルサーバを起動して読み取りされる状態になっているか確認する。毎回この手のアクセス解析ツールのデバッグには苦労していたが、Tag Assistant を使えば楽に検証できた。Google Tag Manager のワークスペース画面よりプレビューボタンを押すと起動できるようになっている。

正しくタグを読み取れるようになっていれば、下記みたいに GA4 が検出されるはずだ。

プレビュー画面

GTM デバック画面

まとめ

Next.js + TypeScript で作っているこのサイトに Google Tag Manger を導入した。これで管理画面からポチポチとやるだけで設定を変えることができるようになった。

参考

Next.js で GTM + GA4を利用する
Next.js で GTM + GA4を利用する favicon zenn.dev
Next.js で GTM + GA4を利用する
Next.js に Google Tag Manager + Google Analytics 4 を導入するための整理
Next.js に Google Tag Manager + Google Analytics 4 を導入するための整理 favicon zenn.dev
Next.js に Google Tag Manager + Google Analytics 4 を導入するための整理
Next.jsでGoogle Analyticsを使えるようにする - パンダのプログラミングブログ
Next.jsはVercelが作成しているReactのフレームワークです。面倒な設定を書かなくてもすぐに使えるZero Configを標榜しており、実際にwebpackやTypeScriptと一緒にReactを書く際にも特別な準備は不要です。
Next.jsでGoogle Analyticsを使えるようにする - パンダのプログラミングブログ favicon panda-program.com
Next.jsでGoogle Analyticsを使えるようにする - パンダのプログラミングブログ
Next.js&GoogleAnalytics設定
Next.js&GoogleAnalytics設定 favicon zenn.dev
Next.js&GoogleAnalytics設定