Standard Events Guide

AdStage Standard Events Guide

Overview
Standard Events List
Guides by Category

User Events (USER_EVENTS)
Page & Screen Events (VIEW_EVENTS)
Interaction Events (INTERACTION_EVENTS)
Ecommerce Events (ECOMMERCE_EVENTS)
Progress Events (PROGRESS_EVENTS)
Ad Events (AD_EVENTS)
Business Events (BUSINESS_EVENTS)

Overview

This page provides a concise list of standard events and category-specific examples without duplicate setup instructions.

Standard Events List

Category	Event name	Description
User Events	`sign_up`	Sign up
	`login`	Log in
	`logout`	Log out
	`join_group`	Join group
	`generate_lead`	Generate lead
Page/Screen Events	`page_view`	Page view
	`screen_view`	Screen view
	`view_item_list`	View item list
	`view_search_results`	View search results
Interaction Events	`search`	Search
	`select_content`	Select/Click content
	`share`	Share
	`click`	General click
	`scroll`	Scroll
	`file_download`	File download
Ecommerce Events	`view_item`	View item
	`add_to_cart`	Add to cart
	`remove_from_cart`	Remove from cart
	`view_cart`	View cart
	`begin_checkout`	Begin checkout
	`add_payment_info`	Add payment info
	`add_shipping_info`	Add shipping info
	`purchase`	Purchase
	`refund`	Refund
Progress Events	`level_start`	Level start
	`level_end`	Level complete
	`level_up`	Level up
	`tutorial_begin`	Tutorial begin
	`tutorial_complete`	Tutorial complete
	`post_score`	Post score
	`unlock_achievement`	Unlock achievement
Ad Events	`ad_impression`	Ad impression
	`ad_click`	Ad click
	`ad_view`	Ad view
	`ad_dismiss`	Ad dismiss/skip
Business Events	`subscribe`	Start subscription
	`unsubscribe`	Cancel subscription
	`start_trial`	Start free trial
	`spend_virtual_currency`	Spend virtual currency
	`earn_virtual_currency`	Earn virtual currency
	`app_open`	App open

Guides by Category

User Events (USER_EVENTS)

Events related to user authentication and account lifecycle.

Supported events: sign_up, login, logout, join_group, generate_lead

// Sign up
AdStage.event('sign_up', {
  method: 'email', // email, google, facebook, etc.
});
 
// Log in
AdStage.event('login', {
  method: 'google',
});
 
// Log out
AdStage.event('logout');
 
// Join group (community/team)
AdStage.event('join_group', {
  group_id: 'tech_community',
  group_name: 'Tech Community',
});
 
// Generate lead (marketing intent)
AdStage.event('generate_lead', {
  currency: 'USD',
  value: 0,
  content_id: 'newsletter_signup',
});

Page & Screen Events (VIEW_EVENTS)

Track page views and screen transitions.

Supported events: page_view, screen_view, view_item_list, view_search_results

// Page view
AdStage.event('page_view', {
  page_title: 'Product List',
  page_location: window.location.href,
  content_group1: 'product_category',
});
 
// Screen view (SPA)
AdStage.event('screen_view', {
  screen_name: 'product_list',
  screen_class: 'ProductListPage',
});
 
// View item list
AdStage.event('view_item_list', {
  item_list_id: 'bestsellers',
  item_list_name: 'Best Sellers',
  items: [
    /* items */
  ],
});
 
// View search results
AdStage.event('view_search_results', {
  search_term: 'smartphone',
  number_of_results: 24,
});

Interaction Events (INTERACTION_EVENTS)

Track user interactions with content.

Supported events: search, select_content, share, click, scroll, file_download

// Search
AdStage.event('search', {
  search_term: 'smartphone',
  content_group1: 'electronics',
});
 
// Select/Click content
AdStage.event('select_content', {
  content_type: 'product',
  content_id: 'PROD_123',
});
 
// Share
AdStage.event('share', {
  content_type: 'product',
  content_id: 'PROD_123',
  method: 'facebook',
});
 
// General click (CTR)
AdStage.event('click', {
  link_url: 'https://example.com/special-offer',
  link_text: 'View Special Offer',
});
 
// Scroll depth
AdStage.event('scroll', {
  percent_scrolled: 75,
});
 
// File download
AdStage.event('file_download', {
  file_name: 'product_catalog.pdf',
  file_extension: 'pdf',
});

Ecommerce Events (ECOMMERCE_EVENTS)

Core events for online shopping and checkout.

Supported events: view_item, add_to_cart, remove_from_cart, view_cart, begin_checkout, add_payment_info, add_shipping_info, purchase, refund

// View item
AdStage.event('view_item', {
  currency: 'USD',
  value: 29.0,
  items: [
    {
      item_id: 'PROD_123',
      item_name: 'Smart Watch',
      item_category: 'Electronics',
      item_brand: 'Samsung',
      price: 29.0,
      quantity: 1,
    },
  ],
});
 
