StageUp
Web SDKEvents

Basic Event Tracking

Track user interactions to analyze performance and optimize experience.

🚀 Basic Event Tracking

// SDK init
AdStage.init({
  apiKey: 'your-api-key'
});
 
// Track simple event
AdStage.events.track('button_click');
 
// Track with properties
AdStage.events.track('button_click', {
  button_id: 'hero_cta',
  button_text: 'Get Started Now',
  page: '/landing'
});
 
// Page view (manual for SPA route changes)
AdStage.events.track('page_view', {
  page_title: 'Home',
  page_path: '/',
  referrer: document.referrer
});

📊 Common Event Patterns

// E-commerce events
AdStage.events.track('view_item', {
  item_id: 'SKU123',
  item_name: 'Wireless Earbuds',
  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'
});
 
// Engagement events
AdStage.events.track('sign_up', {
  method: 'email',
  source: 'homepage'
});
 
AdStage.events.track('search', {
  search_term: 'wireless earbuds',
  results_count: 24
});

🎯 User Properties

setUserProperties Supported Fields

FieldTypeSupported ValuesDescription
genderstring'male''female'
countrystringAny (ISO 3166-1 alpha-2 recommended)Country code
citystringAnyCity name
agestringAnyAge or range ('25', '25-34')
languagestringAny (ISO 639-1 / BCP 47)Locale code

setDeviceInfo Supported Fields

FieldTypeSupported ValuesDescription
categorystring'mobile''desktop'
platformstringAnyPlatform name
modelstringAnyDevice model
appVersionstringAnyApp version
osVersionstringAnyOS version
AdStage.events.setUserId('user_12345');
 
AdStage.events.setUserProperties({
  gender: 'male',
  country: 'KR',
  city: 'Seoul',
  age: '25-34',
  language: 'ko-KR'
});
 
AdStage.events.setDeviceInfo({
  category: 'desktop',
  platform: 'Windows',
  model: 'Surface Pro',
  appVersion: '1.0.0',
  osVersion: 'Windows 11'
});

📝 Form Tracking

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'
  });
});

▶️ Next Steps

Explore advanced tracking:

Table of Contents