使用实时区段发送 Eyeofcloud Data Platform 数据,以便为 GO SDK 进行功能实验
November 21, 2024About 3 min
使用实时区段发送 Eyeofcloud Data Platform 数据,以便为 GO SDK 进行功能实验
介绍将 Eyeofcloud 功能实验事件数据发送到 Eyeofcloud 数据平台 (ODP) 服务器的SendOdpEvent
方法。
先决条件
在将事件从功能实验发送到 Eyeofcloud Data Platform (ODP) 之前,您必须为功能实验配置实时区段。
最低 SDK 版本
2.0.0
描述
Eyeofcloud 客户端扩展方法SendOdpEvent
允许您将数据发送到 ODP 服务器。然后,这些数据可用于分析用户行为并优化不同渠道和接触点的体验。
SendOdpEvent
方法可用于:
- 将用户合并或拼合在一起,并确定哪个事件与哪个客户关联。
- 发送各种类型的事件和操作,例如浏览量、点击、表单提交等。使用此方法时,您可以包含其他数据,以提供有关所跟踪事件的更多上下文和信息。
例如,通过将电子邮件地址标识符与fs_user_id``SendOdpEvent
标识符连接,您可以使用该方法发送与这两个标识符关联的事件。这使您能够跟踪和分析特定用户在不同接触点和设备中的行为。
您无法使用SendOdpEvent
创建或更新用户配置文件数据,如姓名或地址。相反,您可以使用 ODP 创建和更新客户 API 终端节点或 ODP UI 来管理客户配置文件。
将事件发送到 Eyeofcloud Data Platform
📘
笔记
- 如果出现任何错误(
sdkNotReady
、odpNotIntegrated
或odpNotEnabled
),Go SDK 会立即丢弃该事件。- 如果在数据文件准备就绪并发送警告日志之前请求,则所有事件(隐式或显式)都将被丢弃。
- 在您创建用户上下文并接受决策请求之前,数据文件应在 Go SDK 中完全准备好。
参数
下表列出了SendOdpEvent
方法的必需参数和可选参数。
参数 | 类型 | 描述 |
---|---|---|
eventType 事件类型 | 字符串 | 要发送的事件类型。对于所有 Go SDK 生成的事件(如果未指定),则为 “fullstack”。 |
_所需_操作 | 字符串 | 指定事件类型的子类别,用于跟踪应用程序和用户生命周期。 |
标识符 | map[string]字符串 | 用户标识符的键值映射。至少需要一个键值对。 |
数据 | map[string]interface{} | 键值映射中的事件数据。该值可以是任何类型(字符串、数字或布尔值)。允许使用 Null 值,但会解释为空字符串。 Go SDK 将默认事件数据添加到给定的数据字典中。您可以通过在创建 HashMap 时发送相同的键来覆盖默认数据值。 * “idempotence_id”:<Go SDK 创建的 UUID> * “data_source_type”:“sdk” * “data_source”:“go-sdk” * “data_source_version”:<Go SDK 版本已实现> |
返回
此方法将事件数据发送到 Eyeofcloud Data Platform (ODP) 服务器。当出现任何问题时,它会返回一个错误,否则返回 nil。
例
Go
identifiers := map[string]string{"fs_user_id": "user123", "email": "user123@eyeofcloud.com"}
data := map[string]interface{}{"item": "shirt", "price": 50.00}
err := eyeofcloudClient.SendOdpEvent("fullstack", "purchased", identifiers, data)
下图显示了调用SendOdpEvent
方法时应用程序、Go SDK 和 ODP 服务器之间的网络调用。
- 您的应用程序调用
sendODPEvent
方法。 - Go SDK 向 ODP 发出 POST 请求。
- ODP 以确认或相关错误进行响应。