StageUp
웹 SDK이벤트

커스텀 이벤트

비즈니스에 맞는 고유한 이벤트를 만들어서 더 구체적인 사용자 행동을 분석할 수 있습니다.

🎯 커스텀 이벤트 만들기

어떤 이벤트를 만들면 좋을까?

비즈니스에서 중요하게 생각하는 사용자 행동이 있다면, 그걸 이벤트로 만들어보세요:

// 요리 레시피 사이트라면
AdStage.events.track('recipe_bookmarked', {
  recipe_id: 'chicken_curry_123',
  recipe_name: '치킨 카레',
  difficulty: 'medium',
  cooking_time: 30
});
 
// 온라인 쇼핑몰이라면  
AdStage.events.track('wishlist_added', {
  product_id: 'PROD_456',
  product_name: '무선 이어폰',
  price: 89000,
  category: '전자제품'
});

이벤트 이름은 어떻게 짓나요?

특별한 규칙은 없지만, 나중에 찾기 쉽게 의미가 명확한 이름을 사용하는 게 좋습니다:

// 이런 식으로 하면 나중에 분석할 때 구분하기 편해요
AdStage.events.track('video_play_started', { video_id: '123' });
AdStage.events.track('video_play_completed', { video_id: '123' });
 
// 비슷한 기능들은 비슷한 패턴으로 이름을 지으면 좋아요
AdStage.events.track('course_lesson_started', { course_id: 'js101', lesson_id: 'variables' });
AdStage.events.track('course_lesson_completed', { course_id: 'js101', lesson_id: 'variables' });

🏢 업종별 사용 예시

온라인 쇼핑몰이라면

이런 이벤트들을 추적해보면 고객의 쇼핑 패턴을 더 잘 이해할 수 있어요:

// 상품을 빠르게 미리보기 했을 때
AdStage.events.track('product_quick_preview', {
  product_id: 'PROD_123',
  product_name: '무선 이어폰',
  price: 89000,
  from_section: '추천 상품'
});
 
// 찜 목록에 추가했을 때
AdStage.events.track('added_to_wishlist', {
  product_id: 'PROD_123',
  current_wishlist_count: 5,
  product_price: 89000
});
 
// 재입고 알림을 신청했을 때 - 이거 추적하면 인기 상품 파악에 도움돼요
AdStage.events.track('restock_alert_requested', {
  product_id: 'PROD_456',
  product_name: '품절된 상품',
  user_email_domain: 'gmail.com' // 개인정보는 이런 식으로 일반화
});
 
// 리뷰를 작성했을 때
AdStage.events.track('review_written', {
  product_id: 'PROD_123',
  rating: 5,
  review_has_photo: true
});

온라인 강의 플랫폼이라면

학습자의 학습 패턴을 분석하려면 이런 이벤트들이 유용해요:

// 강의를 얼마나 봤는지 추적 - 이거로 어려운 구간을 찾을 수 있어요
AdStage.events.track('lesson_watched', {
  course_name: '자바스크립트 기초',
  lesson_title: '변수와 데이터 타입',
  watch_percentage: 75,
  watch_time_minutes: 8,
  rewound_count: 2 // 되감기 횟수 - 어려운 부분 파악 가능
});
 
// 퀴즈 결과 - 학습 효과 측정에 좋아요
AdStage.events.track('quiz_finished', {
  quiz_name: 'JS 기초 퀴즈',
  score: 85,
  total_score: 100,
  attempt_number: 1, // 몇 번째 시도인지
  passed: true
});
 
// 수료증 받았을 때 - 완주율 분석용
AdStage.events.track('course_completed', {
  course_name: '자바스크립트 기초',
  completion_days: 14, // 완주에 걸린 일수
  final_score: 92
});

게임이라면

플레이어의 게임 패턴과 재미 요소를 분석하는데 이런 이벤트들이 도움돼요:

// 게임을 시작했을 때
AdStage.events.track('game_started', {
  game_mode: '서바이벌 모드',
  difficulty: '어려움',
  character_level: 15,
  playtime_today_minutes: 45 // 오늘 플레이 시간
});
 
// 레벨업 했을 때 - 게임 밸런스 조정에 유용
AdStage.events.track('level_up', {
  new_level: 15,
  time_to_levelup_minutes: 45, // 레벨업에 걸린 시간
  main_activity: 'monster_hunting' // 주로 뭘 하면서 레벨업 했는지
});
 
// 아이템을 얻었을 때
AdStage.events.track('item_obtained', {
  item_name: '전설의 검',
  item_grade: 'legendary',
  how_obtained: '보스 드롭', // 어떻게 얻었는지
  player_level: 15
});
 
// 유료 아이템 구매 - 수익 분석용
AdStage.events.track('item_purchased', {
  item_type: '게임 머니',
  amount: 1000,
  real_price: 9900, // 원화
  reason: '게임머니 부족' // 구매 이유
});

블로그나 미디어 사이트라면

어떤 콘텐츠가 인기 있는지, 독자들이 어떻게 읽는지 알려면 이런 이벤트가 좋아요:

// 글을 다 읽었을 때 - 어떤 글이 끝까지 읽히는지 알 수 있어요
AdStage.events.track('article_finished_reading', {
  article_title: '2024 기술 트렌드',
  category: '기술',
  read_time_minutes: 4,
  scroll_percentage: 100,
  word_count: 1200
});
 
// 댓글을 달았을 때 - 참여도 측정
AdStage.events.track('comment_added', {
  article_title: '재미있는 기사',
  comment_length: 85,
  is_reply: false, // 댓글인지 대댓글인지
  user_type: 'regular_reader' // 단골 독자인지
});
 
// 뉴스레터 구독 - 충성도 높은 독자 확보
AdStage.events.track('newsletter_signed_up', {
  newsletter_type: '주간 요약',
  signup_location: '글 하단 CTA',
  reader_visits_this_month: 5 // 이번 달 방문 횟수
});
 
// 글 공유 - 바이럴 효과 측정
AdStage.events.track('article_shared', {
  article_title: '인기 기사',
  share_platform: 'twitter',
  share_location: '글 상단' // 어디서 공유 버튼을 눌렀는지
});

💡 실제로 사용해보기

커스텀 이벤트를 만들 때는 "나중에 이 데이터로 뭘 알고 싶은지" 먼저 생각해보세요:

// 예를 들어, 사용자가 언제 이탈하는지 알고 싶다면
AdStage.events.track('page_exit_attempt', {
  page_name: '상품 상세 페이지',
  time_on_page_seconds: 30,
  scroll_depth: 25,
  exit_trigger: 'back_button' // 뒤로가기, 탭 닫기 등
});
 
// 어떤 기능이 인기 있는지 알고 싶다면
AdStage.events.track('feature_used', {
  feature_name: '가격 비교',
  user_type: 'premium',
  usage_count_today: 3
});

이런 식으로 비즈니스에 맞는 이벤트를 만들면, AdStage 대시보드에서 세그먼트퍼널로 더 정확한 사용자 분석을 할 수 있어요.

목차