# Google Analytics 4 (/zh/integrations/analytics/google-analytics)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 346 · updated: 2026-07-30 -->
Related: [Analytics 集成](/zh/integrations/analytics/overview.md), [Amplitude](/zh/integrations/analytics/amplitude.md), [Clarity](/zh/integrations/analytics/clarity.md), [Clearbit](/zh/integrations/analytics/clearbit.md), [Fathom](/zh/integrations/analytics/fathom.md), [Google Tag Manager](/zh/integrations/analytics/google-tag-manager.md)

你需要创建一个新的<Tooltip tip="Google Analytics 4">GA4</Tooltip>资源以供 Mintlify 使用。收集的数据归入与你其他 Google Analytics 数据相同的项目。

如果你仍在使用旧版 Google Analytics（Universal Analytics），依然可以创建<Tooltip tip="Google Analytics 4">GA4</Tooltip>资源。<Tooltip tip="Google Analytics 4">GA4</Tooltip>数据与 UA 数据略有差异，但都会汇集到同一个项目中。

<div id="connect-ga4-to-mintlify">
  ## 将 GA4 接入 Mintlify [#将-ga4-接入-mintlify]
</div>

<div id="create-a-web-stream">
  ### 创建 Web 流 [#创建-web-流]
</div>

你需要创建一个 Web 流以获取 Measurement ID，并将其填入 Mintlify。

点击 Google Analytics 界面左下角的齿轮图标，然后点击 Data Streams。

<Frame>
  ![Google Analytics 控制台中 Data Streams 页面截图。](/_assets/e3d65da1bb0cf828c4d15966620065495152a1e50adf88b9679acfbac0365ad2)
</Frame>

创建一个 Web 流，并将你的 Mintlify 文档站点的 URL 作为流的 URL。

你的 Measurement ID 类似于 `G-XXXXXXX`，创建 Web 流后会立即出现在 Stream Details 下方。

<div id="put-measurement-id-in-docsjson">
  ### 在 docs.json 中添加 Measurement ID [#在-docsjson-中添加-measurement-id]
</div>

将你的 Measurement ID 添加到 `docs.json` 文件中，如下所示：

```json title="docs.json"
"integrations": {
    "ga4": {
        "measurementId": "G-XXXXXXX"
    }
}
```

<div id="wait">
  ### 请稍候 [#请稍候]
</div>

Google Analytics 通常需要两到三天才会显示你的数据。

你可以使用 [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) 检查你的 Analytics 配置。每当 GA4 发出请求时，该扩展都会在你的浏览器控制台中记录日志。

<Note>
  预览链接的 Analytics 已禁用。
</Note>