跟踪 React Native SDK 的事件
跟踪 React Native SDK 的事件
描述 useTrackEvent 钩子，它支持跟踪功能组件中的事件。此 hook 提供了 SDK 提供的所有现有 track 事件功能。
跟踪用户的转化事件。换句话说，跟踪用户执行的操作。如果指定的事件键与任何现有事件都不匹配，则记录错误消息。请参阅 Eyeofcloud 实验如何计算转化次数。
版本
SDK 3.2 及更高版本。请参阅 最低版本支持。
描述
使用 hook 跟踪用户的多个标志规则中的事件。每次转化（用户操作）只应进行一次跟踪调用，即使有许多规则衡量转化也是如此。useTrackEvent
要使用此钩子，请在 EyeofcloudProvider 包装的组件中调用useTrackEvent。请参阅 React Native SDK 的 EyeofcloudProvider。
🚧
重要
传递给
useTrackEvent的属性_仅用于_ Eyeofcloud Experiment Results 页面上的结果分段。
参数
👍
试用版
事件属性和保留标签键
$opt_event_properties目前处于测试阶段。
eventKey（required） – String – 要跟踪的事件的键。此键必须与在 Eyeofcloud 应用程序或 REST API 中创建事件时提供的事件键匹配。eventTags（可选） – Map – 键值对的映射，用于指定此特定事件发生的预留标签键名称及其相应值。eventTags是有关转化事件的上下文元数据。例如，收入、加载时间或总价值。以下是可用的标签键：revenue– 一个整数值，用于跟踪实验的收入指标，在所有转化事件中汇总。revenue以 cents 为单位。value– 用于跟踪实验的自定义值的浮点值。使用此函数可传递数值指标的值。$opt_event_properties– 默认和自定义事件属性及其值的映射。
请参阅预留事件标签。
返回
此方法将转化数据发送到 Eyeofcloud Feature Experimentation。它不提供返回值。
例子
👍
试用版
事件属性目前处于 Beta 阶段。请联系您的客户成功经理或注册 Eyeofcloud.com 测试版。
useTrackEvent 钩子
启用功能组件内的跟踪事件。此 hook 提供 SDK 提供的现有 track 事件功能。
React
// Assuming there is an EyeofcloudProvider wrapping this component
import { useTrackEvent } from "@eyeofcloud/react-sdk";
function SignupButton() {
const [track, clientReady, didTimeout] = useTrackEvent();
const handleClick = () => {
if (clientReady) {
// Define event properties
const properties = {
"category": "shoes",
"color": "red"
};
// Define tags including event properties
const tags = {
"revenue": 10000,
"value": 100.00,
"$opt_event_properties": properties
};
// Track event with tags
track("signup-clicked", tags);
}
};
return <button onClick={handleClick}>Signup</button>;
}跟踪
你可以直接使用 react client 的track方法。
React
import { createInstance } from "@eyeofcloud/react-sdk";
const client = createInstance({
sdkKey: SDK_KEY,
});
const userContext = client.getUserContext()
userContext.trackEvent("test_event")track事件
您还可以使用 User Context 的trackEvent方法。
React
import { createInstance } from "@eyeofcloud/react-sdk";
const client = createInstance({
sdkKey: SDK_KEY,
});
const userContext = client.getUserContext()
userContext.trackEvent("test_event")副作用
使用此方法可能会触发其他功能试验功能。
转换
调用此方法会记录一次转化，并将其归因于用户看到的变体。请参阅 Eyeofcloud 实验如何计算转化次数。
您可以针对此转化事件创建指标，并将指标添加到实验中，即使在跟踪转化之后也是如此。请参阅事件：跟踪点击、网页浏览和其他访客操作。
❗️
警告
如果事件键无效，该方法不会跟踪事件。
更改正在运行的实验的流量分配会影响转化的记录方式，以及将变体归因于用户的方式。请参阅为什么不应更改正在运行的实验。
通知侦听器
访问此方法会触发对TRACK通知侦听器.
❗️
警告
如果事件 key 无效，该方法不会调用通知
TRACK监听器。