標準事件指南

AdStage 標準事件指南

廣告追蹤事件 (AD_TRACKING)
生命週期事件 (LIFECYCLE)
內容瀏覽事件 (CONTENT)
電子商務事件 (ECOMMERCE)
訂閱與試用事件 (SUBSCRIPTION)
應用程式內廣告事件 (AD)
進度與成就事件 (PROGRESSION)
互動事件 (ENGAGEMENT)
金融事件 (FINANCE)
遊戲事件 (GAMING)
自訂事件

概觀

本文件不做重複說明，僅簡潔地提供標準事件清單與各類別的範例。

所有範例都以 AdStage.events.track(eventName, properties) 的形式傳送事件。事件名稱允許使用任意字串，因此下方標準事件中沒有的名稱也可以作為自訂事件自由傳送。不過，若要在歸因、轉換分析中取得一致的彙總結果，建議盡可能使用下方的標準事件名稱。

標準事件清單

類別	事件名稱	說明
廣告追蹤	`click`	廣告點擊
	`view`	廣告曝光/瀏覽
	`install`	應用程式安裝
生命週期	`sign_up`	註冊完成
	`sign_up_start`	註冊開始
	`login`	登入
	`logout`	登出
	`first_open`	首次啟動
內容瀏覽	`home_view`	首頁瀏覽
	`product_list_view`	商品清單瀏覽
	`search_result_view`	搜尋結果瀏覽
	`product_details_view`	商品詳細資訊瀏覽
	`page_view`	頁面瀏覽
	`screen_view`	畫面瀏覽
電子商務	`add_to_cart`	加入購物車
	`remove_from_cart`	從購物車移除
	`add_to_wishlist`	加入願望清單
	`add_payment_info`	新增付款資訊
	`begin_checkout`	開始結帳
	`purchase`	購買完成
	`refund`	退款
訂閱與試用	`start_trial`	開始免費試用
	`subscribe`	開始訂閱
	`unsubscribe`	取消訂閱
應用程式內廣告	`ad_impression`	應用程式內廣告曝光
	`ad_click`	應用程式內廣告點擊
進度與成就	`tutorial_begin`	教學開始
	`tutorial_complete`	教學完成
	`level_up`	升級
	`achievement`	達成成就
互動	`search`	搜尋
	`select_content`	內容選擇/點擊
	`share`	分享
	`like`	按讚
	`rate`	評分
	`schedule`	預約
	`spend_credits`	使用點數
金融	`sell_stock`	賣出股票
	`buy_stock`	買進股票
	`complete_open_account`	開戶完成
	`apply_card`	申請卡片
遊戲	`game_play`	遊戲進行
	`acquire_bonus`	取得獎勵
	`select_game_server`	選擇遊戲伺服器
	`complete_patch`	更新檔完成
自訂	`custom`	任意自訂事件

各事件類別指南

廣告追蹤事件 (AD_TRACKING)

作為廣告成效衡量與歸因核心的 MMP 事件。

支援的事件：click、view、install

// 廣告點擊
AdStage.events.track('click', {
  ad_platform: 'google_ads',
  ad_campaign: 'summer_campaign',
  ad_content: 'banner_01',
});
 
// 廣告曝光/瀏覽
AdStage.events.track('view', {
  ad_platform: 'google_ads',
  ad_campaign: 'summer_campaign',
});
 
// 應用程式安裝
AdStage.events.track('install', {
  ad_platform: 'facebook_ads',
  ad_campaign: 'brand_awareness',
});

生命週期事件 (LIFECYCLE)

與使用者驗證及帳戶管理、應用程式啟動相關的事件。

支援的事件：sign_up、sign_up_start、login、logout、first_open

// 註冊開始
AdStage.events.track('sign_up_start', {
  method: 'email', // 註冊方式: email, google, facebook 等
});
 
// 註冊完成
AdStage.events.track('sign_up', {
  method: 'email',
});
 
// 登入
AdStage.events.track('login', {
  method: 'google', // 登入方式
});
 
// 登出
AdStage.events.track('logout');
 
// 首次啟動（首次進入應用程式/網頁）
AdStage.events.track('first_open', {
  source: 'notification',
  campaign: 'push_campaign_01',
});

內容瀏覽事件 (CONTENT)

用於追蹤使用者的頁面瀏覽、畫面切換與內容探索的事件。

