跟踪事件trackEvent

本主题介绍 Ruby SDK 的跟踪事件trackEvent方法，该方法跟踪云眼灰度发布（特性标帜）AB实验中的转化事件。

跟踪用户的转化事件（即用户执行的操作）。如果指定的事件键与任何现有事件不匹配，则记录错误消息。

版本

SDK v3.8 及更高版本

描述

使用此方法可跨用户的多个标帜规则跟踪事件。每次转化（即用户操作）只应进行一次跟踪调用，即使许多规则都在衡量转化也是如此。
在用户上调用跟踪事件trackEvent方法。有关用户对象的更多信息，请参阅云眼用户上下文。

传递给跟踪事件的属性仅用于结果细分。

参数

下表列出了跟踪事件trackEvent方法的必需参数和可选参数。

参数	类型	描述
_event_key(必填项)	字符串	要跟踪的事件的键。此键必须与在 Eyeofcloud 应用程序中创建事件时提供的事件键匹配。
event_tags(可选)	Map	指定此特定事件的标签名称及其相应标签值的键值对映射。值可以是字符串、数字或布尔值。 这些可用于跟踪数字指标，允许跟踪转化以外的操作，例如：收入、加载时间或总价值。请参阅有关保留标签键的详细信息。

返回

此方法将转化数据发送到云眼灰度发布（特性标帜）AB实验。它不提供返回值。

例

Rubby

user = eyeofcloud.create_user_context(userId, attributes)  

tags = {   
    "category" => "shoes",   
    "purchase_count" => 2 
}  

user.track_event("my_purchase_event_key", tags)

副作用

下表列出了使用此方法可能触发的其他云眼灰度发布（特性标帜）AB实验功能。

属性	描述
转换	调用此方法会记录转换，并将其归因于用户看到的变体。 可以针对此转化事件创建指标，并在跟踪转化后向实验添加指标。 有关更多信息，请参阅有关事件：跟踪点击、网页浏览和其他访问者操作的支持文档。 重要！ - 当指定的事件键无效时，此方法不会跟踪事件。 - 更改正在运行的实验的流量分配会影响转化的记录方式以及将变体归因于用户的方式。
通知侦听器	访问此方法会触发对TRACK通知侦听器的调用。 重要！ 此方法在指定的事件键无效时不会调用TRACK通知侦听器。