> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.manicule.dev/zh/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://mintlify.manicule.dev/zh/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://mintlify.manicule.dev/api/mcp.
> Every agent surface: https://mintlify.manicule.dev/.well-known/llms-manifest.json

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

<!-- agent-signals: reading_time_min: 1 · est_tokens: 344 · updated: 2026-07-31 -->
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)

> 将 Google Analytics 4 集成到你的 Mintlify 文档，通过 GA4 ID 跟踪访客行为、页面浏览量和内容参与情况。

你需要创建一个新的<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
</div>

<div id="create-a-web-stream">
  ### 创建 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
</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>