支援的事件：home_view、product_list_view、search_result_view、product_details_view、page_view、screen_view

// 首頁瀏覽
AdStage.events.track('home_view', {
  page_location: window.location.href,
});
 
// 頁面瀏覽
AdStage.events.track('page_view', {
  page_title: '商品清單',
  page_location: window.location.href,
  content_group1: 'product_category',
});
 
// 畫面瀏覽（SPA 應用程式）
AdStage.events.track('screen_view', {
  screen_name: 'product_list',
  screen_class: 'ProductListPage',
});
 
// 商品清單瀏覽
AdStage.events.track('product_list_view', {
  item_list_id: 'bestsellers',
  item_list_name: '暢銷商品',
  items: [
    /* 商品陣列 */
  ],
});
 
// 搜尋結果瀏覽
AdStage.events.track('search_result_view', {
  search_term: '智慧型手機',
  number_of_results: 24,
});
 
// 商品詳細資訊瀏覽
AdStage.events.track('product_details_view', {
  currency: 'KRW',
  value: 29000,
  items: [
    {
      item_id: 'PROD_123',
      item_name: '智慧手錶',
      item_category: 'Electronics',
      item_brand: 'Samsung',
      price: 29000,
      quantity: 1,
    },
  ],
});

電子商務事件 (ECOMMERCE)

用於追蹤線上購物與購買流程的核心事件。

支援的事件：add_to_cart、remove_from_cart、add_to_wishlist、add_payment_info、begin_checkout、purchase、refund

// 加入購物車
AdStage.events.track('add_to_cart', {
  currency: 'KRW',
  value: 29000,
  items: [
    {
      item_id: 'PROD_123',
      item_name: '智慧手錶',
      quantity: 1,
      price: 29000,
    },
  ],
});
 
// 從購物車移除
AdStage.events.track('remove_from_cart', {
  currency: 'KRW',
  value: 29000,
  items: [
    {
      item_id: 'PROD_123',
      quantity: 1,
    },
  ],
});
 
// 加入願望清單
AdStage.events.track('add_to_wishlist', {
  currency: 'KRW',
  value: 29000,
  items: [
    {
      item_id: 'PROD_123',
      item_name: '智慧手錶',
      price: 29000,
    },
  ],
});
 
// 開始結帳
AdStage.events.track('begin_checkout', {
  currency: 'KRW',
  value: 58000,
  coupon: 'SUMMER10',
  items: [
    /* 結帳商品清單 */
  ],
});
 
// 新增付款資訊
AdStage.events.track('add_payment_info', {
  currency: 'KRW',
  value: 58000,
  payment_type: 'credit_card',
});
 
// 購買完成
AdStage.events.track('purchase', {
  transaction_id: 'T_12345',
  currency: 'KRW',
  value: 58000,
  coupon: 'SUMMER10',
  shipping: 3000,
  tax: 5800,
  items: [
    /* 購買商品清單 */
  ],
});
 
// 退款
AdStage.events.track('refund', {
  transaction_id: 'T_12345',
  currency: 'KRW',
  value: 29000,
  items: [
    /* 退款商品清單 */
  ],
});

訂閱與試用事件 (SUBSCRIPTION)

與訂閱及免費試用相關的核心事件。

支援的事件：start_trial、subscribe、unsubscribe

// 開始免費試用
AdStage.events.track('start_trial', {
  trial_days: 7,
  plan_name: 'premium_trial',
});
 
// 開始訂閱
AdStage.events.track('subscribe', {
  subscription_id: 'SUB_123',
  plan_name: 'premium_monthly',
  value: 9.99,
  currency: 'USD',
});
 
// 取消訂閱
AdStage.events.track('unsubscribe', {
  subscription_id: 'SUB_123',
  plan_name: 'premium_monthly',
  cancellation_reason: 'price',
});

應用程式內廣告事件 (AD)

用於衡量應用程式內部曝光廣告成效的事件。

支援的事件：ad_impression、ad_click

// 應用程式內廣告曝光
AdStage.events.track('ad_impression', {
  ad_platform: 'google_ads',
  ad_source: 'google',
  ad_medium: 'cpc',
  ad_campaign: 'summer_campaign',
  ad_content: 'banner_01',
  value: 0.5,
});
 
// 應用程式內廣告點擊
AdStage.events.track('ad_click', {
  ad_platform: 'facebook_ads',
  ad_source: 'facebook',
  ad_medium: 'social',
  ad_campaign: 'brand_awareness',
});

