00 / 00

Google Analytics

在第一方 Analytics Engine 之外,按需接入 Google Analytics 4。

01MVP 默认不加载 Google Analytics。访问、内容和转化事件先通过本站 /api/event 写入 Cloudflare Analytics Engine,国内用户不需要连接 Google 域名。

只有在你明确需要 GA4 的广告生态、现成报表或海外渠道归因时,再增加 Google Analytics。

接入边界

创建 GA4 媒体资源

Google Analytics 创建媒体资源并获取衡量 ID。

新增独立 adapter

products/01mvp/apps/web/src/shared/analytics/ 增加 Google adapter,并从 analytics-provider.tsx 统一加载。不要把 gtag 脚本散落到页面组件。

决定单写还是双写

如果 GA4 只负责广告转化,只发送明确需要的事件。若所有事件双写,先确认数据重复、隐私和同意机制。

更新 CSP 和隐私说明

放行实际使用的 Google 脚本与上报域名,并说明数据接收方、用途和范围。

模板不再提供 VITE_GOOGLE_ANALYTICS_ID 即开即用的默认实现。仅增加环境变量不会加载 GA4;需要显式实现并审查 adapter。

相关资源

这篇文档有问题?