@amplitude/identify

中文文档
1.10.2发布于 2022/09/08MITTypeScriptESM + CJS近 30 天下载 130.3万

用于构建和与识别API互动的功能

中文使用文档
文档目录3 节
  1. 与振幅- Javascript 兼容
  2. 组识别
  3. 全部清除


npm version

常规

用于构建和互动的功能 识别 API 与节点SDK. 这是一个构建器库,用于帮助界面创建"识别"事件. 这些事件有助于在您的分析中向用户和设备添加用户属性, 并且不计算为事件量 .

要使用此功能, 请创建一个标识实例并使用所提供的函数设置属性, 并按函数调用链条 :

import { Identify } from '@amplitude/identify'

const identify = new Identify();
identify
  .set('start_date', 'March 3rd')
  .add('num_clicks', 4)
  .unset('needs_to_activate')

然后,这个可以和节点SDK一起用来发送一个识别呼叫. 由于识别呼叫是特殊事件,有两种不同的实现方式:

import Amplitude from '@amplitude/node';

const client = Amplitude.init('YOUR_API_KEY');

// One way to call the identify
client.identify('USER_ID', 'DEVICE_ID', identify);
// Equivalent way to call identify
// Can also modify the identifyEvent directly here
const identifyEvent = identify.identifyUser('USER_ID', 'DEVICE_ID');
client.logEvent(identifyEvent);

与振幅- Javascript 兼容

这是 没有 兼容相位图 Javascript SDK ()amplitude-js) (中文(简体) ). 这个软件包不应与SDK一起使用,如果有,则识别的API应当 没有 用于节点SDK. 有计划巩固这些不相容之处 。 。 。 .

组识别

此标识支持 setGroup 函数. 任何针对此对象的识别操作呼叫都会 (单位:千美元) 被作为小组识别呼叫. 某些操作不会被转移至组属性(见关于 组识别 API 以查看此处支持哪些属性.

要不将用户与组标识连接,您也可以使用 identifyGroup 要发送的函数 $groupIdentify 一组事件.

全部清除

清除全部会清除用户的所有属性, 并清除所有前进事件的设备 . 仔细使用这个 并且确定这是您想要做的事情,而不是创建新的用户/设备代号. 当识别构建器上全部使用清空时,所有其他操作都会被取消,无法添加新的操作. 这是因为必须把全部清除作为自己的识别对象.

版本与发布记录

@amplitude/identify 共发布 23 个版本,首次发布于 2021/01/30;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.10.2latest2022/09/084 年前
1.10.12022/08/304 年前
1.10.02022/04/014 年前
1.9.22022/02/014 年前
1.9.12021/11/114 年前
1.9.02021/10/155 年前

关于 @amplitude/identify 的常见问题

@amplitude/identify 是什么?

用于构建和与识别API互动的功能

如何安装 @amplitude/identify?

在项目目录运行 npm install @amplitude/identify,或使用 pnpm add / yarn add / bun add。

@amplitude/identify 支持 TypeScript 吗?

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

@amplitude/identify 支持 ESM 还是 CommonJS?

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

@amplitude/identify 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=10。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@amplitude/identify 可以商用吗?

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

@amplitude/identify 的下载量有多少?

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

@amplitude/identify 还在维护吗?

最新版本 1.10.2 发布于 2022/09/08(4 年前);至今共发布 23 个版本,其中过去 12 个月发布了 0 个;首次发布于 2021/01/30。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。