客户端 SDK
自定义事件
使用任意属性追踪自定义事件
Version:
用任意属性追踪你业务中的自定义事件。
基础用法
// 简单事件
AudiencelabSDK.SendCustomEvent("level_completed");
// 带属性的事件
AudiencelabSDK.SendCustomEvent("level_completed", new {
level = 5,
score = 12500,
time_seconds = 120,
stars = 3
});
// 带去重 key 的事件
AudiencelabSDK.SendCustomEvent("achievement_unlocked",
new { achievement_id = "first_win" },
dedupeKey: "achievement_first_win_user123"
);参数
Prop
Type
示例
追踪关卡完成
AudiencelabSDK.SendCustomEvent("level_completed", new {
level = 5,
score = 12500,
difficulty = "hard",
stars = 3
});追踪新手引导进度
AudiencelabSDK.SendCustomEvent("tutorial_step", new {
step = "inventory_opened",
step_number = 3,
total_steps = 10
});使用去重 key
对于可能会重复发送的事件,建议使用 dedupeKey:
AudiencelabSDK.SendCustomEvent("achievement_unlocked",
new { achievement_id = "first_win" },
dedupeKey: $"achievement_first_win_{userId}"
);最佳实践
- 在行为发生的瞬间发送事件
- 在项目中使用一致的事件命名
- 在 properties 中带上足够的上下文,便于分析与排障