표준 이벤트 가이드
개요
표준 이벤트 목록
이벤트 카테고리별 가이드
이 문서는 중복 설명 없이 표준 이벤트 목록과 카테고리별 예제만 간결하게 제공합니다.
모든 예제는 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임의의 커스텀 이벤트
광고 성과 측정과 어트리뷰션의 핵심이 되는 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' ,
});
사용자 인증 및 계정 관리, 앱 실행과 관련된 이벤트입니다.
지원 이벤트 : 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' ,
});
사용자의 페이지 조회 및 화면 전환, 콘텐츠 탐색을 추적하는 이벤트입니다.
지원 이벤트 : 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 ,
},
],
});
온라인 쇼핑 및 구매 프로세스를 추적하는 핵심 이벤트입니다.
지원 이벤트 : 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: [
/* 환불 상품 목록 */
],
});
구독 및 무료 체험과 관련된 핵심 이벤트입니다.
지원 이벤트 : 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_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' ,
});
사용자의 학습, 게임, 또는 업무 진행 상황과 성취를 추적하는 이벤트입니다.
지원 이벤트 : 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: '첫 승리' ,
});
사용자와 콘텐츠 간의 상호작용을 추적하는 이벤트입니다.
지원 이벤트 : 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' ,
});
증권, 카드, 계좌 등 금융 서비스에 특화된 이벤트입니다.
지원 이벤트 : 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' ,
});
게임 서비스에 특화된 이벤트입니다.
지원 이벤트 : 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_item → product_details_view,
view_item_list → product_list_view, view_search_results → search_result_view,
unlock_achievement → achievement, spend_virtual_currency → spend_credits.
매핑이 어려운 이름은 그대로 커스텀 이벤트로 보내도 됩니다.