# @funnelsgrove/analytics 中文文档

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

版本：0\.29\.0
npm 元数据更新时间：2026-11-12T09:19:30.749Z
中文译文更新时间：2026-11-15T18:51:55.916Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40funnelsgrove/analytics
原文对照：https://npmcn.com/package/%40funnelsgrove/analytics/?lang=original
项目主页：https://github.com/The-Solid-Grove/funnelsgrove#readme
源码仓库：https://github.com/The-Solid-Grove/funnelsgrove

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

- 包体积（解压后）：108 kB，36 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@funnelsgrove/runtime ^0\.46\.0
- 首次发布：2026-04-03T22:28:10.740Z
- 最新版本发布：2026-11-12T09:19:30.354Z
- 近 30 天下载量：7901（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：134（近 12 个月 134 个）

## 中文简介

公共漏斗共享分析包.

## 安装

```sh
npm install @funnelsgrove/analytics
```

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

## README

# @funnelsgrove/分析

公共漏斗共享分析包.

在编辑分析码前读取此文件. 更深的运行时间 SDK 文件居住 [`docs/funnel-sdk/analytics-sdk.md`](https://npmcn.com/package/docs/funnel-sdk/analytics-sdk.md)。 。 。 .

## 拥有事件身份和交付

`@funnelsgrove/analytics` 拥有浏览器身份,事件形状,以及公共漏斗分析的交付合同. 漏斗码可能决定何时发生商务事件,但这个包决定了该事件如何成为SDK/PostHog/partner有效载荷的正态.

## 使用此软件包

-   浏览器用户编号持久性
-   用于公共漏斗身份的 SDK 用户拖带
-   公共分析活动分批和运输
-   识别、跟踪、步骤生命周期和退出事件助手
-   支付元数据到达API前花纹购买元数据塑造
-   Google 标记和 Meta 像素事件适配器
-   未配置真正可公布的密钥时, 仅本地禁用行为

## 不使用此软件包

-   步骤路由
-   显示逻辑
-   退出协调
-   收费计划决议
-   条条检出 UI
-   漏斗特定步骤组件或副本

## 公众表面

-   `publicAnalyticsSdk`:用于识别,跟踪,生命周期,取出以及冲号的Canonic浏览器SDK.
-   `bootstrapPublicAnalyticsUser`: 公共SDK身份靴子助手.
-   `sdk-user-id.storage`: 共享浏览器用户代号存储合同.
-   `buildStripePurchaseMetadata` 并购买属性助手:用于支付交接的安全元数据.
-   `trackStripePaymentCheckoutReturn`: 解析和去重复 Stree浏览器-回回诊断,而不主张购买转换.
-   `google-tag.service` 财务报告和审定财务报表 `meta-pixel.service`:伙伴活动适配器.
-   `experiment-result-metrics.service`: 共享实验结果度量助手.

## 工程规则

-   在此保留运输细节; 不重复漏斗中的事件批量 .
-   保持提供者适配器哑:它们映射出犬科事件,而不是漏斗业务流量.
-   不从此软件包导入付款 UI 或运行时间路由 .
-   敏感值必须在元数据到达Frede或伙伴工具之前被过滤.
-   条纹浏览器返回仅是诊断状态 。 使用 `trackStripePaymentCheckoutReturn`; 绝不将查询参数变为 `checkout_completed` 或信赖 `purchase_completed`。 。 。 .

## 谷歌标签配置

`NEXT_PUBLIC_GOOGLE_ANALYTICS_ID` 财务报告和审定财务报表 `NEXT_PUBLIC_GOOGLE_TAG_MANAGER_ID` 配置 Google 标签装入 。 谷歌 广告转换动作也需要 满 `send_to` 目的地,例如: `AW-123456789/ConversionLabel`。 。 。 .

-   `NEXT_PUBLIC_GOOGLE_TAG_LEAD_SEND_TO` 发送广告 `conversion` 当 SDK记录一个铅/电子邮件捕获.
-   `NEXT_PUBLIC_GOOGLE_TAG_LEAD_VALUE` 设置铅Ads的数值 转换。 空值或无效值默认为 `0`。 。 。 .
-   `NEXT_PUBLIC_GOOGLE_TAG_PURCHASE_SEND_TO` 发送广告 `conversion` 当 sDK记录了一个付费的结账.

指定转换值仅在 `NEXT_PUBLIC_GOOGLE_TAG_ENABLED=true`。 。 。 . 这个 `AW-...` 前缀用于加载和配置 `gtag.js`; 全文 `AW-.../...` 在转换事件上发送值.

## 构建、测试、发布

```bash
npm run test:run --workspace @funnelsgrove/analytics
npm run build --workspace @funnelsgrove/analytics
npm publish --workspace @funnelsgrove/analytics --access public
```

该建筑使产生的相对无害环境管理进口商品正常化,使之明确 `.js` 用于已发布的软件包消费者的文件.

## 常见问题

### @funnelsgrove/analytics 是什么？

公共漏斗共享分析包\.

### 如何安装 @funnelsgrove/analytics？

在项目目录运行 npm install @funnelsgrove/analytics，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@funnelsgrove/runtime（^0\.46\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @funnelsgrove/analytics 支持 TypeScript 吗？

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

### @funnelsgrove/analytics 支持 ESM 还是 CommonJS？

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

### @funnelsgrove/analytics 可以商用吗？

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

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

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

### @funnelsgrove/analytics 还在维护吗？

最新版本 0\.29\.0 发布于 2026/11/12（3 天前）；至今共发布 134 个版本，其中过去 12 个月发布了 134 个；首次发布于 2026/04/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。