GA4クリックイベント命名辞書: 後から壊れない名前とパラメータの決め方

SEO Slots

SlotValue
seo_titleEvent Naming Dictionary for CTA and Click Tracking
meta_descriptionCreate a stable event naming dictionary for CTA clicks, downloads, outbound links, lead actions, reporting labels, and future QA handoffs.
slugevent-naming-dictionary
primary_queryevent naming dictionary
secondary_queriesGA4 event naming convention, CTA event names, click event parameters
search_intentinformational
canonical_path/resources/click-measurement-lab/event-naming-dictionary/
og_titleEvent Naming Dictionary for CTA and Click Tracking
og_descriptionCreate 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

EventName
event_view_articleview_article_click_measurement_naming_dictionary
event_click_artifactclick_artifact_click_measurement_naming_dictionary
event_click_ctaclick_cta_click_measurement_naming_dictionary
utm_policyNo 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 nameUse whenRequired parametersOptional parametersDo not use for
click_contact_cta通常の問い合わせCTAclick_label, click_position, click_targetoffer_context, page_type診断結果後の専用CTA
click_diagnostic_cta計測診断への相談CTAclick_label, click_position, click_targetissue_context, tool_context一般問い合わせ
click_tool_ctaチェッカー・診断ツールへの導線click_label, click_position, click_targetclick_context, tool_nameダウンロード
click_download_templateテンプレやチェックリスト取得click_label, click_position, click_targettemplate_name, template_category外部参考リンク
click_outbound_reference参考資料・外部サイトへのリンクclick_label, click_position, click_targetreference_type広告・アフィリエイト導線
click_mailto_contactメールリンクclick_label, click_position, click_targetmail_contextフォーム送信

この辞書は、記事やLPを増やすたびに追記します。イベント名を増やすより、既存イベントに適切なパラメータを足せないかを先に考えます。

Parameter Dictionary

ParameterTypeAllowed examplesBad examplesNotes
click_labelstringHero contact CTA, Article checker CTAbtn1, red画面上の意味に近い名前
click_positionstringheader, hero, article_body, footer, result_panelupper, somewhere固定語彙にする
click_targetstring/contact/, /tools/ga4-click-event-checker/next, linkURLや対象先
click_contextstringga4_baseline_article, dashboard_articlemisc記事や企画の文脈
issue_contextstringstatic_checker_failed, duplicate_fire_suspectedpasted snippet入力本文は入れない
template_namestringcta_measurement_mapfile1テンプレ識別

固定語彙リスト

click_position は特に揺れやすいので、先に許可値を決めます。

Position valueDefinition
headerグローバルヘッダー、ナビ付近
heroページ冒頭の主要CTA
article_body記事本文内
article_end記事末尾
result_panelツール結果表示付近
pricing_section料金・サービス説明付近
footerフッター
modalモーダル内

新しい値を足す条件は、週次レポートで比較したい配置であることです。見た目の細かい都合だけで増やすと、後から集計が散らばります。

変更管理ルール

命名辞書には「追加」「変更」「廃止」のルールが必要です。

Change typeRuleExample
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

最初の公開時は、次の辞書だけで十分です。

NameStatusOwnerNotes
click_tool_ctaActiveMeasurement owner記事からツールへ進む導線
click_diagnostic_ctaActiveMeasurement owner問題発見後の相談導線
click_contact_ctaActiveMeasurement owner汎用問い合わせ
click_download_templateActiveMeasurement ownerテンプレ取得
click_outbound_referenceActiveMeasurement owner外部参考リンク

辞書は短く始めて構いません。大切なのは、増やす前に既存名を確認する習慣です。

Natural CTA

命名辞書を決めたら、代表的な dataLayer.push 例をD02チェッカーへ通す想定です。

/tools/ga4-click-event-checker/

NGが出た場合は、辞書のルールとスニペットのどちらがずれているのかを分けて確認します。

Quality Checklist

  • クリックイベント名の形が決まっている。
  • 必須パラメータ名が決まっている。
  • click_position の固定語彙がある。
  • 新規イベント追加前のレビュー質問がある。
  • 廃止イベントの扱いが決まっている。
  • D02チェッカーの役割を「静的確認」に限定して説明している。
  • 個人情報や入力本文をパラメータに入れない方針が明記されている。

Public-Preflight NG Items

  • 命名辞書を作れば自動的に成果が上がると書く。
  • 大文字、日本語、空白を含むイベント名を標準として推奨する。
  • 読者の実データや顧客名を辞書例に入れる。
  • チェッカーが命名戦略まで判断すると書く。
  • 未承認のサービス価格や確定していない公開URLを書く。