GA4 导入：如何将历史 Google Analytics 数据迁移到 statpx
切换到 statpx 并不意味着您在切换的那一天就要失去多年积累的 Google Analytics 历史数据。GA4 导入页面（ga_import.php）通过 OAuth 连接到一个 GA4 资源，拉取您的历史每日会话数、用户数和页面浏览量，作为一个独立的只读叠加层——这样您的旧数据会与 statpx 未来原生追踪的一切并列可见。
为什么要导入，而不是直接切换
大多数评估 Google Analytics 替代方案的团队都希望干净利落地切换，但如果没有任何历史数据，逐月和逐年的对比在一段时间内将变得不可能。GA4 导入解决了这个问题，让您即使在 statpx 尚未安装的那段时间里，也能继续参考去年的数字。这明确是一个叠加层，而不是合并——导入的 GA4 数据行与 statpx 自身的 hits/sessions 表分开存储，因此在重叠期间被两个系统同时追踪的访客不会存在重复计数的风险。
启用所需的两个 Google API
GA4 导入复用了与 Search Console 相同的 Google Cloud OAuth 客户端，但需要额外启用两个 API 才能正常工作——这是最容易被遗漏的一步：
- 打开 console.cloud.google.com，选择与您的 OAuth 客户端关联的 Google Cloud 项目。
- 启用 Google Analytics Data API——这是实际返回历史指标的接口。
- 启用 Google Analytics Admin API——这让 statpx 能够列出您有权访问的 GA4 资源和账户，方便您选择正确的一个。
通过 OAuth 连接您的 GA4 资源
在某个网站的 GA4 导入页面上，点击连接，并使用有权访问您想拉取数据的 GA4 资源的 Google 账户登录。授权后，statpx 会列出该登录可见的账户摘要，供您选择具体的资源——如果一个 Google 账户管理多个网站，这一点非常有用。确认资源后，首次导入即会运行，并回填您可获取的历史数据范围。
叠加层如何运作——不会重复计数
导入的 GA4 数据存放在自己的表（imported_stats）中，按天汇总——每天的会话数、用户数、页面浏览量、跳出数和平均时长——而不是像 statpx 自身追踪那样按单次访问级别记录。显示综合趋势线的仪表盘会在日期边界处将两个数据源拼接起来：在您安装 statpx 追踪代码之前的历史日期使用 GA4 导入数据，之后的每一天都使用 statpx 原生数据。由于这两个数据集在设计上从不重叠（导入数据只覆盖 statpx 追踪上线之前的日期，或在重叠处有明确标注），因此不会出现同一天的访客在两个总数中都被计算的风险。
迁移到 statpx 时保留您的 GA 历史数据
连接一个 GA4 资源，将您的历史会话数、用户数和页面浏览量作为只读叠加层导入——报告时间线不会出现缺口。隐私友好，无需 Cookie。
免费开始 →总结
GA4 导入消除了切换分析工具时最大的实际顾虑：失去历史基准。启用这两个 Google API，连接正确的资源，您就能获得连续的历史视图，而不是在安装 statpx 那天出现硬性断层。从那之后，所有新数据——实时数据、追踪代码、营销活动、归因分析——都运行在 statpx 自己的第一方数据之上，而您过去的表现数据则原封不动地保留在原处。