@ 喜悦的垂直/分析
Google Analytics 4, Plausible 和 Matomo 的统一分析界面.
Matomo报告
使用的日期分配报告 VisitsSummary.get 与 period=day每个日期在
Matomo的答复产生了一行报告,包括日期:
空数组或空记录 。 空日有零度量; 保留人口日数
他们的计数。 提供者在答复中不提出日期.
使用页数报告 Actions.getPageUrls为兼容性, pagePath 财务报告和审定财务报表
unifiedPagePathScreen 提供时返回 Matomo 的完整页面 URL, 后退
到它的标签。 匹配本地内容路径的消费者应解析 URL
它们的应用边界.
activeUsers 读取 nb_uniq_visitors 或者说 nb_users当马多摩忽略了两者时,
当前的提供者返回为零;这意味着没有访问量度,
不是没有访客的证据. nb_visits 地图到 sessions 并且必须
无法替换独有访客。 已读页视图参数 nb_hits 或者说
nb_pageviews消费者应使用现有的衡量标准,并区别
无法访问者从观测到的零数计数 .
运行软件包验证 pnpm --filter @happyvertical/analytics test 财务报告和审定财务报表
pnpm exec turbo run build --filter=@happyvertical/analytics。 。 。 .
准确的时间戳间隔集合
runIntervalReport(propertyId, { interval: { startTime, endTime, timeZone }, metrics }) 与日历日期分开 runReport它描述的是准确的
半开间距 [startTime, endTime): 末端瞬间被排除. 时间戳
需要秒和明确冲抵Z 或者说 +/-HH:MM),最多3个
分数. 明确的IANA timeZone 提供上下文; 时间戳
抵消定义即时,包括DST折叠期间。 空/ 反相间距,
无效的日历时间戳, 未知的抵消 -00:00,未知区域并空出或
拒绝的重复度数 RangeError 在供应商访问之前.
检查 getCapabilities().timestampIntervalReporting 和可选方法
; 缺少能力/方法表示不支持。 Matomo广告
{ precision: 'utc-calendar-days', metrics: ['screenPageViews'] }它验证
从提供者元数据获取属性的属性时区, 只支持 UTC 属性
两个瞬间都在协调世界时午夜 当前时间后结束的间隔
返回不可用( e)interval-incomplete)没有提供者报告。 它要求
Actions.get 一次给
包含的日历范围结束专有边界的前一天。 这个
支持可复制的全天或季度页面视图总和而不作总结
访客数。 非UTC属性,DST日数,部分日数等度量衡
返回时 status: 'unsupported';未知的属性时区返回不可用 .
仅 status: 'available' 包含 metrics,包括观测值 '0'。 。 。 .
丢失/变质提供者页面视图返回 status: 'unavailable'从零开始.
认证、网络和供应商故障通常都会被拒绝。 GA4 和可扩展
目前广告 false 而不请求返回不支持的精确度.
没有适配器静默地将任意的时间戳转换为日历日期. 现有
日历报告保留其行为和记录的可用性限制.
const capabilities = await analytics.getCapabilities();
if (capabilities.timestampIntervalReporting && analytics.runIntervalReport) {
const result = await analytics.runIntervalReport('site-id', {
interval: {
startTime: '2026-07-01T00:00:00Z',
endTime: '2026-10-01T00:00:00Z',
timeZone: 'UTC',
},
metrics: [{ name: 'screenPageViews' }],
});
if (result.status === 'available') console.log(result.metrics);
}
供应商边界合同: 马托莫报告 API 使用属性时区中的包容性日历区域。 有记录显示 时间戳支持本身并不能确定 API 的确切半开 精确的保证,所以它仍然不支持在这里.