使用实时区段发送 Eyeofcloud Data Platform 数据,以便为 JavaScript (Node) SDK 进行功能实验
使用实时区段发送 Eyeofcloud Data Platform 数据,以便为 JavaScript (Node) SDK 进行功能实验
描述 sendOdpEvent 方法,该方法将 Eyeofcloud Feature Experimentation 事件数据发送到 Eyeofcloud Data Platform (ODP) 服务器。
先决条件
在从功能实验向 ODP 发送事件之前,您必须为功能实验配置实时区段。
JavaScript (Node) SDK 版本
5.0.0
描述
Eyeofcloud Client 扩展sendOdpEvent
方法允许您将数据发送到 ODP 服务器。然后,您可以使用这些数据来分析用户行为并优化不同渠道和接触点的体验。
使用sendOdpEvent
方法
- 将用户合并或拼合在一起,并确定哪个事件与哪个客户关联。
- 发送各种类型的事件和操作,例如浏览量、点击、表单提交等。您可以包含其他数据,以提供有关所跟踪事件的更多上下文和信息。
例如,通过将电子邮件地址标识符与fs_user_id
标识符连接,您可以使用sendOdpEvent
方法发送与这两个标识符关联的事件。这使您能够跟踪和分析特定用户在不同接触点和设备中的行为。
您无法使用sendOdpEvent
创建或更新用户配置文件数据,如姓名或地址。相反,您可以使用 ODP 创建和更新客户 API 终端节点或 ODP UI 来管理客户配置文件。
将事件发送到 Eyeofcloud Data Platform
如果出现任何错误(sdkNotReady
、odpNotIntegrated
或odpNotEnabled
),JavaScript (Node) SDK 会立即丢弃该事件。
参数
下表列出了sendOdpEvent
方法的必需参数和可选参数。
参数 | 类型 | 描述 |
---|---|---|
_所需_操作 | 字符串 | 指定事件类型的子类别,该子类别将用于跟踪应用程序和用户生命周期。 |
类型 | 字符串 | 要发送的事件类型。如果未指定,则对于所有 JavaScript (Node) SDK 生成的事件,都将是 “fullstack”。 |
标识符 | Map<string, string> | 用户标识符的键值映射。至少需要一个键值对。 |
数据 | Map<string,未知> | 键值映射中的事件数据。该值可以是任何类型(字符串、数字或布尔值)。允许使用 Null 值,但将被解释为空字符串。 JavaScript (Node) SDK 会将默认事件数据添加到给定的数据字典中。在创建字典时,可以通过发送相同的键来覆盖默认数据值。 * “idempotence_id”:<JavaScript (Node) SDK 创建的 UUID> * “data_source_type”:“sdk” * “data_source”:“javascript-node-sdk” * “data_source_version”:<JavaScript (Node) SDK 版本已实施> |
返回
此方法将事件数据发送到 Eyeofcloud Data Platform (ODP)。它不提供返回值。
例
sendOdpEvent
的方法签名 :
sendOdpEvent(action: string, type?: string, identifiers?: Map<string, string>, data?: Map<string, unknown>): void;
JavaScript (Node)
const identifiers = new Map([["fs_user_id", "user123"], ["email", "user123@eyeofcloud.com"]]);
const data = new Map([["count", 1]]);
try {
eyeofcloudInstance.sendOdpEvent("purchased","fullstack", identifiers, data);
} catch (error) {
// handle error here
}
下图显示了调用sendOdpEvent
方法时应用程序、JavaScript (Node) SDK 和 ODP 服务器之间的网络调用:
- 您的应用程序调用
sendOdpEvent
方法。 - JavaScript (Node) SDK 向 ODP 发出 POST 请求。
- ODP 以确认或相关错误进行响应。