# @amplitude/analytics-node 中文文档

规范地址：https://npmcn.com/package/%40amplitude/analytics-node/

版本：1\.5\.83
npm 元数据更新时间：2026-11-06T19:43:17.243Z
中文译文更新时间：2026-11-06T19:43:57.801Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：90.7 kB，59 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2022-07-22T19:35:26.343Z
- 最新版本发布：2026-11-06T19:43:16.875Z
- 近 30 天下载量：4727705（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：167（近 12 个月 90 个）

## 中文简介

节点JS的官方振幅 SDK

## 安装

```sh
npm install @amplitude/analytics-node
```

也可以使用：`pnpm add @amplitude/analytics-node`、`yarn add @amplitude/analytics-node`、`bun add @amplitude/analytics-node`

## README

[![](https://static.amplitude.com/brand/amplitude-logo-with-text.svg)](https://amplitude.com/)  

# @amplitude/分析-节点

节点的正宽度 SDK

# 医生

看我们的 [字型分析节点 SDK](https://amplitude.github.io/Amplitude-TypeScript/modules/_amplitude_analytics_node.html) 关于所有可用的SDK方法的清单和说明的参考.

# 安装和快速启动

请访问我们的100:[开发者中心](https://www.docs.developers.amplitude.com/data/sdks/typescript-node/) 关于安装和使用我们的SDK的指示.

## 安装

为了开始使用Amplitude Node.js SDK,通过国家预防机制将软件包安装到你的项目上.

### 使用节点软件包

该软件包发布在国家预防机制登记册上,可用npm和纱线安装.

```sh
# npm
npm install @amplitude/analytics-node@^1.0.0

# yarn
yarn add @amplitude/analytics-node@^1.0.0
```

## 使用量

### 初始化 SDK

在进行任何仪器处理之前,必须先初始化。 您的振幅工程需要 API 密钥 .

```typescript
amplitude.init(API_KEY);
```

### 跟踪事件

事件代表用户如何与您的应用程序互动. 例如,"按钮点击"可能是您想要注意的动作.

```typescript
import { track } from '@amplitude/analytics-node';

// Track a basic event
track('Button Clicked', undefined, {
  user_id: 'user@amplitude.com',
});

// Track events with additional properties
const eventProperties = {
  selectedColors: ['red', 'blue'],
};
track('Button Clicked', eventProperties, {
  user_id: 'user@amplitude.com',
});
```

### 用户属性

用户属性帮助您理解您的用户在您的应用程序中执行某些动作时, 诸如设备细节, 偏好或语言 .

```typescript
import { Identify, identify } from '@amplitude/analytics-node';

const event = new Identify();

// sets the value of a user property
event.set('key1', 'value1');

// sets the value of a user property only once
event.setOnce('key1', 'value1');

// increments a user property by some numerical value.
event.add('value1', 10);

// pre inserts a value or values to a user property
event.preInsert('ab-tests', 'new-user-test');

// post inserts a value or values to a user property
event.postInsert('ab-tests', 'new-user-test');

// removes a value or values to a user property
event.remove('ab-tests', 'new-user-test')

// sends identify event
identify(event);
```

### 预支/追加

-   附加会将一个或多个值附加到用户属性数组中.
-   预置将预置一个或数个值给用户属性.

### 用户组

```typescript
import { setGroup } from '@amplitude/analytics-node';

// set group with single group name
setGroup('orgId', '15');

// set group with multiple group names
setGroup('sport', ['soccer', 'tennis']);
```

### 组识别

这一特征只提供给购买该软件的成长和企业客户 [账户追加](https://amplitude.zendesk.com/hc/en-us/articles/115001765532)。 。 。 .

使用 Group 识别 API 设置或更新特定组的属性 。 然而,这些最新情况只会影响今后的活动.

```typescript
import { Identify, groupIdentify } from '@amplitude/analytics-node';

const groupType = 'plan';
const groupName = 'enterprise';
const identity = new Identify()
identity.set('key1', 'value1');

groupIdentify(groupType, groupName, identity);
```

### 轨道收入

收入实例将存储每笔收入交易, 并允许您定义一些特殊的收入属性( 如“ 收益类型 ” 、 “ 产品标识符 ” 等) , 用于 Amplitude 的事件分割和收入 LTV 图表 。 这些税收实例对象随后被传递到 `revenue` 以收入方式发送到Amplition。 这使得我们可以在平台上自动显示与收入相关的数据. 您可以用此来跟踪应用程序中的和非应用程序中的购买.

```typescript
import { Revenue, revenue } from '@amplitude/analytics-node';

const event = new Revenue()
  .setProductId('com.company.productId')
  .setPrice(3.99)
  .setQuantity(3);

revenue(event);
```

### 回电

所有同步的API通过特定的"承诺"接口可选择等待. 这也作为回调接口.

```typescript
// Using async/await
const results = await track('Button Clicked').promise;
result.event; // {...} (The final event object sent to Amplitude)
result.code; // 200 (The HTTP response status code of the request.
result.message; // "Event tracked successfully" (The response message)

// Using promises
track('Button Clicked').promise.then((result) => {
  result.event; // {...} (The final event object sent to Amplitude)
  result.code; // 200 (The HTTP response status code of the request.
  result.message; // "Event tracked successfully" (The response message)
});
```

## 常见问题

### @amplitude/analytics-node 是什么？

节点JS的官方振幅 SDK

### 如何安装 @amplitude/analytics-node？

在项目目录运行 npm install @amplitude/analytics-node，或使用 pnpm add / yarn add / bun add。

### @amplitude/analytics-node 支持 TypeScript 吗？

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

### @amplitude/analytics-node 支持 ESM 还是 CommonJS？

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

### @amplitude/analytics-node 可以商用吗？

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

### @amplitude/analytics-node 的下载量有多少？

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

### @amplitude/analytics-node 还在维护吗？

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