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