adstage
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 仪表板中用 分群 和 漏斗 进行更准确的用户分析。

目录