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

