# @salla\.sa/analytics 中文文档

规范地址：https://npmcn.com/package/%40salla.sa/analytics/

版本：3\.0\.21
npm 元数据更新时间：2026-11-02T09:08:46.487Z
中文译文更新时间：2026-11-02T09:51:15.024Z
软件包许可：GPL-3\.0

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40salla.sa/analytics
原文对照：https://npmcn.com/package/%40salla.sa/analytics/?lang=original
项目主页：https://salla.dev/
源码仓库：https://github.com/SallaApp/twilight

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：296 kB，90 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2026-08-16T10:02:39.789Z
- 最新版本发布：2026-11-02T09:08:46.169Z
- 已发布版本数：87（近 12 个月 87 个）

## 中文简介

Salla统一分析：Jitsu引擎，事件转换器和店面（黄昏）和结账的跟踪器

## 安装

```sh
npm install @salla.sa/analytics
```

也可以使用：`pnpm add @salla.sa/analytics`、`yarn add @salla.sa/analytics`、`bun add @salla.sa/analytics`

## README

# @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`):

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

付款:

```js
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 是什么？

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 和提交记录判断。