進度與成就事件 (PROGRESSION)

用於追蹤使用者在學習、遊戲或工作上的進度與成就的事件。

支援的事件：tutorial_begin、tutorial_complete、level_up、achievement

// 教學開始
AdStage.events.track('tutorial_begin');
 
// 教學完成
AdStage.events.track('tutorial_complete', {
  tutorial_id: 'basic_tutorial',
  completion_time: 300, // 秒
});
 
// 升級
AdStage.events.track('level_up', {
  level: 5,
  character: 'warrior',
});
 
// 達成成就
AdStage.events.track('achievement', {
  achievement_id: 'first_win',
  achievement_name: '首勝',
});

互動事件 (ENGAGEMENT)

用於追蹤使用者與內容之間互動的事件。

支援的事件：search、select_content、share、like、rate、schedule、spend_credits

// 搜尋
AdStage.events.track('search', {
  search_term: '智慧型手機',
  content_group1: 'electronics',
});
 
// 內容選擇/點擊
AdStage.events.track('select_content', {
  content_type: 'product',
  content_id: 'PROD_123',
});
 
// 分享
AdStage.events.track('share', {
  content_type: 'product',
  content_id: 'PROD_123',
  method: 'facebook',
});
 
// 按讚
AdStage.events.track('like', {
  content_type: 'product',
  content_id: 'PROD_123',
});
 
// 評分
AdStage.events.track('rate', {
  content_type: 'product',
  content_id: 'PROD_123',
  rating: 5,
});
 
// 預約
AdStage.events.track('schedule', {
  content_type: 'consultation',
  scheduled_at: '2026-07-01T10:00:00Z',
});
 
// 使用點數
AdStage.events.track('spend_credits', {
  credit_name: 'coins',
  value: 100,
  item_name: 'power_up',
});

金融事件 (FINANCE)

針對證券、卡片、帳戶等金融服務的專用事件。

支援的事件：sell_stock、buy_stock、complete_open_account、apply_card

// 買進股票
AdStage.events.track('buy_stock', {
  symbol: 'AAPL',
  quantity: 10,
  price: 190.5,
  currency: 'USD',
});
 
// 賣出股票
AdStage.events.track('sell_stock', {
  symbol: 'AAPL',
  quantity: 5,
  price: 195.2,
  currency: 'USD',
});
 
// 開戶完成
AdStage.events.track('complete_open_account', {
  account_type: 'securities',
});
 
// 申請卡片
AdStage.events.track('apply_card', {
  card_type: 'credit',
  product_name: 'travel_card',
});

遊戲事件 (GAMING)

針對遊戲服務的專用事件。

支援的事件：game_play、acquire_bonus、select_game_server、complete_patch

// 遊戲進行
AdStage.events.track('game_play', {
  stage: 'world_1',
  mode: 'single',
});
 
// 取得獎勵
AdStage.events.track('acquire_bonus', {
  bonus_type: 'daily_login',
  value: 50,
});
 
// 選擇遊戲伺服器
AdStage.events.track('select_game_server', {
  server_id: 'asia_01',
  server_name: '亞洲 1 伺服器',
});
 
// 更新檔完成
AdStage.events.track('complete_patch', {
  patch_version: '1.2.0',
});

自訂事件

標準事件無法涵蓋的業務專屬事件，可以使用任意名稱自由傳送。事件名稱直接沿用 Firebase Analytics 風格的字串，標準事件清單中沒有的名稱也會被原樣收集。

// 業務專屬自訂事件（任意名稱）
AdStage.events.track('newsletter_subscribe', {
  source: 'footer_form',
  campaign: 'summer_news',
});
 
// 潛在客戶開發等標準中沒有的行銷事件也可作為自訂事件傳送
AdStage.events.track('generate_lead', {
  currency: 'KRW',
  value: 0, // 潛在客戶價值
  content_id: 'newsletter_signup',
});

若原本使用標準分類中沒有的名稱（例如 view_item、view_item_list、view_search_results、level_start、 unlock_achievement、spend_virtual_currency 等），建議盡可能對應為上述標準事件名稱後再使用。例如：view_item → product_details_view、 view_item_list → product_list_view、view_search_results → search_result_view、 unlock_achievement → achievement、spend_virtual_currency → spend_credits。難以對應的名稱，直接作為自訂事件傳送也可以。