跟踪事件trackEvent

描述跟踪事件trackEvent方法，该方法跟踪云眼灰度发布（特性标帜）AB实验中的转换事件。

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

版本

1.0.0-beta 或更高版本

描述

使用此方法可跨用户的多个标帜规则跟踪事件。您只应对每次转化（用户操作）进行一次跟踪调用，即使许多规则衡量转化也是如此。

在用户上调用跟踪事件trackEvent方法。有关用户对象的更多信息，请参阅云眼用户上下文。

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

参数

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

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

返回

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

例

Dart

var attributes = <String, dynamic>{}; 
attributes["logged_in"] = true; 
var user = await flutterSDK.createUserContext("user123", attributes);  

var tags = <String, dynamic>{}; 
tags["category"] = "shoes"; 
tags["purchase_count"] = 2;  

await user!.trackEvent("my_purchase_event_key", tags);

副作用

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

属性	描述
转换	调用此方法会记录转换，并将其归因于用户看到的变体。 可以针对此转化事件创建指标，并向实验添加指标，即使在系统跟踪转化之后也是如此。 有关详细信息，请参阅有关事件跟踪的支持文档。 重要！ - 当指定的事件键无效时，此方法不会跟踪事件。 - 更改正在运行的实验的流量分配会影响系统记录转化并将变化归因于用户的方式。
通知侦听器	访问此方法会触发对通知侦听器TRACK的调用。 重要！ 此方法在指定的事件键无效时不会调用通知侦听器TRACK。