@fire-spark/analytics

中文文档
0.19.1发布于 2026/11/17TypeScriptES Module近 30 天下载 8302

SDK 火花存储前置分析

中文使用文档

@ fire-spark/分析

将事件发送至火花和GA4,Meta,TikTok和Masivo适配器.

import { analytics } from "@fire-spark/analytics";
import { ga4 } from "@fire-spark/analytics-ga4";

await analytics.configure({
  channel_id: "web",
  platform: "web",
  storage: window.localStorage,
  getCustomer: () => session.customer,
  adapters: [ga4({ measurementId: "G-XXXXXXX" })],
  onError: issue => console.error(issue)
});

await analytics.track("add_to_cart", { product_id: "p1", quantity: 1 });

在整合前要知道的行为:

  • 呼吁 track() 在此之前 configure() 一旦运行,就保存并发送.
  • Fire Spark 存储漏斗和交互事件及任何事件 track({ name, properties })。 。 。 . track("name", params) 带有其他名称 只能到达目的地(按设计).
  • Fire Spark 每会话每个漏斗步骤保留一个事件; 目的地 接受每一个事件.
  • 队列是自行发送的( T)flushAt, (中文(简体) ), flushIntervalMs页面隐藏 网页, appState (原始内容存档于2013-12-12). React Industrial.
  • 目标失败到 onError· ; track() 绝不拒绝他们.
  • setUser() 财务报告和审定财务报表 setConsent() 到达每一个目的地.

指南 : https://firespark.cloud/docs/guides/analytics/use-analytics-in-the-sdk 互联网档案馆的存檔,存档日期2014-12-02

版本与发布记录

@fire-spark/analytics 共发布 52 个版本,首次发布于 2026/09/30;过去 12 个月发布了 52 个版本。

版本发布日期距今
0.19.1latest2026/11/17今天
0.19.02026/11/16今天
0.18.02026/11/16今天
0.17.32026/11/143 天前
0.17.22026/11/133 天前
0.17.12026/11/133 天前

关于 @fire-spark/analytics 的常见问题

@fire-spark/analytics 是什么?

SDK 火花存储前置分析

如何安装 @fire-spark/analytics?

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

@fire-spark/analytics 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@fire-spark/analytics 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@fire-spark/analytics 可以商用吗?

@fire-spark/analytics 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@fire-spark/analytics 的下载量有多少?

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

@fire-spark/analytics 还在维护吗?

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