HugoでUAからGA4に移行する対応を行う

こんばんは。2023年7月までにUAからGA4に移行する必要があるみたいですが、対応の手順がよくわかりませんでしたので調べて対応しました。ので残しておきます

久しぶりにGoogleAnalyticsを見てみたら、勝手にGA4のストリームができていました。
これはGoogle的には「こっちにストリームを切り替えてくれよ」と言うことなのかとエスパーして、ググってうまい具合に対応しました。

Hugoではtemplateが用意されているのでやることは割と簡単です。
まずはconfig.tomlで以下を追記します。すでにUAを設定されている場合は上書きしてください

googleAnalytics = "G-XXXXX"

あとは、htmlのheadに以下を記述するだけです。具体的なファイルパスはHugoのthemeによって異なる?と思います。僕が使ってるbeautifulhugoだとthemes/beautifulhugo/layouts/partials/head.htmlでした。

{{ template "_internal/google_analytics.html" . }}

僕の環境だと、以下のasync版を利用していたのですが、これはGA4に対応していないようなので正しくscriptタグが出力されません。

{{ template "_internal/google_analytics_async.html" . }}

https://gohugo.io/templates/internal/#use-the-google-analytics-template

これで対応が完了です。
念の為、サイトをブラウザで開いて、GAの画面でリアルタイムレポートに1ユーザー以上出てくることを確認したほうが良いです。

ページビューや記事の閲覧数ぐらいがわかれば十分なノリでGAをやっている人にとってはGAのダッシュボードが固有名詞のオンパレードでわかりにくかったです、、概念の説明が欲しい。。。

tech  hugo 

See also