google-analytics

Google Analytics 4

GA4 采用事件模型：每次互动都是一个带有参数的事件。对于快速入门以外的问题，请根据下面的决策树选择参考资料，并在回答前阅读。

随附的 analytics-mcp 服务（Google 官方 GA MCP）为只读：它会运行 Data API 报告、漏斗和实时报告，并读取账号、媒体资源、自定义定义和 Google Ads 链接详情。使用它回答有关 GA4 实时数据的问题；配置更改需在 GA4 界面中进行，或通过此服务之外的 Admin API 进行。

快速入门

1. 创建媒体资源： analytics.google.com -> Admin -> Create -> Property
2. 创建数据流： 添加 Web 数据流，并记下 Measurement ID（G-XXXXXXXXXX）
3. 安装跟踪代码（任选一种）：
   • GTM（推荐）： 安装容器，使用 Measurement ID 创建 Google Tag，将触发条件设为 All Pages，然后发布
   • 直接使用 gtag.js：

     <script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
     <script>
       window.dataLayer = window.dataLayer || [];
       function gtag(){dataLayer.push(arguments);}
       gtag('js', new Date());
       gtag('config', 'G-XXXXXXXXXX');
     </script>
     

4. 验证： 启用 GA Debugger 扩展程序，在 Admin -> DebugView 中检查 session_start、page_view
5. 发送自定义事件：

   gtag('event', 'button_click', { button_name: 'Subscribe', button_location: 'header' });
   

决策树：我需要哪份参考资料？

What are you trying to do?

Setting up GA4 for the first time?         -> references/setup.md
Understanding how events work?              -> references/events-fundamentals.md
Implementing standard tracking events?      -> references/recommended-events.md
Creating business-specific custom events?   -> references/custom-events.md
Making parameters appear in reports?        -> references/custom-dimensions.md
Implementing User ID / cross-device?        -> references/user-tracking.md
Building audiences for remarketing?         -> references/audiences.md
Analysing data in GA4 reports?              -> references/reporting.md
Linking BigQuery / export schema?           -> references/bigquery.md
Querying export data with SQL?              -> the bigquery skill
Installing via gtag.js directly?            -> references/gtag.md
Setting up GA4 in Google Tag Manager?       -> references/gtm-integration.md
Sending events from server/backend?         -> references/measurement-protocol.md
Testing and debugging implementation?       -> references/debugview.md
Implementing GDPR/Consent Mode?             -> references/privacy.md
Configuring Admin settings?                 -> references/data-management.md

核心概念

事件模型

GA4 将所有数据都作为以下四类事件进行跟踪：

类别	说明	示例
自动	无需配置即可触发	session_start, first_visit
增强型衡量	可在设置中启用或停用	scroll, click, file_download
推荐	Google 定义的标准参数事件	purchase, login, sign_up
自定义	针对业务的跟踪	demo_requested, trial_started

主要限制

限制	值
不同事件名称数	每个应用数据流 500 个（Web 数据流不限）
每个事件的参数数	25
事件名称长度	40 个字符
参数名称／值长度	40／100 个字符（page_location 为 1,000）
自定义维度（事件／用户／商品）	50／25／10
每个媒体资源的受众数	100

Measurement ID

• 格式：G-XXXXXXXXXX（G- 前缀 + 10 个字母数字字符）
• 位置：Admin -> Data Streams -> Web Stream
• 用途：gtag.js 配置、GTM 标记、Measurement Protocol

常见工作流

电商跟踪

1. 查看推荐事件，了解购买漏斗：view_item -> add_to_cart -> begin_checkout -> purchase
2. 构建 items 数组（必填：item_id 或 item_name；推荐：price、quantity、item_category）
3. 使用 DebugView 测试，然后将自定义商品参数注册为自定义维度

跨设备跟踪

1. 实施 User ID，并配置 Reporting Identity（Admin -> Data Settings）
2. 设置用户属性，并构建跨设备受众

GDPR 合规

1. 设置 [Consent Mode] (references/privacy.md)，并将默认状态设为拒绝
2. 与 CMP（OneTrust、Cookiebot 等）集成，在用户同意后更新同意状态
3. 使用 DebugView 测试同意设置

自定义报告

1. 了解报告中可用的数据
2. 将自定义参数注册为维度，并创建探索
3. 如需未抽样的数据，请导出到 BigQuery

最佳实践

• 命名： 使用 snake_case，描述清晰且以动作导向，长度控制在 40 个字符以内，避免使用泛化名称
• 实施顺序： 增强型衡量 -> 推荐事件 -> 自定义事件 -> 自定义维度
• 数据质量： 将测试和生产资源分开，从第一天起设置内部流量过滤器，记录所有自定义事件，定期使用 DebugView 审计，并导出到 BigQuery 进行备份