数据分析

每个已发布的 Proyecta 应用均内置数据分析功能。在 builder 中打开 Admin > Analytics，即可查看流量、Web Vitals 及设备分布。

每个 Proyecta 应用都自带数据分析功能，无需安装任何组件、无需粘贴代码片段，也无需注册第三方账户。所有已发布应用均会自动收集数据；builder 内的数据分析仪表板适用于 Pro 及以上方案。在 builder 中打开 Admin > Analytics，即可查看已发布站点的数据。

三个视图

数据分析包含三个视图，列于 admin 侧边栏中：

视图	内容说明
Overview	流量——页面浏览量、访客数、会话数、热门页面及每日时序图（引流来源显示在 Devices 标签中）
Web Vitals	基于真实用户采集的核心 Web Vitals 指标（LCP、INP、CLS）
Devices	浏览器信息及流量来源（引流来源）

会追踪哪些数据？

数据分析自动从你的已发布站点（即 *.proyecta.live 子域名或自定义域名）进行采集。在 builder 内的 preview 流量不计入统计。

当前时间窗口为最近 7 天。可自定义日期范围的选择器已列入开发路线图。

如何访问？

在 builder 中打开你的项目，切换到 Admin 视图，然后在侧边栏中选择 Analytics。查看此功能需要 Pro 及以上方案——Free 方案用户将看到升级提示。付费方案默认加载 Overview 视图；可通过侧边栏在 Overview、Web Vitals 和 Devices 之间切换。

追踪自定义事件

除自动采集的页面浏览量和 Web Vitals 外，你的应用还可以记录自定义自定义事件——注册、购买、功能使用，或任何你关注的行为。自定义事件会自动关联到你的应用。

你的应用已内置追踪器，只需在 React 代码的任意位置调用 track() 即可：

import { track } from '@proyecta-ai/analytics';

// 可在事件处理函数、effect 中调用，或在成功写入后立即调用。
track('signup', { plan: 'pro', referrer: 'newsletter' });

track('add_to_cart', { sku: 'ABC-1' });
track('checkout', { total: 49 });

属性为由字符串和数字组成的扁平对象。track() 不会抛出异常，也无需空值检查——如果分析功能尚未初始化，调用将被静默丢弃，因此在 render 期间或首次绘制时调用均安全。

可以这样向 AI 发出指令："Track a 'signup' event whenever a new user registers."

常见问题

我需要添加 Google Analytics 或 Mixpanel 吗？

不需要。数据分析已内置，并对所有已发布应用自动启用。如果你希望额外接入第三方服务商，仍可让 AI 帮你集成——在 Settings 页面的环境变量部分添加服务商的 API key，然后说 "Add Google Analytics to my app" 即可。

我需要付费方案吗？

所有已发布应用无论使用何种方案均会收集数据。Admin 中的 Analytics 区域是 Pro 功能——Free 方案用户将看到升级提示。自定义事件追踪适用于所有方案。

为什么我看不到任何数据？

数据分析仅追踪应用的已发布版本。如果你尚未发布，或已发布站点在过去 7 天内没有任何流量，面板将为空。builder 内的 preview 流量不计入统计。（另外请确认你使用的是 Pro 方案——仪表板本身需要 Pro 方案才能访问。）

可以导出数据吗？

暂不支持。CSV 导出功能已列入开发路线图。

可以选择不同的日期范围吗？

暂不支持。面板显示最近 7 天的数据，自定义日期范围功能已列入开发路线图。

访客数据是否经过匿名处理？

Proyecta 数据分析使用第一方 cookie（_pry_vid）来识别回访访客，不会跨第三方站点追踪用户。是否需要展示 cookie 同意横幅，取决于你的用户所在司法管辖区（例如欧盟的 GDPR 可能要求对持久标识符征得同意）。请咨询你的法律顾问。

即将推出

可配置的日期范围（24 小时、30 天、自定义）
CSV 导出
转化率与目标追踪