使用实时区段发送 Eyeofcloud Data Platform 数据,以便为 JavaScript(浏览器)SDK 进行功能实验
使用实时区段发送 Eyeofcloud Data Platform 数据,以便为 JavaScript(浏览器)SDK 进行功能实验
使用 sendOdpEvent 方法将 Eyeofcloud 功能实验事件数据发送到 Eyeofcloud 数据平台 (ODP) 服务器。
先决条件
在从功能实验向 ODP 发送事件之前,您必须为功能实验集成配置实时区段。
JavaScript(浏览器)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 (浏览器) SDK 会立即丢弃该事件。
参数
下表列出了sendOdpEvent
方法的必需参数和可选参数。
参数 | 类型 | 描述 |
---|---|---|
_所需_操作 | 字符串 | 指定事件类型的子类别,该子类别将用于跟踪应用程序和用户生命周期。 |
类型 | 字符串 | 要发送的事件类型。如果未指定,则所有 JavaScript(浏览器)SDK 生成的事件都将是“fullstack”。 |
标识符 | Map<string, string> | 用户标识符的键值映射。JavaScript(浏览器)SDK 会将vuid 键值对添加到此可选的用户提供的标识符中。 |
数据 | Map<string,未知> | 键值映射中的事件数据。该值可以是任何类型(字符串、数字或布尔值)。允许使用 Null 值,但将被解释为空字符串。 JavaScript(浏览器)SDK 会将默认事件数据添加到给定的数据字典中。在创建字典时,可以通过发送相同的键来覆盖默认数据值。 * “idempotence_id”:<由 JavaScript(浏览器)SDK 创建的 UUID> * “data_source_type”:“sdk” * “data_source”:“javascript-browser-sdk” * “data_source_version”:<JavaScript-浏览器 SDK 版本已实现> |
返回
此方法将事件数据发送到 Eyeofcloud Data Platform (ODP)。它不提供返回值。
例
sendOdpEvent
的方法签名 :
sendOdpEvent(action: string, type?: string, identifiers?: Map<string, string>, data?: Map<string, unknown>): void;
JavaScript
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(浏览器)SDK 和 ODP 服务器之间的网络调用:
- 您的应用程序调用
sendOdpEvent
方法。 - JavaScript(浏览器)SDK 向 ODP 发出 POST 请求。
- ODP 以确认或相关错误进行响应。