ヘッドレスサイトでGA4のコンバージョンを正しく記録する設計

このテーマで扱う範囲

ヘッドレスECでは、商品閲覧からカートまでは自社フロントで計測できても、決済画面遷移後にコンバージョン計測が欠けることがあります。
このシリーズでは、欠損ポイントの把握 → 識別子の引き継ぎ → 決済後のサーバー送信までを一連の設計としてまとめます。

先に結論

購入CVを安定して取るには、次の3段をセットで設計します。

1. 欠損が起きる境界を明確化する
2. 遷移前に識別子を注文に引き継げる場所へ保存する
3. 決済完了イベントをWebhook起点でGA4へ送信する

全体フロー（概要）

詳しく知りたい方へ

実装工程ごとに、以下の3記事で分けて解説しています。上から順番に読むと、設計判断から実装まで流れで理解できます。

セキュリティと運用上の前提

• 実運用の環境変数名やキー名は公開しない
• 管理系APIは必ず認証を掛ける
• 失敗時はチェックアウトを止めない（fail-open）
• ログには個人情報・トークン類を残さない

以下のサブトピックで、各工程を順に解説します。