// Add to cart
AdStage.event('add_to_cart', {
  currency: 'USD',
  value: 29.0,
  items: [
    {
      item_id: 'PROD_123',
      item_name: 'Smart Watch',
      quantity: 1,
      price: 29.0,
    },
  ],
});
 
// Remove from cart
AdStage.event('remove_from_cart', {
  currency: 'USD',
  value: 29.0,
  items: [
    {
      item_id: 'PROD_123',
      quantity: 1,
    },
  ],
});
 
// View cart
AdStage.event('view_cart', {
  currency: 'USD',
  value: 58.0,
  items: [
    /* cart items */
  ],
});
 
// Begin checkout
AdStage.event('begin_checkout', {
  currency: 'USD',
  value: 58.0,
  coupon: 'SUMMER10',
  items: [
    /* checkout items */
  ],
});
 
// Add payment info
AdStage.event('add_payment_info', {
  currency: 'USD',
  value: 58.0,
  payment_type: 'credit_card',
});
 
// Add shipping info
AdStage.event('add_shipping_info', {
  currency: 'USD',
  value: 58.0,
  shipping_tier: 'express',
});
 
// Purchase
AdStage.event('purchase', {
  transaction_id: 'T_12345',
  currency: 'USD',
  value: 58.0,
  coupon: 'SUMMER10',
  shipping: 3.0,
  tax: 5.8,
  items: [
    /* purchased items */
  ],
});
 
// Refund
AdStage.event('refund', {
  transaction_id: 'T_12345',
  currency: 'USD',
  value: 29.0,
  items: [
    /* refunded items */
  ],
});

Progress Events (PROGRESS_EVENTS)

Track learning, gaming, and workflow progress.

Supported events: level_start, level_end, level_up, tutorial_begin, tutorial_complete, post_score, unlock_achievement

// Level start
AdStage.event('level_start', {
  level_name: 'Tutorial',
  character: 'warrior',
});
 
// Level complete
AdStage.event('level_end', {
  level_name: 'Tutorial',
  success: true,
  character: 'warrior',
});
 
// Level up
AdStage.event('level_up', {
  level: 5,
  character: 'warrior',
});
 
// Tutorial begin
AdStage.event('tutorial_begin');
 
// Tutorial complete
AdStage.event('tutorial_complete', {
  tutorial_id: 'basic_tutorial',
  completion_time: 300, // seconds
});
 
// Post score
AdStage.event('post_score', {
  score: 15420,
  level: 5,
  character: 'warrior',
});
 
// Unlock achievement
AdStage.event('unlock_achievement', {
  achievement_id: 'first_win',
  achievement_name: 'First Win',
});

Ad Events (AD_EVENTS)

Measure ad performance.

Supported events: ad_impression, ad_click, ad_view, ad_dismiss

// Ad impression
AdStage.event('ad_impression', {
  ad_platform: 'google_ads',
  ad_source: 'google',
  ad_medium: 'cpc',
  ad_campaign: 'summer_campaign',
  ad_content: 'banner_01',
  value: 0.5,
});
 
// Ad click
AdStage.event('ad_click', {
  ad_platform: 'facebook_ads',
  ad_source: 'facebook',
  ad_medium: 'social',
  ad_campaign: 'brand_awareness',
});
 
// Ad view (video)
AdStage.event('ad_view', {
  ad_platform: 'youtube_ads',
  ad_format: 'video',
  ad_duration: 30,
  view_duration: 15,
});
 
// Ad dismiss/skip
AdStage.event('ad_dismiss', {
  ad_platform: 'display_network',
  dismiss_reason: 'skip',
});

Business Events (BUSINESS_EVENTS)

Events related to subscriptions, payments, and business models.

Supported events: subscribe, unsubscribe, start_trial, spend_virtual_currency, earn_virtual_currency, app_open

// Start subscription
AdStage.event('subscribe', {
  subscription_id: 'SUB_123',
  plan_name: 'premium_monthly',
  value: 9.99,
  currency: 'USD',
});
 
// Cancel subscription
AdStage.event('unsubscribe', {
  subscription_id: 'SUB_123',
  plan_name: 'premium_monthly',
  cancellation_reason: 'price',
});
 
// Start free trial
AdStage.event('start_trial', {
  trial_days: 7,
  plan_name: 'premium_trial',
});
 
// Spend virtual currency
AdStage.event('spend_virtual_currency', {
  virtual_currency_name: 'coins',
  value: 100,
  item_name: 'power_up',
});
 
// Earn virtual currency
AdStage.event('earn_virtual_currency', {
  virtual_currency_name: 'coins',
  value: 50,
  source: 'daily_bonus',
});
 
// App open (session start)
AdStage.event('app_open', {
  source: 'notification',
  campaign: 'push_campaign_01',
});