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 儀表板中以 分群 與 漏斗 進行更精準的使用者分析。

目錄