웹 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 대시보드에서 세그먼트와 퍼널로 더 정확한 사용자 분석을 할 수 있어요.

