@salla.sa/analytics

中文文档
3.0.21发布于 2026/11/02GPL-3.0ESM + CJS

Salla统一分析:Jitsu引擎,事件转换器和店面(黄昏)和结账的跟踪器

中文使用文档
文档目录4 节
  1. 入口点
  2. 使用
  3. 共同的行为
  4. 测试

@salla.sa /分析

Salla客户端分析(Jitsu)的统一真相来源:跟踪 引擎、事件转换器和自定义跟踪器注册表 店面(黄昏时分)和结账。

入口点

进口目录
@salla.sa/analytics/storefront店面 Analytics 引擎+ ~29店面事件变压器。与全球对话 Salla SDK对象(配置、存储、事件总线)——它必须在一个暮光店面上下文中运行。
@salla.sa/analytics/checkout结账 Analytics 引擎+结帐/支付事件转换器。读取服务器呈现的 window.initialData 有效载荷。也出口 SessionService, initialData, sanitizeErrorMessage, sanitizeFieldErrors.
@salla.sa/analytics两个引擎加上共享的帮助程序(resolveAnalyticsHost, captureSallaCookies,跟踪器注册表; generateSessionId)。

使用

店面(暮光SDK -已经连接 @salla.sa/twilight):

import Analytics from '@salla.sa/analytics/storefront';
Salla.analytics = new Analytics;

付款:

import Analytics from '@salla.sa/analytics/checkout';
window.analytics = new Analytics;

共同的行为

  • 会话id两个引擎都存在 s-session-id_<storeId> 在localStorage 有一个滑动的30分钟TTL,因此客户可以保持一个跟踪会话 店面和收银台在同一个地方。
  • 主机决议: resolveAnalyticsHost 通过商店的 自己的域名(<store-origin>/_app/e),处理沙拉。Sa存储路径,demostore 和自定义域,回落到 https://salla.cloud/_app/e.
  • 自定义跟踪器: registerTracker({name, track, page}) 将历史回放到 延迟注册的跟踪器并隔离跟踪器故障。

测试

发动机和变压器由 @salla.sa/twilight jest套件 (packages/twilight/tests/analytics),它启动完整的SDK 店面引擎期望。

版本与发布记录

@salla.sa/analytics 共发布 87 个版本,首次发布于 2026/08/16;过去 12 个月发布了 87 个版本。

版本发布日期距今
3.0.21latest2026/11/021 天前
3.0.202026/11/021 天前
3.0.192026/11/021 天前
3.0.182026/11/012 天前
3.0.172026/10/295 天前
3.0.162026/10/285 天前

关于 @salla.sa/analytics 的常见问题

@salla.sa/analytics 是什么?

Salla统一分析:Jitsu引擎,事件转换器和店面(黄昏)和结账的跟踪器

如何安装 @salla.sa/analytics?

在项目目录运行 npm install @salla.sa/analytics,或使用 pnpm add / yarn add / bun add。

@salla.sa/analytics 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/salla.sa__analytics 是否存在。

@salla.sa/analytics 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@salla.sa/analytics 可以商用吗?

@salla.sa/analytics 使用 GPL-3.0 许可。强 Copyleft:分发包含该代码的软件时,整个作品需以 GPL-3.0 兼容许可开源,并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括,不构成法律意见,请以许可原文为准。

@salla.sa/analytics 还在维护吗?

最新版本 3.0.21 发布于 2026/11/02(1 天前);至今共发布 87 个版本,其中过去 12 个月发布了 87 个;首次发布于 2026/08/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。