@analytics/simple-analytics

中文文档
0.4.1发布于 2025/03/20MITESM + CJS零依赖近 30 天下载 2139

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

中文使用文档
文档目录7 节
  1. 安装
  2. 如何使用
  3. 支持的平台
  4. 浏览器使用量
  5. 浏览器 API
  6. 浏览器配置选项
  7. 其他例子

简单的分析插件

与简单的分析结合 简单的分析

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

详情 见文件。 。 。 .

单击以扩展

安装

npm install analytics
npm install @analytics/simple-analytics

如何使用

这个 @analytics/simple-analytics 软件包在 浏览器。要使用、安装软件包,在您的工程中包含并初始化插件 分析。 。 。 .

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

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 被调用.

见 其他执行实例 在您的项目中使用更多细节 .

支持的平台

这个 @analytics/simple-analytics 软件包在 浏览器

浏览器使用量

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

浏览器 API

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

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

浏览器配置选项

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

其他例子

以下是其他执行实例.

在 HTML 中使用

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

<!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 在无害环境管理模块中.

<!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 共发布 9 个版本,首次发布于 2019/10/07;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.4.1latest2025/03/201.6 年前
0.4.02023/11/033 年前
0.3.42022/06/114 年前
0.3.32021/12/124 年前
0.3.22021/11/174 年前
0.3.12021/07/295 年前

关于 @analytics/simple-analytics 的常见问题

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