adstage
Web SDKเหตุการณ์

คู่มืออีเวนต์มาตรฐาน

คู่มืออีเวนต์มาตรฐานของ AdStage

สารบัญ

  1. ภาพรวม
  2. รายการอีเวนต์มาตรฐาน
  3. คู่มือแยกตามหมวดหมู่อีเวนต์

ภาพรวม

เอกสารนี้ให้เฉพาะรายการอีเวนต์มาตรฐานและตัวอย่างแยกตามหมวดหมู่อย่างกระชับ โดยไม่มีคำอธิบายซ้ำซ้อน

ทุกตัวอย่างจะส่งอีเวนต์ในรูปแบบ AdStage.events.track(eventName, properties) ชื่ออีเวนต์รองรับสตริงใด ๆ ก็ได้ ดังนั้นชื่อที่ไม่มีอยู่ในอีเวนต์มาตรฐานด้านล่างก็สามารถส่งเป็นอีเวนต์แบบกำหนดเองได้อย่างอิสระ อย่างไรก็ตาม เพื่อให้ได้การรวมข้อมูลที่สอดคล้องกันในการวิเคราะห์ attribution และ conversion เราขอแนะนำให้ใช้ชื่ออีเวนต์มาตรฐานด้านล่างให้มากที่สุดเท่าที่จะทำได้


รายการอีเวนต์มาตรฐาน

หมวดหมู่ชื่ออีเวนต์คำอธิบาย
การติดตามโฆษณา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 ที่เป็นหัวใจสำคัญของการวัดประสิทธิภาพโฆษณาและการทำ attribution

อีเวนต์ที่รองรับ: 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_item → product_details_view, view_item_list → product_list_view, view_search_results → search_result_view, unlock_achievement → achievement, spend_virtual_currency → spend_credits ชื่อที่แมปได้ยากก็ยังสามารถส่งเป็นอีเวนต์แบบกำหนดเองตามเดิมได้

สารบัญ