使用实时区段发送 Eyeofcloud Data Platform 数据，以便为 Java 开发工具包进行功能实验

介绍将 Eyeofcloud 功能实验事件数据发送到 Eyeofcloud 数据平台 （ODP） 服务器的sendODPEvent方法。

先决条件

---

在从功能实验向 ODP 发送事件之前，您必须为功能实验配置实时区段。

最低 SDK 版本

---

4.0.0

描述

---

Eyeofcloud Client 扩展sendOdpEvent方法允许您将数据发送到 ODP 服务器。然后，您可以使用这些数据来分析用户行为并优化不同渠道和接触点的体验。

使用sendOdpEvent方法

• 将用户合并或拼合在一起，并确定哪个事件与哪个客户关联。
• 发送各种类型的事件和操作，例如浏览量、点击、表单提交等。您可以包含其他数据，以提供有关所跟踪事件的更多上下文和信息。

例如，通过将电子邮件地址标识符与fs_user_id标识符连接，您可以使用sendOdpEvent方法发送与这两个标识符关联的事件。这使您能够跟踪和分析特定用户在不同接触点和设备中的行为。

您无法使用sendODPEvent创建或更新用户配置文件数据，如姓名或地址。相反，您可以使用ODP 创建和更新客户 API 终端节点或ODP UI 来管理客户配置文件。

将事件发送到 Eyeofcloud Data Platform

---

📘

注意

---

• 如果出现任何错误（sdkNotReady、odpNotIntegrated或odpNotEnabled），Java SDK 会立即丢弃该事件。
• 如果在数据文件准备就绪之前请求，Java SDK 会丢弃所有事件（隐式或显式），并显示警告日志。在创建用户上下文并接受决策请求之前，数据文件应在 Java SDK 中完全准备好。

参数

---

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

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

返回

---

此方法将事件数据发送到 Eyeofcloud Data Platform （ODP） 服务器。它不提供返回值。

例

---

sendODPEvent(String type, String action, Map<String, String> identifiers, Map<String, Object> 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);

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

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

Java SDK network diagram for calling ODP

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