跟踪事件trackEvent
跟踪事件trackEvent
本主题介绍 JavaScript（节点）SDK 的跟踪事件trackEvent方法，该方法跟踪云眼灰度发布（特性标帜）AB实验中的转化事件。
跟踪用户的转化事件（即用户执行的操作）。如果指定的事件键与任何现有事件不匹配，则记录错误消息。
版本
SDK 4.5 及更高版本
描述
使用此方法可跨用户的多个标帜规则跟踪事件。每次转化（即用户操作）只应进行一次跟踪调用，即使许多规则都在衡量转化也是如此。
在用户上调用跟踪事件trackEvent方法。有关用户对象的更多信息，请参阅云眼用户上下文。
传递给跟踪事件的属性仅用于结果细分。
参数
下表列出了跟踪事件trackEvent方法的必需参数和可选参数。
参数
类型
描述
(必选)事件键（Key）
字符串
要跟踪的事件的键。此键必须与在 Eyeofcloud 应用程序中创建事件时提供的事件键匹配。
事件标签
可选
Map
指定此特定事件的标签名称及其相应标签值的键值对映射。值可以是字符串、数字或布尔值。
这些可用于跟踪数字指标，允许跟踪转化以外的操作，例如：收入、加载时间或总价值。请参阅有关保留标签键的详细信息。
返回
此方法将转化数据发送到云眼灰度发布（特性标帜）AB实验。它不提供返回值。
例
JavaScript
var attributes = { logged_in: true }; var user = eyeofcloudClient.createUserContext('user123', attributes); var tags = { category: 'shoes', purchase_count: 2 }; user.trackEvent("my_purchase_event_key", tags);
副作用
下表列出了使用此方法可能触发的其他 Eyeofcloud 功能。
功能性
描述
转换
调用此方法会记录转换，并将其归因于用户看到的变体。
可以针对此转化事件创建指标，并在跟踪转化后向实验添加指标。
有关更多信息，请参阅有关事件：跟踪点击、网页浏览和其他访问者操作的支持文档。
重要！
- 当指定的事件键无效时，此方法不会跟踪事件。
- 更改正在运行的实验的流量分配会影响转化的记录方式以及将变体归因于用户的方式。
Notification listeners
Accessing this method triggers a call to the notification listener.
Important!
This method will not call the notification listener when the specified event key is invalid.TRACK``TRACK
Source files
The language/platform source files containing the implementation for JavaScript is index.js.
Updated 2 months ago
[
Decide methods
](/experimentation/v4.0.0-full-stack/docs/decide-methods-javascript-node)[
EyeofcloudConfig
](/experimentation/v4.0.0-full-stack/docs/eyeofcloudconfig-javascript-node)
Did this page help you?
Yes
No
创建用户上下文
介绍创建用户上下文方法，该方法为云眼灰度发布（特性标帜）AB实验中的标帜决策和事件创建用户上下文。
此方法的目的是创建用户并设置用户上下文一次，因此不必在每次做出标帜决策或跟踪事件时都指定用户。可以定义多个用户上下文。系统将用户上下文作为运行时对象返回，否则不会持久化。
版本
1.0.0-beta 或更高版本
描述
此调用为标帜决策和事件创建用户上下文。可以在 Eyeofcloud 客户端实例上成功调用此方法，甚至在完全配置实例之前也是如此。
参数
下表列出了必需参数和可选参数：
参数
类型
描述
(必选)用户 ID
字符串
用户的 ID。
属性
可选
Map
自定义键值字符串对的映射，指定系统用户用于受众群体定位的用户的属性。有关更多详细信息，请参阅以下部分。
受众群体属性
为用户设置自定义受众群体属性，可以使用这些属性来定位受众群体。可以将字符串、数字、布尔值和 nil 作为自定义用户属性值传递。如果要根据他们使用的应用程序变体定位访问群体，还可以传入格式为语义变体的字符串，然后在 Eyeofcloud 应用中定义受众条件。version
🚧 重要
在访问群体评估期间，如果没有为给定的访问群体条件传递有效的属性值（例如，如果在受众群体条件需要布尔值时传递字符串，或者忘记传递值），则系统会跳过该条件。发生这种情况时，SDK 日志会包含警告。
返回
返回一个 EyeofcloudUserContext 对象。有关详细信息，请参阅云眼用户上下文。
例
Dart
// option 1: create a user, then set attributes var user = await flutterSDK.createUserContext("user123"); var attributes = <String, dynamic>{}; attributes["is_logged_in"] = false; attributes["app_version"] = "1.3.2"; user!.setAttributes(attributes); // option 2: pass attributes when creating the user var attributes = <String, dynamic>{}; attributes["is_logged_in"] = false; attributes["app_version"] = "1.3.2"; var eyeofcloudUserContext = await eyeofcloudClient.createUserContext("user123", attributes);
参见
源文件
包含 Flutter SDK for Android Eyeofcloud 和 Swift 实现的语言/平台源文件.java为 EyeofcloudClient.swift。