GA4クリックイベント命名辞書: 後から壊れない名前とパラメータの決め方
SEO Slots
| Slot | Value |
|---|---|
| seo_title | Event Naming Dictionary for CTA and Click Tracking |
| meta_description | Create a stable event naming dictionary for CTA clicks, downloads, outbound links, lead actions, reporting labels, and future QA handoffs. |
| slug | event-naming-dictionary |
| primary_query | event naming dictionary |
| secondary_queries | GA4 event naming convention, CTA event names, click event parameters |
| search_intent | informational |
| canonical_path | /resources/click-measurement-lab/event-naming-dictionary/ |
| og_title | Event Naming Dictionary for CTA and Click Tracking |
| og_description | Create a stable event naming dictionary for CTA clicks, downloads, outbound links, lead actions, reporting labels, and future QA handoffs. |
Search Intent
reference. The article must answer the reader's operational question before any commercial route appears.
Reader Artifact
event naming dictionary table. 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/gtm-click-debug-checklist/
- 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/event-naming-dictionary/. 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: Check one event name against the baseline.
CTA family: tool_checker.
Use the checker after choosing a name to catch machine-like labels, missing parameters, and inconsistent CTA fields before implementation.
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_naming_dictionary |
| event_click_artifact | click_artifact_click_measurement_naming_dictionary |
| event_click_cta | click_cta_click_measurement_naming_dictionary |
| 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.
命名辞書がない計測は、時間が経つほど読めなくなる
クリック計測は、実装直後よりも3か月後に問題が出ます。
担当者が変わる。CTAが増える。記事やLPが増える。以前の contact_click と新しい click_contact_cta が混ざる。レポート上では似たイベントが並び、どれを見ればよいか分からなくなる。
命名辞書は、この崩れを防ぐための小さなルールブックです。目的は、厳格なデータガバナンス資料を作ることではありません。小規模サイトでも「この名前なら比較できる」と判断できる状態を保つことです。
命名の基本ルール
クリックイベントは次の形に寄せます。
click_{object}_{intent}
例:
click_contact_cta
click_tool_cta
click_download_template
click_outbound_reference
click_mailto_contact
避ける名前:
click
button_click
cta1
ClickContact
hero_button_202605
命名の判断基準は、GA4のイベント一覧に並んだ時に意味が分かることです。CSSクラスや実装順ではなく、ユーザー行動の意味で名前を付けます。
Event Naming Dictionary Template
| Event name | Use when | Required parameters | Optional parameters | Do not use for |
|---|---|---|---|---|
click_contact_cta | 通常の問い合わせCTA | click_label, click_position, click_target | offer_context, page_type | 診断結果後の専用CTA |
click_diagnostic_cta | 計測診断への相談CTA | click_label, click_position, click_target | issue_context, tool_context | 一般問い合わせ |
click_tool_cta | チェッカー・診断ツールへの導線 | click_label, click_position, click_target | click_context, tool_name | ダウンロード |
click_download_template | テンプレやチェックリスト取得 | click_label, click_position, click_target | template_name, template_category | 外部参考リンク |
click_outbound_reference | 参考資料・外部サイトへのリンク | click_label, click_position, click_target | reference_type | 広告・アフィリエイト導線 |
click_mailto_contact | メールリンク | click_label, click_position, click_target | mail_context | フォーム送信 |
この辞書は、記事やLPを増やすたびに追記します。イベント名を増やすより、既存イベントに適切なパラメータを足せないかを先に考えます。
Parameter Dictionary
| Parameter | Type | Allowed examples | Bad examples | Notes |
|---|---|---|---|---|
click_label | string | Hero contact CTA, Article checker CTA | btn1, red | 画面上の意味に近い名前 |
click_position | string | header, hero, article_body, footer, result_panel | upper, somewhere | 固定語彙にする |
click_target | string | /contact/, /tools/ga4-click-event-checker/ | next, link | URLや対象先 |
click_context | string | ga4_baseline_article, dashboard_article | misc | 記事や企画の文脈 |
issue_context | string | static_checker_failed, duplicate_fire_suspected | pasted snippet | 入力本文は入れない |
template_name | string | cta_measurement_map | file1 | テンプレ識別 |
固定語彙リスト
click_position は特に揺れやすいので、先に許可値を決めます。
| Position value | Definition |
|---|---|
header | グローバルヘッダー、ナビ付近 |
hero | ページ冒頭の主要CTA |
article_body | 記事本文内 |
article_end | 記事末尾 |
result_panel | ツール結果表示付近 |
pricing_section | 料金・サービス説明付近 |
footer | フッター |
modal | モーダル内 |
新しい値を足す条件は、週次レポートで比較したい配置であることです。見た目の細かい都合だけで増やすと、後から集計が散らばります。
変更管理ルール
命名辞書には「追加」「変更」「廃止」のルールが必要です。
| Change type | Rule | Example |
|---|---|---|
| Add | 既存イベントで表現できない行動だけ追加 | 新しいツール導線として click_tool_cta を追加 |
| Rename | 原則避ける。必要なら旧名と新名の対応表を残す | contact_click -> click_contact_cta |
| Deprecate | 使わなくなったイベントは辞書に廃止日を書く | button_click deprecated after YYYY-MM-DD |
| Parameter add | 既存レポートを壊さない範囲で追加 | tool_name を任意追加 |
実装前レビューの質問
新しいクリックイベントを追加する前に、次の質問に答えます。
- これは既存イベント名で表現できない行動か。
- イベント名に位置や色を入れすぎていないか。
- 必須パラメータだけで最低限の分析ができるか。
- 任意パラメータに個人情報や入力本文が入らないか。
- GTM Previewで発火確認できる設計か。
- GA4 DebugViewで見た後、週次レポートでも使う予定があるか。
D02チェッカーとの使い分け
命名辞書は設計ルールです。D02チェッカーは、実際のスニペットがそのルールに近い形になっているかを静的に確認するための道具です。
公開予定プレースホルダ:
/tools/ga4-click-event-checker/
チェッカーで分かること:
- イベント名が
click_形式か。 - 必須パラメータがあるか。
- 値が空ではないか。
- 見えない文字など明らかな破綻がないか。
チェッカーで分からないこと:
- そのイベント名が事業上よい設計か。
- GTMトリガーが正しいか。
- GA4レポートで意思決定に使われているか。
- 同意管理やプライバシー要件を満たしているか。
Naming Dictionary Starter
最初の公開時は、次の辞書だけで十分です。
| Name | Status | Owner | Notes |
|---|---|---|---|
click_tool_cta | Active | Measurement owner | 記事からツールへ進む導線 |
click_diagnostic_cta | Active | Measurement owner | 問題発見後の相談導線 |
click_contact_cta | Active | Measurement owner | 汎用問い合わせ |
click_download_template | Active | Measurement owner | テンプレ取得 |
click_outbound_reference | Active | Measurement owner | 外部参考リンク |
辞書は短く始めて構いません。大切なのは、増やす前に既存名を確認する習慣です。
Natural CTA
命名辞書を決めたら、代表的な dataLayer.push 例をD02チェッカーへ通す想定です。
/tools/ga4-click-event-checker/
NGが出た場合は、辞書のルールとスニペットのどちらがずれているのかを分けて確認します。
Quality Checklist
- クリックイベント名の形が決まっている。
- 必須パラメータ名が決まっている。
click_positionの固定語彙がある。- 新規イベント追加前のレビュー質問がある。
- 廃止イベントの扱いが決まっている。
- D02チェッカーの役割を「静的確認」に限定して説明している。
- 個人情報や入力本文をパラメータに入れない方針が明記されている。
Public-Preflight NG Items
- 命名辞書を作れば自動的に成果が上がると書く。
- 大文字、日本語、空白を含むイベント名を標準として推奨する。
- 読者の実データや顧客名を辞書例に入れる。
- チェッカーが命名戦略まで判断すると書く。
- 未承認のサービス価格や確定していない公開URLを書く。