Standard Events Guide

AdStage Standard Events Guide

Overview
Standard Events List
Guide by Event Category

Ad Tracking Events (AD_TRACKING)
Lifecycle Events (LIFECYCLE)
Content View Events (CONTENT)
E-commerce Events (ECOMMERCE)
Subscription & Trial Events (SUBSCRIPTION)
In-App Ad Events (AD)
Progression & Achievement Events (PROGRESSION)
Engagement Events (ENGAGEMENT)
Finance Events (FINANCE)
Gaming Events (GAMING)
Custom Events

Overview

This document provides only the standard events list and per-category examples, concisely and without redundant explanation.

Every example sends an event in the form AdStage.events.track(eventName, properties). Event names accept arbitrary strings, so any name not in the standard events below can also be freely sent as a custom event. However, to obtain consistent aggregation in attribution and conversion analysis, we recommend using the standard event names below whenever possible.

Standard Events List

Category	Event Name	Description
Ad Tracking	`click`	Ad click
	`view`	Ad impression/view
	`install`	App install
Lifecycle	`sign_up`	Sign-up completed
	`sign_up_start`	Sign-up started
	`login`	Login
	`logout`	Logout
	`first_open`	First open
Content View	`home_view`	Home screen view
	`product_list_view`	Product list view
	`search_result_view`	Search result view
	`product_details_view`	Product details view
	`page_view`	Page view
	`screen_view`	Screen view
E-commerce	`add_to_cart`	Add to cart
	`remove_from_cart`	Remove from cart
	`add_to_wishlist`	Add to wishlist
	`add_payment_info`	Add payment info
	`begin_checkout`	Begin checkout
	`purchase`	Purchase completed
	`refund`	Refund
Subscription & Trial	`start_trial`	Free trial started
	`subscribe`	Subscription started
	`unsubscribe`	Subscription canceled
In-App Ad	`ad_impression`	In-app ad impression
	`ad_click`	In-app ad click
Progression & Achievement	`tutorial_begin`	Tutorial started
	`tutorial_complete`	Tutorial completed
	`level_up`	Level up
	`achievement`	Achievement unlocked
Engagement	`search`	Search
	`select_content`	Content select/click
	`share`	Share
	`like`	Like
	`rate`	Rating submitted
	`schedule`	Schedule
	`spend_credits`	Spend credits
Finance	`sell_stock`	Sell stock
	`buy_stock`	Buy stock
	`complete_open_account`	Account opening completed
	`apply_card`	Card application
Gaming	`game_play`	Game play
	`acquire_bonus`	Acquire bonus
	`select_game_server`	Select game server
	`complete_patch`	Patch completed
Custom	`custom`	Arbitrary custom event

Guide by Event Category

Ad Tracking Events (AD_TRACKING)

MMP events that are central to ad performance measurement and attribution.

Supported events: 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 Events (LIFECYCLE)

Events related to user authentication, account management, and app launch.

Supported events: 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 View Events (CONTENT)

Events that track a user's page views, screen transitions, and content browsing.

Supported events: 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,
    },
  ],
});

E-commerce Events (ECOMMERCE)

Core events that track online shopping and the purchase process.

Supported events: 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 & Trial Events (SUBSCRIPTION)

Core events related to subscriptions and free trials.

Supported events: 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',
});

In-App Ad Events (AD)

Events for measuring the performance of ads displayed inside the app.

Supported events: 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 & Achievement Events (PROGRESSION)

Events that track a user's learning, game, or work progress and achievements.

Supported events: 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 Events (ENGAGEMENT)

Events that track interactions between users and content.

Supported events: 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 Events (FINANCE)

Events specialized for financial services such as securities, cards, and accounts.

Supported events: 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 Events (GAMING)

Events specialized for gaming services.

Supported events: 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',
});

Custom Events

Business-specific events that cannot be covered by standard events can be freely sent under any name. Event names use Firebase Analytics-style strings as-is, and names not in the standard events list are also collected as-is.

// 비즈니스 고유 커스텀 이벤트 (임의 이름)
AdStage.events.track('newsletter_subscribe', {
  source: 'footer_form',
  campaign: 'summer_news',
});
 
// 리드 생성 등 표준에 없는 마케팅 이벤트도 커스텀으로 전송
AdStage.events.track('generate_lead', {
  currency: 'KRW',
  value: 0, // 잠재 고객 가치
  content_id: 'newsletter_signup',
});

If you have been using names that are not in the standard taxonomy (e.g., view_item, view_item_list, view_search_results, level_start, unlock_achievement, spend_virtual_currency, etc.), we recommend mapping them to the standard event names above whenever possible. For example: 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. Names that are hard to map can still be sent as custom events as-is.