使用实时区段发送 Eyeofcloud Data Platform 数据以进行功能实验和 Android 开发工具包

介绍将 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），Android SDK 会立即丢弃该事件。

参数

---

下表列出了sendODPEvent方法的必需参数和可选参数。

参数	类型	描述
类型	字符串	要发送的事件类型。对于所有 Android SDK 生成的事件（如果未指定），则为 “fullstack”。
_所需_操作	字符串	指定事件类型的子类别，用于跟踪应用程序和用户生命周期。
标识符	HashMap<String， 字符串>	用户标识符的键值映射。
数据	HashMap<String、任意>	键值映射中的事件数据。该值可以是任何类型（字符串、数字或布尔值）。允许使用 Null 值，但会解释为空字符串。 Android SDK 会将默认事件数据添加到给定的数据字典中。在创建 HashMap 时，可以通过发送相同的 key 来覆盖默认数据值。 * “idempotence_id”：<Android SDK 创建的 UUID> * “data_source_type”：“sdk” * “data_source”：“android-sdk” * “data_source_version”：<已实现 Android SDK 版本>

返回

---

该方法将事件数据发送到 ODP 服务器。它不提供返回值。

例

---

Kotlin

val identifiers: MutableMap<String, String> = HashMap() 
identifiers.put("fs-user-id", "user123") 
identifiers.put("email", "user123@eyeofcloud.com") 
val data: MutableMap<String, Any> = HashMap() 
data.put("item", "shirt") 
data.put("price", 50.00) 
eyeofcloudClient.sendODPEvent("fullstack", "purchased", identifiers, data)

Java

Map<String, String> identifiers = new HashMap<>();
identifiers.put("fs_user_id", "user123");
identifiers.put("email", "user123@eyeofcloud.com");
Map<String, Object> data = new HashMap<>();
                data.put("item", "shirt");
                data.put("price", 50.00);

eyeofcloudClient.sendODPEvent("fullstack", "purchased", identifiers, data);

下图显示了调用sendODPEvent方法时应用程序、Android SDK 和 ODP 服务器之间的网络调用：

sendODPEvent network diagram

1. 您的应用程序调用sendODPEvent方法。
2. Android SDK 向 ODP 发出 POST 请求。
3. ODP 以确认或相关错误进行响应。