Web SDK事件
自定义事件
可以创建贴合业务的专属事件,用来分析更具体的用户行为。
🎯 创建自定义事件
应该创建什么样的事件?
如果业务中有特别看重的用户行为,就把它做成事件吧:
// 如果是菜谱网站
AdStage.events.track('recipe_bookmarked', {
recipe_id: 'chicken_curry_123',
recipe_name: '咖喱鸡',
difficulty: 'medium',
cooking_time: 30
});
// 如果是在线商城
AdStage.events.track('wishlist_added', {
product_id: 'PROD_456',
product_name: '无线耳机',
price: 89000,
category: '电子产品'
});事件名称该怎么取?
并没有特别的规则,不过最好使用含义明确、日后便于查找的名称:
// 像这样命名,之后分析时更容易区分
AdStage.events.track('video_play_started', { video_id: '123' });
AdStage.events.track('video_play_completed', { video_id: '123' });
// 相似的功能最好用相似的模式来命名
AdStage.events.track('course_lesson_started', { course_id: 'js101', lesson_id: 'variables' });
AdStage.events.track('course_lesson_completed', { course_id: 'js101', lesson_id: 'variables' });🏢 按行业的使用示例
如果是在线商城
跟踪这些事件,可以更好地理解顾客的购物模式:
// 快速预览商品时
AdStage.events.track('product_quick_preview', {
product_id: 'PROD_123',
product_name: '无线耳机',
price: 89000,
from_section: '推荐商品'
});
// 加入心愿单时
AdStage.events.track('added_to_wishlist', {
product_id: 'PROD_123',
current_wishlist_count: 5,
product_price: 89000
});
// 申请到货通知时 - 跟踪它有助于掌握热门商品
AdStage.events.track('restock_alert_requested', {
product_id: 'PROD_456',
product_name: '已售罄的商品',
user_email_domain: 'gmail.com' // 个人信息像这样做泛化处理
});
// 撰写评价时
AdStage.events.track('review_written', {
product_id: 'PROD_123',
rating: 5,
review_has_photo: true
});如果是在线课程平台
要分析学习者的学习模式,这些事件很有用:
// 跟踪课程看了多少 - 用它可以找出较难的区间
AdStage.events.track('lesson_watched', {
course_name: 'JavaScript 基础',
lesson_title: '变量与数据类型',
watch_percentage: 75,
watch_time_minutes: 8,
rewound_count: 2 // 回放次数 - 可掌握较难的部分
});
// 测验结果 - 适合衡量学习效果
AdStage.events.track('quiz_finished', {
quiz_name: 'JS 基础测验',
score: 85,
total_score: 100,
attempt_number: 1, // 第几次尝试
passed: true
});
// 拿到结业证书时 - 用于完课率分析
AdStage.events.track('course_completed', {
course_name: 'JavaScript 基础',
completion_days: 14, // 完课所花的天数
final_score: 92
});如果是游戏
要分析玩家的游戏模式与乐趣要素,这些事件很有帮助:
// 开始游戏时
AdStage.events.track('game_started', {
game_mode: '生存模式',
difficulty: '困难',
character_level: 15,
playtime_today_minutes: 45 // 今天的游戏时长
});
// 升级时 - 对调整游戏平衡很有用
AdStage.events.track('level_up', {
new_level: 15,
time_to_levelup_minutes: 45, // 升级所花的时间
main_activity: 'monster_hunting' // 主要靠做什么升级的
});
// 获得道具时
AdStage.events.track('item_obtained', {
item_name: '传说之剑',
item_grade: 'legendary',
how_obtained: 'Boss 掉落', // 如何获得的
player_level: 15
});
// 购买付费道具 - 用于收入分析
AdStage.events.track('item_purchased', {
item_type: '游戏币',
amount: 1000,
real_price: 9900, // 韩元
reason: '游戏币不足' // 购买原因
});如果是博客或媒体网站
想知道哪些内容受欢迎、读者又是怎么阅读的,这些事件很合适:
// 读完一篇文章时 - 可以知道哪些文章会被读到最后
AdStage.events.track('article_finished_reading', {
article_title: '2024 技术趋势',
category: '技术',
read_time_minutes: 4,
scroll_percentage: 100,
word_count: 1200
});
// 发表评论时 - 衡量参与度
AdStage.events.track('comment_added', {
article_title: '有趣的报道',
comment_length: 85,
is_reply: false, // 是评论还是回复评论
user_type: 'regular_reader' // 是否为常来的读者
});
// 订阅邮件通讯 - 获得忠诚度高的读者
AdStage.events.track('newsletter_signed_up', {
newsletter_type: '每周摘要',
signup_location: '文章底部 CTA',
reader_visits_this_month: 5 // 本月访问次数
});
// 分享文章 - 衡量传播效果
AdStage.events.track('article_shared', {
article_title: '热门报道',
share_platform: 'twitter',
share_location: '文章顶部' // 在哪里点了分享按钮
});💡 实际动手试试
创建自定义事件时,请先想清楚“以后想用这些数据了解什么”:
// 举例来说,如果想知道用户在什么时候流失
AdStage.events.track('page_exit_attempt', {
page_name: '商品详情页面',
time_on_page_seconds: 30,
scroll_depth: 25,
exit_trigger: 'back_button' // 返回、关闭标签页等
});
// 如果想知道哪个功能受欢迎
AdStage.events.track('feature_used', {
feature_name: '价格比较',
user_type: 'premium',
usage_count_today: 3
});像这样创建贴合业务的事件后,就能在 AdStage 仪表板中用 分群 和 漏斗 进行更准确的用户分析。

