标准事件指南

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。难以映射的名称，直接作为自定义事件发送也可以。