표준 이벤트 가이드

AdStage 표준 이벤트 가이드

개요

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

표준 이벤트 목록

카테고리	이벤트명	설명
사용자 이벤트	`sign_up`	회원가입
	`login`	로그인
	`logout`	로그아웃
	`join_group`	그룹 참여
	`generate_lead`	리드 생성
페이지/화면 이벤트	`page_view`	페이지 조회
	`screen_view`	화면 조회
	`view_item_list`	상품 목록 조회
	`view_search_results`	검색 결과 조회
인터랙션 이벤트	`search`	검색
	`select_content`	콘텐츠 선택/클릭
	`share`	공유
	`click`	일반 클릭
	`scroll`	스크롤
	`file_download`	파일 다운로드
전자상거래 이벤트	`view_item`	상품 조회
	`add_to_cart`	장바구니 추가
	`remove_from_cart`	장바구니 제거
	`view_cart`	장바구니 조회
	`begin_checkout`	결제 시작
	`add_payment_info`	결제 정보 추가
	`add_shipping_info`	배송 정보 추가
	`purchase`	구매 완료
	`refund`	환불
진행률 이벤트	`level_start`	레벨 시작
	`level_end`	레벨 완료
	`level_up`	레벨업
	`tutorial_begin`	튜토리얼 시작
	`tutorial_complete`	튜토리얼 완료
	`post_score`	점수 기록
	`unlock_achievement`	업적 달성
광고 이벤트	`ad_impression`	광고 노출
	`ad_click`	광고 클릭
	`ad_view`	광고 시청
	`ad_dismiss`	광고 닫기/건너뛰기
비즈니스 이벤트	`subscribe`	구독 시작
	`unsubscribe`	구독 취소
	`start_trial`	무료 체험 시작
	`spend_virtual_currency`	가상 화폐 사용
	`earn_virtual_currency`	가상 화폐 획득
	`app_open`	앱 열기

이벤트 카테고리별 가이드

사용자 이벤트 (USER_EVENTS)

사용자 인증 및 계정 관리와 관련된 이벤트입니다.

지원 이벤트: sign_up, login, logout, join_group, generate_lead

// 회원가입
AdStage.event('sign_up', {
  method: 'email', // 가입 방법: email, google, facebook 등
});
 
// 로그인
AdStage.event('login', {
  method: 'google', // 로그인 방법
});
 
// 로그아웃
AdStage.event('logout');
 
// 그룹 참여 (커뮤니티, 팀 등)
AdStage.event('join_group', {
  group_id: 'tech_community',
  group_name: '기술 커뮤니티',
});
 
// 리드 생성 (마케팅 관심 표시)
AdStage.event('generate_lead', {
  currency: 'KRW',
  value: 0, // 잠재 고객 가치
  content_id: 'newsletter_signup',
});

페이지 및 화면 이벤트 (VIEW_EVENTS)

사용자의 페이지 조회 및 화면 전환을 추적하는 이벤트입니다.

지원 이벤트: page_view, screen_view, view_item_list, view_search_results

// 페이지 조회
AdStage.event('page_view', {
  page_title: '상품 목록',
  page_location: window.location.href,
  content_group1: 'product_category',
});
 
// 화면 조회 (SPA 앱)
AdStage.event('screen_view', {
  screen_name: 'product_list',
  screen_class: 'ProductListPage',
});
 
// 상품 목록 조회
AdStage.event('view_item_list', {
  item_list_id: 'bestsellers',
  item_list_name: '베스트셀러 상품',
  items: [
    /* 상품 배열 */
  ],
});
 
// 검색 결과 조회
AdStage.event('view_search_results', {
  search_term: '스마트폰',
  number_of_results: 24,
});

인터랙션 이벤트 (INTERACTION_EVENTS)

사용자와 콘텐츠 간의 상호작용을 추적하는 이벤트입니다.

지원 이벤트: search, select_content, share, click, scroll, file_download

// 검색
AdStage.event('search', {
  search_term: '스마트폰',
  content_group1: 'electronics',
});
 
// 콘텐츠 선택/클릭
AdStage.event('select_content', {
  content_type: 'product',
  content_id: 'PROD_123',
});
 
// 공유
AdStage.event('share', {
  content_type: 'product',
  content_id: 'PROD_123',
  method: 'facebook',
});
 
// 일반 클릭 (CTR 추적)
AdStage.event('click', {
  link_url: 'https://example.com/special-offer',
  link_text: '특가 상품 보기',
});
 
// 스크롤 깊이
AdStage.event('scroll', {
  percent_scrolled: 75,
});
 
// 파일 다운로드
AdStage.event('file_download', {
  file_name: 'product_catalog.pdf',
  file_extension: 'pdf',
});

전자상거래 이벤트 (ECOMMERCE_EVENTS)

온라인 쇼핑 및 구매 프로세스를 추적하는 핵심 이벤트입니다.

지원 이벤트: view_item, add_to_cart, remove_from_cart, view_cart, begin_checkout, add_payment_info, add_shipping_info, purchase, refund

