Google Analytics 集成
使用衡量 ID 将 Google Analytics 4 添加到文档站点,跟踪访客并了解内容互动情况。
将 Google Analytics 4 添加到文档站点,了解用户如何与您的内容互动。
Google Analytics 集成适用于以 G- 开头的 GA4(Google Analytics 4)衡量 ID。
获取衡量 ID
- 前往 Google Analytics
- 选择您的媒体资源(或创建一个)
- 前往 Admin → Data Streams
- 选择您的网站数据流(或创建一个)
- 复制 Measurement ID(以
G-开头)
将 GA4 添加到文档
将衡量 ID 添加到您的 docs.json:
docs.json
{
"name": "My Docs",
"integrations": {
"ga4": {
"measurementId": "G-XXXXXXXXXX"
}
}
}将 G-XXXXXXXXXX 替换为您的实际衡量 ID。
查看数据
添加集成后:
- 触发文档重新构建
- 访问您的线上文档站点
- 在 Google Analytics 中,前往 Reports → Real-time
- 您应该能在 30 秒内看到访问数据
数据可能需要 24–48 小时才会显示在标准报告中。要立即验证,请使用 Real-time 报告。
与 Google Tag Manager 搭配使用
如果您已经在使用 Google Tag Manager,可以通过 GTM 配置 GA4,而不是直接添加 GA4。详情请参阅 Google Tag Manager 集成。
如果需要,您需要负责为通过 Google Tag Manager 加载的任何标签设置 Cookie 同意横幅。Jamdesk 会为所有访客加载您的 GTM 容器,不会设置同意门槛。请参阅 Cookie 同意,在访客选择同意前阻止分析功能。
不要同时在 docs.json 中直接添加 GA4 媒体资源,并通过 Google Tag Manager 添加同一媒体资源,否则会导致重复跟踪。
隐私注意事项
Google Analytics 会收集访客数据。请考虑:
- 如果 GDPR/CCPA 适用,请添加 Cookie 同意横幅。Jamdesk 默认会为每位访客加载 GA4,因此请使用 Cookie 同意,在访客选择同意前阻止 GA4。
- 更新隐私政策,说明分析功能
- 如有需要,使用 IP 匿名化
故障排除
- 验证衡量 ID - 必须以
G-开头 - 检查广告拦截器 - 它们可能会阻止分析脚本
- 等待重新构建 - 更改需要在新的构建后才能生效
- 使用 Real-time 报告 - 标准报告会延迟 24–48 小时
ID 必须:
- 以
G-开头 - 在
G-后仅包含字母和数字 - 从 Google Analytics 中准确复制(不能包含额外空格)
