StageUp
웹 SDK이벤트

표준 이벤트 가이드

AdStage 표준 이벤트 가이드

목차

  1. 개요
  2. 표준 이벤트 목록
  3. 이벤트 카테고리별 가이드

개요

이 문서는 중복 설명 없이 표준 이벤트 목록과 카테고리별 예제만 간결하게 제공합니다.

모든 예제는 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_itemproduct_details_view, view_item_listproduct_list_view, view_search_resultssearch_result_view, unlock_achievementachievement, spend_virtual_currencyspend_credits. 매핑이 어려운 이름은 그대로 커스텀 이벤트로 보내도 됩니다.

목차