シフト作成サービス Shift Bud のアプリで、page_view を自前で送る形に切り替えた。テストは全部通っている。切り替えたあとの確認として予定していたとおり、GA4 の DebugView を開き、アプリの中で画面を 2 つ移った。
移った先の page_view を開くと、page_location は最初に開いた画面の URL のままだった。画面は確かに変わっているのに、GA4 の中では一歩も動いていない。日別のデータを見直すと、切り替えた日を境に、それまで十ほどの画面に散らばっていたパスが、最初に開く /shifts の 1 種類に揃っていた。
件数は減っていない。合計だけを見ている人には、何も起きていないように見える壊れ方だった。
クエリを除いた URL を config と set の両方に渡していた
切り替えの目的は、URL からクエリを除いて送ることだった。アプリには、メールの認証リンクや Google ログインの戻り先のように、クエリに認証トークンや氏名が載る画面がある。gtag.js の自動送信に任せると、それがクエリごと GA4 に届く。そこで自動送信を止め、クエリを除いた URL を自分で渡した。
// 最初の 1 回だけ
gtag('config', GA_ID, { send_page_view: false, page_location: clean(location.href) });
// 初回表示と、画面遷移のたびに
gtag('set', { page_location: clean(location.href), page_referrer: previousLocation });
gtag('event', 'page_view');
clean() はクエリからトークンや氏名を取り除く関数だ。テストでも「config は send_page_view: false とクエリを除いた page_location を持つ」ことを確かめていた。
送られていたのは最初の画面の URL
dataLayer を覗くと、遷移のたびに積まれる set には遷移先の URL がちゃんと入っていた。アプリは正しい値を渡しているのに、GA4 には届いていない。
本番のアプリを headless Chrome で開き、シフト表から休み希望の画面へ移ったときに出ていく page_view のリクエストを捕まえた。dl が page_location、dr が page_referrer だ。
dl(page_location) | dr(page_referrer) | |
|---|---|---|
config に page_location を書いたまま | 最初に開いた画面(シフト表) | シフト表 |
config から page_location を外す | 休み希望(遷移先) | シフト表 |
違いは config に書いたかどうかだけだ。gtag.js のリファレンスに優先順位があり、event の引数が config に勝ち、config が set に勝つ。config に書いた値は、そのあと何度 set し直しても負けない。page_referrer は config に書いていなかったので、set の値が通った。
紛らわしいのは、設定パラメータのリファレンスが set と config の例を同じ値で並べていることだ。ページを読み込み直すサイトなら、どちらで書いても結果は変わらない。読み込み直さないアプリでだけ、config の値が最初の画面で固まる。
被害は page_view にとどまらない。set の値はカスタムイベントにも使われるので、ボタンを押した、シフトを確定した、といったイベントも全部最初の画面で起きたことになっていた。アクティベーションのイベント設計で組んだ段ごとのイベントは、件数はそのままで、どの画面で起きたかだけを失っていた。
テストも助けにならなかった。見ていたのは dataLayer に積まれた値だけで、config が page_location を持つことはテストの期待値そのものだった。誰かが気付いて 1 行消していたら、テストが赤くなって止めていたはずだ。
送られた値を見る 3 つの手順
dataLayer を見るテストでも、件数の合計でも、この罠は捕まらない。page_view を自前で送っているなら、画面を移ったあとに実際に送られた値を見る。
- DebugView で、遷移ごとの page_location を見る。 画面を 2 つ以上移り、それぞれの page_view が移った先の URL になっているかを見る。Tag Assistant で debug mode を有効にしてから操作する。
- ブラウザで
dlを見る。 DevTools の Network をcollectで絞り、アプリ内のリンクで移る。移ったあとの page_view のdlが移った先でなければこの罠だ。なお拡張計測の「ブラウザの履歴イベントに基づくページの変更」が有効だと、GA4 側でも page_view が送られる(公式ガイド)。自前で送るなら切っておく。 - コンソールで、
configに何を渡したかを見る。 標準のスニペットで入れているなら、次の 1 行で出る。
Array.from(dataLayer).filter((a) => a[0] === 'config').map((a) => a[2])
// 罠あり → [{ send_page_view: false, page_location: 'https://…' }]
// 罠なし → [{ send_page_view: false }]
直し方は、config から page_location を外すだけだ。
- gtag('config', GA_ID, { send_page_view: false, page_location: clean(location.href) });
+ gtag('config', GA_ID, { send_page_view: false });
最初の page_view の手前でも set を積んでいるので、クエリを除く処理は抜けない。Google ログインの戻り先を直接開いて確かめると、外す前も外したあとも、page_view はクエリの無い URL で送られていた。テストの期待も反転させ、「config は send_page_view: false だけを持ち、page_location は set で渡す」にした。
1 行は直せても、壊れた期間は戻らない
ここまでは、gtag.js を自分で書いた開発者なら手元で完結する。手間がかかるのは、直したあとだ。
| やること | 自分でできるか | うちで詰まったところ |
|---|---|---|
config から 1 行消し、上の 3 手順で確かめる | できる | なし |
| 壊れた期間を特定する | できる。探索でイベント名を page_view に絞り、「ページパスとスクリーン クラス」を日付と並べる | 件数が減らないので、パスの種類が急に減った日を探すしかない |
| 壊れた期間のレポートをどう扱うか決める | 数字を使う人との相談が要る | 送られたデータは GA4 では直せない。画面別の比較からその期間を外すか、注記して使うかを決める |
| URL から個人情報を除く処理を保つ | 罠を外すときに一緒に壊しやすい | 直した版で、トークンの載る画面を直接開いて確かめ直した |
| 送られた値の確認を、次の変更でも回るようにする | 仕組みづくりが要る | dataLayer を見るテストだけでは足りず、リリース後の確認手順に DebugView を入れた |
うちが数日で気付けたのは、切り替え後に DebugView で見ると最初から決めていたからだ。その確認が無ければ、月次の画面別レポートを作る人が「最近 /shifts しか使われていない」と読むまで、誰も気付かなかったと思う。
まとめ
- 画面遷移の page_view を自前で送るなら、
page_locationはsetで渡し、configには書かない。読み込み直さないアプリではconfigの値が最初の画面で固まる。 dataLayerの値が正しくても、送られる値が正しいとは限らない。画面を 2 回以上移って、送られた page_location を見る。- 直したあとは、壊れていた期間を特定し、その期間のレポートをどう扱うかを数字を使う人と決める。
playpark では、SPA や Next.js のアプリで、GA4 に「何が送られているか」の点検と、page_view・カスタムイベントの送り方の修正を引き受けています。壊れていた期間の特定と、レポートでの扱いの整理まで一緒にやります。
相談するときは、GA4 の入れ方(gtag.js 直書きか GTM か)、フレームワーク、おかしいと感じたレポートと時期を書いてもらえると、最初の返信から原因の見当を付けて話せます。



