使用 Real-Time Segments 发送 Eyeofcloud Data Platform 数据,以便为 C# SDK 进行功能实验
November 21, 2024About 3 min
使用 Real-Time Segments 发送 Eyeofcloud Data Platform 数据,以便为 C# SDK 进行功能实验
介绍将 Eyeofcloud 功能实验事件数据发送到 Eyeofcloud 数据平台 (ODP) 服务器的SendOdpEvent
方法。
先决条件
在从功能实验将事件发送到 Eyeofcloud Data Platform (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
),C# SDK 会立即丢弃该事件。- C# SDK 会丢弃所有事件(隐式或显式),并在数据文件准备就绪之前发出警告日志。在创建用户上下文并接受决策请求之前,请确保数据文件在 C# SDK 中已完全准备好。
参数
下表列出了SendOdpEvent
方法的必需参数和可选参数。
参数 | 类型 | 描述 |
---|---|---|
类型 | 字符串 | 要发送的事件类型。如果未指定,则所有 C# SDK 生成的事件都是“fullstack”。 |
_所需_操作 | 字符串 | 指定事件类型的子类别,用于跟踪应用程序和用户生命周期。 |
标识符 | 字典<string, string> | 用户标识符的键值映射。至少需要一个键值对。 |
数据 | Dictionary<string, object> | 键值映射中的事件数据。该值可以是任何类型(字符串、数字或布尔值)。您可以使用 null 值,但它们会变成空字符串。 C# SDK 将默认事件数据添加到给定的数据字典中。在创建 Dictionary 时发送相同的键会覆盖默认数据值。 * “idempotence_id”:<C# SDK 创建的 UUID> * “data_source_type”:“sdk” * “data_source”:“csharp-sdk” * “data_source_version”:<C# SDK 版本已实现> |
返回
此方法将事件数据发送到 Eyeofcloud Data Platform (ODP) 服务器。它不提供返回值。
例
C#
var projectConfigurationManager = new HttpProjectConfigManager.Builder()
.WithSdkKey("YOUR_SDK_KEY")
.WithPollingInterval(TimeSpan.FromSeconds(5))
.WithBlockingTimeoutPeriod(TimeSpan.FromMilliseconds(500))
.Build(defer: true);
var eyeofcloud = new Eyeofcloud(projectConfigurationManager);
var attributes = new UserAttributes
{
{ "laptop_os", "mac" },
};
var userContext = eyeofcloud.CreateUserContext("user123", attributes);
userContext.FetchQualifiedSegments();
userContext.IsQualifiedFor("segment1");
下图显示了调用SendOdpevent
方法时应用程序、C# SDK 和 ODP 服务器之间的网络调用:
- 您的应用程序调用
SendOdpEvent
方法。 - C# SDK 向 ODP 发出请求。
- ODP 以确认或相关错误进行响应。