@fire-spark/analytics

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

Fire Spark storefront analytics SDK

原始使用文档

@fire-spark/analytics

Sends events to Fire Spark and to the GA4, Meta, TikTok and Masivo adapters.

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 });

Behavior to know before you integrate:

  • Calls to track() before configure() are kept and sent once it runs.
  • Fire Spark stores funnel and interaction events and any event sent as track({ name, properties }). track("name", params) with another name only reaches the destinations (by design).
  • Fire Spark keeps one event per funnel step per session; destinations receive every occurrence.
  • The queue is sent on its own (flushAt, flushIntervalMs, page hide on web, appState in React Native).
  • Destination failures go to onError; track() never rejects for them.
  • setUser() and setConsent() reach every destination.

Guide: https://firespark.cloud/docs/guides/analytics/use-analytics-in-the-sdk

版本与发布记录

@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 是什么?

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