// 상품 조회
AdStage.event('view_item', {
  currency: 'KRW',
  value: 29000,
  items: [
    {
      item_id: 'PROD_123',
      item_name: '스마트 워치',
      item_category: 'Electronics',
      item_brand: 'Samsung',
      price: 29000,
      quantity: 1,
    },
  ],
});
 
// 장바구니 추가
AdStage.event('add_to_cart', {
  currency: 'KRW',
  value: 29000,
  items: [
    {
      item_id: 'PROD_123',
      item_name: '스마트 워치',
      quantity: 1,
      price: 29000,
    },
  ],
});
 
// 장바구니에서 제거
AdStage.event('remove_from_cart', {
  currency: 'KRW',
  value: 29000,
  items: [
    {
      item_id: 'PROD_123',
      quantity: 1,
    },
  ],
});
 
// 장바구니 조회
AdStage.event('view_cart', {
  currency: 'KRW',
  value: 58000,
  items: [
    /* 장바구니 상품 목록 */
  ],
});
 
// 결제 시작
AdStage.event('begin_checkout', {
  currency: 'KRW',
  value: 58000,
  coupon: 'SUMMER10',
  items: [
    /* 결제 상품 목록 */
  ],
});
 
// 결제 정보 추가
AdStage.event('add_payment_info', {
  currency: 'KRW',
  value: 58000,
  payment_type: 'credit_card',
});
 
// 배송 정보 추가
AdStage.event('add_shipping_info', {
  currency: 'KRW',
  value: 58000,
  shipping_tier: 'express',
});
 
// 구매 완료
AdStage.event('purchase', {
  transaction_id: 'T_12345',
  currency: 'KRW',
  value: 58000,
  coupon: 'SUMMER10',
  shipping: 3000,
  tax: 5800,
  items: [
    /* 구매 상품 목록 */
  ],
});
 
// 환불
AdStage.event('refund', {
  transaction_id: 'T_12345',
  currency: 'KRW',
  value: 29000,
  items: [
    /* 환불 상품 목록 */
  ],
});

진행률 이벤트 (PROGRESS_EVENTS)

사용자의 학습, 게임, 또는 업무 진행 상황을 추적하는 이벤트입니다.

지원 이벤트: level_start, level_end, level_up, tutorial_begin, tutorial_complete, post_score, unlock_achievement

// 레벨 시작
AdStage.event('level_start', {
  level_name: 'Tutorial',
  character: 'warrior',
});
 
// 레벨 완료
AdStage.event('level_end', {
  level_name: 'Tutorial',
  success: true,
  character: 'warrior',
});
 
// 레벨업
AdStage.event('level_up', {
  level: 5,
  character: 'warrior',
});
 
// 튜토리얼 시작
AdStage.event('tutorial_begin');
 
// 튜토리얼 완료
AdStage.event('tutorial_complete', {
  tutorial_id: 'basic_tutorial',
  completion_time: 300, // 초
});
 
// 점수 기록
AdStage.event('post_score', {
  score: 15420,
  level: 5,
  character: 'warrior',
});
 
// 업적 달성
AdStage.event('unlock_achievement', {
  achievement_id: 'first_win',
  achievement_name: '첫 승리',
});

광고 이벤트 (AD_EVENTS)

광고 캠페인의 성과 측정을 위한 이벤트입니다.

지원 이벤트: ad_impression, ad_click, ad_view, ad_dismiss

// 광고 노출
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,
});
 
// 광고 클릭
AdStage.event('ad_click', {
  ad_platform: 'facebook_ads',
  ad_source: 'facebook',
  ad_medium: 'social',
  ad_campaign: 'brand_awareness',
});
 
// 광고 시청 (동영상 광고)
AdStage.event('ad_view', {
  ad_platform: 'youtube_ads',
  ad_format: 'video',
  ad_duration: 30,
  view_duration: 15,
});
 
// 광고 닫기/건너뛰기
AdStage.event('ad_dismiss', {
  ad_platform: 'display_network',
  dismiss_reason: 'skip',
});

비즈니스 이벤트 (BUSINESS_EVENTS)

구독, 결제, 비즈니스 모델과 관련된 핵심 이벤트입니다.

지원 이벤트: subscribe, unsubscribe, start_trial, spend_virtual_currency, earn_virtual_currency, app_open

// 구독 시작
AdStage.event('subscribe', {
  subscription_id: 'SUB_123',
  plan_name: 'premium_monthly',
  value: 9.99,
  currency: 'USD',
});
 
// 구독 취소
AdStage.event('unsubscribe', {
  subscription_id: 'SUB_123',
  plan_name: 'premium_monthly',
  cancellation_reason: 'price',
});
 
// 무료 체험 시작
AdStage.event('start_trial', {
  trial_days: 7,
  plan_name: 'premium_trial',
});
 
// 가상 화폐 사용
AdStage.event('spend_virtual_currency', {
  virtual_currency_name: 'coins',
  value: 100,
  item_name: 'power_up',
});
 
// 가상 화폐 획득
AdStage.event('earn_virtual_currency', {
  virtual_currency_name: 'coins',
  value: 50,
  source: 'daily_bonus',
});
 
// 앱 열기 (세션 시작)
AdStage.event('app_open', {
  source: 'notification',
  campaign: 'push_campaign_01',
});