GTMクリック計測デバッグチェックリスト: Previewで「発火した」を信じすぎない
SEO Slots
| Slot | Value |
|---|---|
| seo_title | GTM Click Debug Checklist Before GA4 Reporting |
| meta_description | Debug GTM click triggers with a repeatable checklist for Preview mode, GA4 DebugView, duplicate fires, missing labels, and weekly report readiness. |
| slug | gtm-click-debug-checklist |
| primary_query | GTM click debug checklist |
| secondary_queries | GTM preview click trigger, GA4 DebugView click events, GTM click tracking QA |
| search_intent | troubleshooting |
| canonical_path | /resources/click-measurement-lab/gtm-click-debug-checklist/ |
| og_title | GTM Click Debug Checklist Before GA4 Reporting |
| og_description | Debug GTM click triggers with a repeatable checklist for Preview mode, GA4 DebugView, duplicate fires, missing labels, and weekly report readiness. |
Search Intent
troubleshooting. The article must answer the reader's operational question before any commercial route appears.
Reader Artifact
GTM debug failure matrix. This artifact is the reason the article can be saved, cited, or reused by an operator.
Internal Links
- Hub: /resources/click-measurement-lab/
- Related article: /resources/click-measurement-lab/ga4-click-event-baseline/
- Related article: /resources/click-measurement-lab/cta-measurement-map/
- Related article: /resources/click-measurement-lab/event-naming-dictionary/
- Related article: /resources/click-measurement-lab/small-site-measurement-dashboard/
- Tool/service route: /tools/ga4-click-event-checker/
Structured Data
Recommended schema: Article, BreadcrumbList. Keep BreadcrumbList aligned with /resources/click-measurement-lab/gtm-click-debug-checklist/. Do not add Product, Offer, Review, Rating, or FAQPage schema for this wave unless a later approved public page visibly supports it.
CTA Route
Primary route: /tools/ga4-click-event-checker/.
CTA label: Run a static event check before live debug.
CTA family: tool_checker.
Use the checker to catch obvious event-shape problems first, then confirm live behavior in GTM Preview and GA4 DebugView.
The CTA stays measured and specific, with no public payment or account route on this page.
Measurement
| Event | Name |
|---|---|
| event_view_article | view_article_click_measurement_gtm_debug |
| event_click_artifact | click_artifact_click_measurement_gtm_debug |
| event_click_cta | click_cta_click_measurement_gtm_debug |
| utm_policy | No UTM on internal links; campaign UTMs only during approved external distribution. |
Public-Preflight NG Items
- Fake client proof, fake metrics, fake awards, or guaranteed outcomes.
- Public account, form, payment, repo, domain, or outreach route before checks pass.
- Unapproved cross-brand, unrelated monetization, or off-topic trust route.
- Unsupported claims about SEO, ranking, revenue, or tool behavior.
- Machine-like slug, broken internal link, missing schema plan, or missing measurement slot.
問題は「発火した」の後に残る
GTM Previewでタグが発火すると安心しがちです。しかし、クリック計測では「発火した」だけでは不十分です。
確認すべきことは少なくとも次の5つです。
- 正しいクリックで発火したか。
- 余計なクリックで発火していないか。
- 1クリックにつき1回だけ発火したか。
- GA4イベント名とパラメータが意図通りか。
- GA4側で運用レポートに使える形か。
この記事では、GTM Previewでクリック計測を確認するための実務チェックリストをまとめます。
事前準備
デバッグ前に、イベント仕様を1枚にまとめます。
| Item | Example |
|---|---|
| Target page | /resources/click-measurement-lab/cta-measurement-map/ |
| Target element | Article body checker CTA |
| Expected event | click_tool_cta |
| Expected trigger | Link click where target URL contains /tools/ga4-click-event-checker/ |
| Expected tag | GA4 Event - click_tool_cta |
| Required parameters | click_label, click_position, click_target, click_context |
| Should not fire on | Header nav, footer nav, unrelated article links |
これがないと、Preview中に「何となく動いた」だけで終わります。
GTM Preview Checklist
| Step | Check | Pass condition | Failure signal |
|---|---|---|---|
| 1 | Preview接続 | 対象ページがPreviewセッションに接続される | Tag Assistantがページを認識しない |
| 2 | 初期表示 | ページロード時にクリックタグが発火しない | click系タグがPage Viewで発火する |
| 3 | 対象クリック | クリック時に想定タグが発火する | Tags Firedに出ない |
| 4 | 発火回数 | 1クリックで1回だけ発火する | 2回以上発火する |
| 5 | 非対象クリック | 類似リンクで発火しない | ナビや別CTAでも発火する |
| 6 | Variables | Click URL / Text / Classesが想定通り | 変数が空、別要素を拾う |
| 7 | GA4 parameter | イベントパラメータが仕様通り | labelやtargetが空 |
| 8 | DebugView | GA4側でイベントとパラメータが見える | イベント名だけ見えてパラメータが欠ける |
| 9 | Report readiness | カスタム定義・探索で使える項目が決まる | 見えているが分析できない |
Debug Failure Matrix
| Symptom | Likely cause | What to inspect first |
|---|---|---|
| タグが発火しない | トリガー条件が狭すぎる | Click URL, Click Classes, Just Links設定 |
| どのクリックでも発火する | トリガー条件が広すぎる | Some Link Clicks / CSS selector |
| 1クリックで2回発火する | 複数タグ・複数トリガー・SPA再実行 | Tags Fired count, History Change |
click_label が空 | 変数参照ミス、dataLayer値なし | Variables tab, dataLayer event payload |
| DebugViewに出ない | GA4設定タグ、Measurement ID、同意状態 | GA4 config, consent, network request |
| DebugViewには出るがレポートで使えない | カスタム定義未設定、低ボリューム、時間差 | Custom definitions, Explore,翌日確認 |
dataLayerイベントを使う場合の確認
dataLayer方式は安定しやすい一方で、イベント名や値の破綻がそのままGTMに入ります。
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
event: "click_tool_cta",
click_label: "Run GA4 click-event checker",
click_position: "article_body",
click_target: "/tools/ga4-click-event-checker/",
click_context: "gtm_click_debug_checklist"
});GTM Previewでは、左側のイベント一覧に click_tool_cta が出ているかを見ます。そのイベントを選び、Variablesで必要な値が入っているかを確認します。
静的チェックを先に入れる
Previewの前に、スニペット自体の破綻を見つけると調査が短くなります。
D02チェッカーの公開予定位置:
/tools/ga4-click-event-checker/チェッカーで見るべき項目:
eventが文字列か。click_命名に合っているか。click_label、click_position、click_targetがあるか。- 値が空でないか。
- 測定IDらしき値が壊れていないか。
- 目に見えない文字が混ざっていないか。
このチェックを通っても、ライブ発火は別途確認が必要です。静的チェック、GTM Preview、GA4 DebugViewの3つは役割が違います。
Debug Log Template
デバッグ結果は、後から見返せる形で残します。
| Date | Page | CTA | Expected event | Preview result | DebugView result | Issue | Next action |
|---|---|---|---|---|---|---|---|
| YYYY-MM-DD | /resources/.../ | Article checker CTA | click_tool_cta | Fired once | Event and params visible | None | Recheck in report tomorrow |
| YYYY-MM-DD | /services/ | Diagnostic CTA | click_diagnostic_cta | Fired twice | Duplicate event | Trigger overlap | Narrow selector |
このログは、被リンクされやすい実務テンプレにもなります。特に代理店や小規模チームでは、「誰が何を確認したか」を残せるだけで再現性が上がります。
Natural CTA
GTM Previewで原因が見えないときほど、最初のスニペット形状に戻ってください。D02チェッカーは公開後、次の位置に置く想定です。
/tools/ga4-click-event-checker/
静的チェックで問題が出なければ、GTM Previewのトリガー条件、Variables、GA4タグ設定へ進みます。静的チェックで問題が出るなら、Previewの前に仕様を直した方が早いです。
Quality Checklist
- 対象クリックと非対象クリックの両方を確認した。
- 1クリック1発火を確認した。
- Page View時にclick系タグが発火していない。
- Variablesで必須パラメータを確認した。
- GA4 DebugViewでイベント名だけでなくパラメータまで見た。
- デバッグログに結果と次アクションを残した。
- 静的チェック、Preview、DebugViewの役割を混同していない。
Public-Preflight NG Items
- Previewで発火しただけで「計測完了」と書く。
- GA4 DebugViewに表示されない原因を1つに断定する。
- 読者のGTM/GA4ログインや認証情報提出を求める。
- D02チェッカーをライブ検証ツールのように説明する。
- 架空の改善率や作業時間短縮率を実績として書く。