adstage
Web SDK事件

基本事件跟踪

通过跟踪用户的行为与交互,可以分析并改进网站的成效。

🚀 基本事件跟踪

// SDK 初始化
AdStage.init({
  apiKey: 'your-api-key'
});
 
// 基本事件跟踪
AdStage.events.track('button_click');
 
// 带属性的事件跟踪
AdStage.events.track('button_click', {
  button_id: 'hero_cta',
  button_text: '立即开始',
  page: '/landing'
});
 
// 页面浏览跟踪(SPA 中手动调用)
AdStage.events.track('page_view', {
  page_title: '首页',
  page_path: '/',
  referrer: document.referrer
});

📊 常见事件模式

// 电子商务事件
AdStage.events.track('view_item', {
  item_id: 'SKU123',
  item_name: '无线耳机',
  price: 89000,
  currency: 'KRW'
});
 
AdStage.events.track('add_to_cart', {
  item_id: 'SKU123',
  quantity: 1,
  value: 89000
});
 
AdStage.events.track('purchase', {
  transaction_id: 'T12345',
  value: 178000,
  currency: 'KRW'
});
 
// 参与事件
AdStage.events.track('sign_up', {
  method: 'email',
  source: 'homepage'
});
 
AdStage.events.track('search', {
  search_term: '无线耳机',
  results_count: 24
});

🎯 设置用户属性

setUserProperties 支持的属性

属性类型支持的值说明
genderstring'male' | 'female' | 'other' | 'unknown'用户性别
countrystring自由输入(建议 ISO 3166-1 alpha-2)国家代码(例:'KR'、'US')
citystring自由输入城市名(例:'Seoul'、'New York')
agestring自由输入年龄或年龄段(例:'25'、'25-34')
languagestring自由输入(建议 ISO 639-1)语言代码(例:'ko-KR'、'en-US')

setDeviceInfo 支持的属性

属性类型支持的值说明
categorystring'mobile' | 'desktop' | 'tablet' | 'other'设备类别
platformstring自由输入平台名称(例:'Windows'、'macOS'、'iOS')
modelstring自由输入设备型号(例:'iPhone 15'、'MacBook Pro')
appVersionstring自由输入应用版本(例:'1.0.0'、'2.1.3')
osVersionstring自由输入操作系统版本(例:'14.0'、'macOS 14.1')
// 设置用户属性
AdStage.events.setUserProperties({
  gender: 'male',        // 'male' | 'female' | 'other' | 'unknown'
  country: 'KR',         // 国家代码
  city: 'Seoul',         // 城市名
  age: '25-34',          // 年龄段
  language: 'ko-KR'      // 语言代码
});
 
// 设置设备信息
AdStage.events.setDeviceInfo({
  category: 'desktop',   // 'mobile' | 'desktop' | 'tablet' | 'other'
  platform: 'Windows',  // 平台名称
  model: 'Surface Pro', // 设备型号
  appVersion: '1.0.0',  // 应用版本
  osVersion: 'Windows 11' // OS 版本
});

📝 表单事件跟踪

// 获取表单元素
const form = document.getElementById('contact-form');
 
form.addEventListener('submit', (e) => {
  e.preventDefault();
  
  // 表单提交事件
  AdStage.events.track('form_submit', {
    form_id: 'contact_form',
    form_type: 'contact',
    success: true
  });
  
  // 实际的表单提交逻辑
  submitForm(new FormData(form));
});
 
// 字段聚焦跟踪
document.getElementById('email').addEventListener('focus', () => {
  AdStage.events.track('form_field_focus', {
    form_id: 'contact_form',
    field_name: 'email'
  });
});

下一步

了解更多高级事件跟踪功能:

目录