# @analytics/simple-analytics 中文文档

规范地址：https://npmcn.com/package/%40analytics/simple-analytics/

版本：0\.4\.1
npm 元数据更新时间：2025-03-19T23:21:28.810Z
中文译文更新时间：2026-11-07T00:03:04.128Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40analytics/simple-analytics
原文对照：https://npmcn.com/package/%40analytics/simple-analytics/?lang=original

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

- 包体积（解压后）：26.8 kB，12 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2019-10-07T06:00:21.020Z
- 最新版本发布：2025-03-19T23:21:28.623Z
- 近 30 天下载量：2139（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 0 个）

## 中文简介

浏览器“ 分析” 模块的简单分析插件

## 安装

```sh
npm install @analytics/simple-analytics
```

也可以使用：`pnpm add @analytics/simple-analytics`、`yarn add @analytics/simple-analytics`、`bun add @analytics/simple-analytics`

## README

# 简单的分析插件

与简单的分析结合 [简单的分析](https://simpleanalytics.com/)

简单的分析插件会自动跟踪单页应用程序路由更改的页面视图.

详情 [见文件](https://getanalytics.io/plugins/simple-analytics/)。 。 。 .

单击以扩展

-   [安装](https://npmcn.com/package/%40analytics/simple-analytics/#readme-installation)
-   [如何使用](https://npmcn.com/package/%40analytics/simple-analytics/#readme-how-to-use)
-   [支持的平台](https://npmcn.com/package/%40analytics/simple-analytics/#readme-platforms-supported)
-   [浏览器使用量](https://npmcn.com/package/%40analytics/simple-analytics/#readme-browser-usage)
    -   [浏览器 API](https://npmcn.com/package/%40analytics/simple-analytics/#readme-browser-api)
    -   [浏览器配置选项](https://npmcn.com/package/%40analytics/simple-analytics/#readme-configuration-options-for-browser)
-   [其他例子](https://npmcn.com/package/%40analytics/simple-analytics/#readme-additional-examples)

## 安装

```bash
npm install analytics
npm install @analytics/simple-analytics
```

## 如何使用

这个 `@analytics/simple-analytics` 软件包在 [浏览器](https://npmcn.com/package/%40analytics/simple-analytics/#readme-browser-usage)。要使用、安装软件包,在您的工程中包含并初始化插件 [分析](https://www.npmjs.com/package/analytics)。 。 。 .

以下为如何使用浏览器插件的例子.

```js
import Analytics from 'analytics'
import simpleAnalyticsPlugin from '@analytics/simple-analytics'

const analytics = Analytics({
  app: 'awesome-app',
  plugins: [simpleAnalyticsPlugin()]
})

/* Track a custom event */
analytics.track('cartCheckout', {
  item: 'pink socks',
  price: 20
})

```

初始化后 `analytics` 与 `simpleAnalyticsPlugin` 插件中,数据会在任何时间或任何时间被发送到简单的分析中 [分析. track](https://getanalytics.io/api/#analyticstrack) 被调用.

见 [其他执行实例](https://npmcn.com/package/%40analytics/simple-analytics/#readme-additional-examples) 在您的项目中使用更多细节 .

## 支持的平台

这个 `@analytics/simple-analytics` 软件包在 [浏览器](https://npmcn.com/package/%40analytics/simple-analytics/#readme-browser-usage)

## 浏览器使用量

简单分析客户端浏览器插件使用这些分析的api方法:

-   **[分析. track](https://getanalytics.io/api/#analyticstrack)** - 跟踪自定义事件并发送给简单分析

### 浏览器 API

```js
import Analytics from 'analytics'
import simpleAnalyticsPlugin from '@analytics/simple-analytics'

const analytics = Analytics({
  app: 'awesome-app',
  plugins: [simpleAnalyticsPlugin()]
})

```

### 浏览器配置选项

| 选项 | 说明 |
| :-- | :-- |
| `customDomain`  
_选项_ - 绳子 | 简单分析脚本的自定义域 . [https://docs.simplanalytics.com/scription (中文(中国大陆) )](https://docs.simpleanalytics.com/script) |
| `hostname`  
_选项_ - 绳子 | 允许覆盖域名 [https://docs.simplanalytics.com/overwrite-domain-name 互联网档案馆的存檔,存档日期2013-12-22](https://docs.simpleanalytics.com/overwrite-domain-name) |
| `collectDnt`  
_选项_ - 布尔 | 允许收集 DNT 访问者 [https://docs.simplanalytics.com/dnt (中文(简体) )](https://docs.simpleanalytics.com/dnt) |
| `mode`  
_选项_ - 绳子 | 允许散列模式 [https://docs.simplanalytics.com/hash-mode 互联网档案馆的存檔,存档日期2013-12-21](https://docs.simpleanalytics.com/hash-mode) |
| `ignorePages`  
_选项_ - 绳子 | 添加忽略页面 [https://docs.simplanalytics.com/ignore-pages (中文(简体) )](https://docs.simpleanalytics.com/ignore-pages) |
| `saGlobal`  
_选项_ - 绳子 | 为事件覆盖 SA 全球 [https://docs.simplanalytics.com/events#可变-sa event-is-已使用](https://docs.simpleanalytics.com/events#the-variable-sa_event-is-already-used) |
| `autoCollect`  
_选项_ - 布尔 | 为事件覆盖 SA 全球 [https://docs.simplanalytics.com/trigger-custom-page-views#use-custom-collection-anyway 互联网档案馆的存檔,存档日期2013-12-22](https://docs.simpleanalytics.com/trigger-custom-page-views#use-custom-collection-anyway) |
| `allowParams`  
_选项_ - 绳子 | 允许自定义 URL 参数 [https://docs.simplanalytics.com/allow-params (中文(中国大陆) )](https://docs.simpleanalytics.com/allow-params) |
| `onloadCallback`  
_选项_ - 绳子 | 允许重新装入 [https://docs.simplanalytics.com/trigger-custom-page-views#use-custom-collection-anyway 互联网档案馆的存檔,存档日期2013-12-22](https://docs.simpleanalytics.com/trigger-custom-page-views#use-custom-collection-anyway) |

## 其他例子

以下是其他执行实例.

在 HTML 中使用

以下是通过unpkg CDN导入的例子. 请注意,这将拉入该套件的最新版本.

```html
<!DOCTYPE html>
<html>
  <head>
    <title>Using @analytics/simple-analytics in HTML</title>
    <script src="https://unpkg.com/analytics/dist/analytics.min.js"></script>
    <script src="https://unpkg.com/@analytics/simple-analytics/dist/@analytics/simple-analytics.min.js"></script>
    <script type="text/javascript">
      /* Initialize analytics */
      var Analytics = _analytics.init({
        app: 'my-app-name',
        plugins: [simpleAnalytics()]
      })

      /* Track a custom event */
      analytics.track('cartCheckout', {
        item: 'pink socks',
        price: 20
      })
    </script>
  </head>
  <body>
    ....
  </body>
</html>

```

通过 ES 模块在 HTML 中使用

使用 `@analytics/simple-analytics` 在无害环境管理模块中.

```html
<!DOCTYPE html>
<html>
  <head>
    <title>Using @analytics/simple-analytics in HTML via ESModules</title>
    <script>
      // Polyfill process.
      // **Note**: Because `import`s are hoisted, we need a separate, prior <script> block.
      window.process = window.process || { env: { NODE_ENV: 'production' } }
    </script>
    <script type="module">
      import analytics from 'https://unpkg.com/analytics/lib/analytics.browser.es.js?module'
      import simpleAnalytics from 'https://unpkg.com/@analytics/simple-analytics/lib/analytics-plugin-simple-analytics.browser.es.js?module'
      /* Initialize analytics */
      const Analytics = analytics({
        app: 'analytics-html-demo',
        debug: true,
        plugins: [
          simpleAnalytics()
          // ... add any other third party analytics plugins
        ]
      })

      /* Track a custom event */
      analytics.track('cartCheckout', {
        item: 'pink socks',
        price: 20
      })
    </script>
  </head>
  <body>
    ....
  </body>
</html>

```

## 常见问题

### @analytics/simple-analytics 是什么？

浏览器“ 分析” 模块的简单分析插件

### 如何安装 @analytics/simple-analytics？

在项目目录运行 npm install @analytics/simple-analytics，或使用 pnpm add / yarn add / bun add。

### @analytics/simple-analytics 支持 TypeScript 吗？

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

### @analytics/simple-analytics 支持 ESM 还是 CommonJS？

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

### @analytics/simple-analytics 可以商用吗？

@analytics/simple-analytics 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @analytics/simple-analytics 的下载量有多少？

根据 npm 官方下载统计，@analytics/simple-analytics 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,139 次，日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @analytics/simple-analytics 还在维护吗？

最新版本 0\.4\.1 发布于 2025/03/20（1\.6 年前）；至今共发布 9 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/10/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。