连接 Google Analytics
将 DevDeck 项目连接到 Google Analytics 4（GA4）网页数据流，以统计已发布生产站点的 页面访问。
DevDeck 会将 Google 代码添加到生产构建中。当访问者首次打开应用或在客户端路由之间 切换时，DevDeck 会发送 page_view 事件。分析报告仍保留在 Google Analytics 中。
此连接的作用
此连接用于统计生产站点的页面访问。它不会让 DevDeck 或生成的应用访问 Google Analytics 报告，也不会创建或修改 Google Analytics 账号、媒体资源或数据流。
开始之前
你需要准备：
- 一个 Google Analytics 账号。
- 一个用于目标站点的 GA4 媒体资源。
- 该媒体资源中的一个网页数据流。
- 配置 DevDeck 项目的权限。
第一步：获取 GA4 Measurement ID
Measurement ID 用于标识接收站点事件的网页数据流。它以 G- 开头，例如 G-XXXXXXXXXX。
- 登录 Google Analytics。
- 选择要使用的账号和 GA4 媒体资源。
- 打开管理。
- 在数据收集和修改下选择数据流。
- 选择应用对应的网页数据流。
- 复制数据流详情中显示的 Measurement ID。
如果还没有网页数据流，请选择添加数据流 → 网页，填写生产站点 URL 和数据流名称， 创建数据流后再复制 Measurement ID。
Measurement ID 不是 Secret
Google Analytics 会将这个 ID 放在站点的浏览器代码中。它只标识分析事件的接收位置， 不会授予访问 Google Analytics 账号或报告的权限。
第二步：在 DevDeck 中连接 Google Analytics
- 在 DevDeck 中打开项目。
- 选择 Connections（连接）。
- 找到 Google Analytics 并选择 Connect（连接）。如果已经连接，请选择 **Configure（配置）**以更换 Measurement ID。
- 将 GA4 Measurement ID 粘贴到 GA4 Measurement ID 输入框。
- 选择 Save（保存）。
- 发布项目，使此连接应用到生产站点。
DevDeck 接受的 GA4 ID 格式为 G- 后跟 4–20 个大写字母或数字。DevDeck 会检查格式， 但无法验证这个 ID 是否属于你或是否指向预期的数据流。
需要重新发布
保存、更换或断开 Google Analytics 不会立即改变线上站点。请重新发布项目，以更新生产 环境的统计配置。
第三步：验证页面访问
发布后：
- 在浏览器中打开已发布的生产站点。
- 访问几个页面，或在不同路由之间切换。
- 在 Google Analytics 中打开报告 → 实时。
- 确认页面中出现活跃用户和
page_view事件。
实时事件可能需要几分钟才会显示。DevDeck 预览环境中的访问不会通过此生产连接发送。
更换或断开连接
如果要改用其他网页数据流，请打开 Connections（连接），选择 Google Analytics 的 Configure（配置），更换 Measurement ID，保存后重新发布。
如果要停止生产环境统计，请在 **Connections（连接）**中断开 Google Analytics，然后 重新发布项目。断开项目连接不会删除或停用 Google Analytics 中的网页数据流。
故障排查
Measurement ID 被拒绝
请确认复制的是 GA4 Measurement ID，而不是媒体资源 ID、数据流 ID、其他产品中的 Google 代码 ID 或账号编号。有效值应以 G- 开头。
实时报告中没有事件
请检查：
- 保存连接后是否重新发布了项目。
- 打开的是否为已发布生产站点，而不是 DevDeck 预览页面。
- 保存的 Measurement ID 是否与目标网页数据流一致。
- 广告拦截器、跟踪保护或 Cookie 同意配置是否拦截了
googletagmanager.com。 - 是否已等待几分钟并刷新实时报告。
页面访问被统计两次
不要在生成的应用中再添加一份 gtag.js 代码或其他自动页面访问跟踪器。DevDeck 已经会 为已连接的生产项目安装页面访问跟踪。
隐私与同意
你有责任根据站点及其访问者所适用的隐私、Cookie 同意和数据保护要求配置分析功能。
更多信息请参阅 Google 的 查找 Measurement ID 指南。