@djangocfg/analytics

中文文档
2.1.653发布于 2026/11/12MITTypeScriptESM + CJS零依赖近 30 天下载 1.5万

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

中文使用文档

@djangocfg/分析

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

产品活动

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

import { useAnalytics } from '@djangocfg/analytics'

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

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

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

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

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

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

身份和漏斗

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

版本与发布记录

@djangocfg/analytics 共发布 151 个版本,首次发布于 2026/07/21;过去 12 个月发布了 151 个版本。

版本发布日期距今
2.1.653latest2026/11/12今天
2.1.6522026/11/11今天
2.1.6512026/11/111 天前
2.1.6502026/11/111 天前
2.1.6482026/11/111 天前
2.1.6472026/11/111 天前

关于 @djangocfg/analytics 的常见问题

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