Clevertap 是一家提供营销自动化、用户行为分析的公司，leads-clevertap 利用 Clevertap 提供的 API，帮助我们更好地追踪、统计和分析用户的行为，并将这些数据同步到 Clevertap 中，用于后续的营销和运营活动。
本文将介绍如何使用 npm 包 leads-clevertap，记录和上传用户行为数据。
安装 leads-clevertap
在你的项目中使用 npm：
npm install leads-clevertap --save
在你的代码中引入：
const CleverTap = require('leads-clevertap');初始化 CleverTap
首先，我们需要先初始化 CleverTap：
const CleverTap = require('leads-clevertap');
const clevertap = new CleverTap({
accountID: '<your-account-id>',
passcode: '<your-passcode>',
region: '<your-region>'
});需要传入 accountID、passcode 和 region，分别对应你的 CleverTap 账号 ID、Passcode 和所在的地区（例如：us, eu, in）。
上传数据
我们可以使用 recordEvent() 方法上传一条事件：
clevertap.recordEvent({
identity: '<user-identity>',
type: '<event-type>',
properties: {
// 事件属性
}
});参数说明：
identity：字符串类型，标识用户的唯一 ID，例如手机号、邮箱等。type：字符串类型，事件类型。properties：对象类型，事件属性。
需要注意的是：identity 必传，指定用户的唯一标识，后续的事件都将与该用户关联。
以下是一个完整示例代码：
-- -------------------- ---- -------
----- --------- - ---------------------------
----- --------- - --- -----------
---------- --------------------
--------- ------------------
------- ---------------
---
-----------------------
--------- --------------
----- --------
----------- -
-------- ---------
----- --- ------
-
---批量上传
我们可以使用 upload() 方法批量上传事件数据，可以提高上传效率。
-- -------------------- ---- -------
------------------
-
--------- --------------------
----- -----------------
----------- -
-- ----
-
--
-
--------- --------------------
----- -----------------
----------- -
-- ----
-
-
---批量上传时，最多一次上传 1000 条记录，需要注意控制批量数据的数量和上传频率。
完整 API 列表
| Method | Description |
|---|---|
recordEvent() |
上传一条事件数据 |
upload() |
批量上传事件数据 |
profileSet() |
设置用户属性 |
profileGet() |
获取用户属性 |
profilePush() |
添加用户属性 |
profileRemove() |
删除用户属性 |
更多 API 详细介绍，请参考 leads-clevertap 官方文档。
结论
npm 包 leads-clevertap 提供了可靠的 Clevertap API 封装，帮助我们更好地追踪和统计用户的行为数据，并将这些数据同步到 Clevertap 平台上，方便做后续的营销和运营活动。在实际应用中，需要根据具体场景选择合适的数据上传方式，控制数据量和上传频率，从而提高数据上传效率和准确性。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600668f6d9381d61a3540ecb