# @djangocfg/analytics 中文文档

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

版本：2\.1\.653
npm 元数据更新时间：2026-11-12T05:22:36.109Z
中文译文更新时间：2026-11-12T12:11:36.214Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40djangocfg/analytics
原文对照：https://npmcn.com/package/%40djangocfg/analytics/?lang=original
项目主页：https://djangocfg.com/
源码仓库：https://github.com/markolofsen/django-cfg

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

- 包体积（解压后）：33.2 kB，13 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：next \>=15\.0\.0，react ^19\.0\.0，react-dom ^19\.0\.0，react-ga4 ^2\.1\.0
- 首次发布：2026-07-21T11:22:55.246Z
- 最新版本发布：2026-11-12T05:22:35.903Z
- 近 30 天下载量：15314（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：151（近 12 个月 151 个）

## 中文简介

Django-cfg apps的第一方面分析:一个路由收听器,N Transports(自办+GA4). 页面视图、会话和经认证的用户归属.

## 安装

```sh
npm install @djangocfg/analytics
```

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

## README

# @djangocfg/分析

DjangoCFG的第一方面产品分析。 一个客户粉丝出 页面浏览和 用于 django-cfg 和可选 GA4 传输的自定义事件.

## 产品活动

挂载 `AnalyticsProvider` 一次( 发牌) `BaseApp` 这样做是自动的, 然后使用已键入的 React API :

```tsx
import { useAnalytics } from '@djangocfg/analytics'

const { event } = useAnalytics()
event('layouts.auth.step_viewed', { step: 'otp' })
event('billing.checkout_started', { plan: 'pro' })
```

对于React以外的浏览器集成代码,请使用已安装的可选外观 由供养者. 它是同一个客户,而不是第二个运输:

```ts
window.analytics?.event('billing.checkout_started', { plan: 'pro' })
```

接受未知产品事件名称 。 扩展 `AnalyticsEventMap` 将制作 您的产品名称和属性类型安全 :

```ts
declare module '@djangocfg/analytics' {
  interface AnalyticsEventMap {
    'billing.checkout_started': { plan: 'pro' | 'team' }
  }
}
```

使用稳定事件名称作为分析合同 。 强哥的目标和漏斗 根据这些名称配置; 不在名称中编码动态标识符 将有界限的非敏感维度放入 `props` 换句话说.

## 身份和漏斗

浏览器行程被设定为主机. 一个属性可以聚合主机,但它 不合并匿名访客身份。 服务器确认的认证 事件对源主机使用请求生成的身份,所以一个认证 该主机上的漏斗可以安全地加入它的UI和成功的登录事件.

## 常见问题

### @djangocfg/analytics 是什么？

Django-cfg apps的第一方面分析:一个路由收听器,N Transports\(自办\+GA4\)\. 页面视图、会话和经认证的用户归属\.

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

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

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

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

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

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

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

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

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

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

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

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