Appearance

Episode Player ​

이 섹션에는 18개의 이벤트가 포함되어 있습니다.

click_play_start ​

에피소드 플레이 시작 클릭

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
entry_sourceundefined
'home_recommend'
'home_ranking'
'home_new'
'episode_player'
'episode_search_recommend'
'episode_detail'
'my_play'
'push_notification'
'home_banner'
'share_link'
'home_recommend_popup'
'onboarding_recommendations'
'home_comment_card'
'first_episode_recommend'		YES플레이 시작 진입 경로
play_type'new'
'resume'		YES신규 플레이 또는 이어하기
play_idstringYES플레이 세션 ID

generate_scene ​

씬 생성 시작

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
action_type'custom'
'choice'
'skip'		YES씬 생성 액션 타입
is_regenfalse
true		YES재생성 여부
scene_turn_countnumberYES현재 씬의 턴 수
scene_frame_countnumberYES현재 씬의 프레임 수
play_idstringYES플레이 세션 ID
default_play_mode'scroll_view'
'page_view'		YES기본 플레이 모드 설정값
play_mode'scroll_view'
'page_view'		YES현재 플레이 모드
play_model'gemini-2.5-pro'
'gemini-3.5-flash'
'gemini-3.1-pro'
'gemini-3.1-flash-lite'
'test-gemini-3.5-flash'
'test-gpt-5.4'
'test-gpt-5.4-mini'
'test-gpt-5.4-nano'		YES현재 플레이 모델
default_model'gemini-2.5-pro'
'gemini-3.5-flash'
'gemini-3.1-pro'
'gemini-3.1-flash-lite'
'test-gemini-3.5-flash'
'test-gpt-5.4'
'test-gpt-5.4-mini'
'test-gpt-5.4-nano'		YES기본 모델 설정값

generate_scene_failed ​

씬 생성 실패

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
action_type'custom'
'choice'
'skip'		YES씬 생성 액션 타입
is_regenfalse
true		YES재생성 여부
scene_turn_countnumberYES현재 씬의 턴 수
scene_frame_countnumberYES현재 씬의 프레임 수
error_codestringYES에러 코드
error_messagestringYES에러 메시지
play_idstringYES플레이 세션 ID
default_play_mode'scroll_view'
'page_view'		YES기본 플레이 모드 설정값
play_mode'scroll_view'
'page_view'		YES현재 플레이 모드
play_model'gemini-2.5-pro'
'gemini-3.5-flash'
'gemini-3.1-pro'
'gemini-3.1-flash-lite'
'test-gemini-3.5-flash'
'test-gpt-5.4'
'test-gpt-5.4-mini'
'test-gpt-5.4-nano'		YES현재 플레이 모델
default_model'gemini-2.5-pro'
'gemini-3.5-flash'
'gemini-3.1-pro'
'gemini-3.1-flash-lite'
'test-gemini-3.5-flash'
'test-gpt-5.4'
'test-gpt-5.4-mini'
'test-gpt-5.4-nano'		YES기본 모델 설정값

generate_scene_complete ​

씬 생성 완료

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
action_type'custom'
'choice'
'skip'		YES씬 생성 액션 타입
is_regenfalse
true		YES재생성 여부
play_idstringYES플레이 세션 ID
default_play_mode'scroll_view'
'page_view'		YES기본 플레이 모드 설정값
play_mode'scroll_view'
'page_view'		YES현재 플레이 모드
play_model'gemini-2.5-pro'
'gemini-3.5-flash'
'gemini-3.1-pro'
'gemini-3.1-flash-lite'
'test-gemini-3.5-flash'
'test-gpt-5.4'
'test-gpt-5.4-mini'
'test-gpt-5.4-nano'		YES현재 플레이 모델
default_model'gemini-2.5-pro'
'gemini-3.5-flash'
'gemini-3.1-pro'
'gemini-3.1-flash-lite'
'test-gemini-3.5-flash'
'test-gpt-5.4'
'test-gpt-5.4-mini'
'test-gpt-5.4-nano'		YES기본 모델 설정값
scene_turn_countnumberYES현재 씬의 턴 수
scene_frame_countnumberYES현재 씬의 프레임 수

click_play_control ​

플레이어 컨트롤 상호작용 요약

플레이 세션 중 누적된 플레이어 조작 카운터를 포함합니다.

Includes

이 이벤트는 EpisodeEventInfo, EpisodePlayControlEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
play_idstringYES플레이 세션 ID

click_play_menu ​

플레이어 메뉴 클릭

PlatformStatusVersion
App✅v1.1.0
Web✅v1.1.0

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
play_idstringYES플레이 세션 ID

click_play_settings ​

플레이어 설정 변경

PlatformStatusVersion
App✅v1.1.0
Web✅v1.1.0

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
setting_type'bgm'
'sfx'
'text-streaming'
'bgm_loop'
'font_size'
'font_style'
'play_mode'		YES변경된 설정 항목
statusstringYES변경 후 상태 (토글형: on/off, 선택형: 선택된 값)
play_mode'scroll_view'
'page_view'		YES현재 플레이 모드
font_stylenull
string		NO현재 글꼴 — 웹은 null
font_sizenull
string		NO현재 글자 크기 — 웹은 null
play_idstringYES플레이 세션 ID

click_play_regen_modal ​

재생성 모달 클릭 (열기)

PlatformStatusVersion
App✅v1.1.0
Web✅v1.1.0

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
play_idstringYES플레이 세션 ID

view_play_regen_sheet ​

재생성 시트 노출 (App only)

PlatformStatusVersion
App✅v1.1.0
Web❌-

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
play_idstringYES플레이 세션 ID

click_play_regen_sheet_confirm ​

재생성 시트 확인 클릭 (App only)

PlatformStatusVersion
App✅v1.1.0
Web❌-

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
play_idstringYES플레이 세션 ID

view_play_character_list ​

캐릭터 목록 화면 진입

PlatformStatusVersion
App✅v1.1.0
Web✅v1.1.0

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
play_idstringYES플레이 세션 ID
entry_sourcenull
'top_menu'
'page_view_center_tap'
'scroll_view_media_tap'		YES여는 방법

view_play_ending ​

엔딩 화면 노출

PlatformStatusVersion
App✅v1.1.0
Web✅v1.1.0

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
ending_typestringYES엔딩 타입
play_idstringYES플레이 세션 ID

click_play_ending_action ​

엔딩 화면 액션 클릭

PlatformStatusVersion
App✅v1.1.0
Web✅v1.1.0

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
action_type'replay'
'continue'		YES엔딩 후 액션 타입
play_idstringYES플레이 세션 ID

click_play_shop ​

플레이어 내 상점 진입 클릭

PlatformStatusVersion
App✅v1.1.0
Web✅v1.1.0

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
action_type'menu_shop'
'lack_modal'
'lack_modal_free_star'		YES상점 진입 트리거
play_idstringYES플레이 세션 ID

view_event_map ​

이벤트맵 화면 진입 (플레이 이벤트맵 / 에피소드 상세 이벤트맵 공통)

PlatformStatusVersion
App✅v1.1.0
Web✅v1.1.0

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
entry_source'episode_player'
'episode_detail'
'play_menu'
'deeplink'		YES이벤트맵 진입 경로 (deeplink = 진입 파라미터 없는 외부 딥링크)
play_idnull
string		YES플레이 세션 ID — 플레이 이벤트맵 진입일 때만, 에피소드 상세 진입은 null
seen_event_countnull
number		YES본(경험한) 이벤트 수 — 플레이 진입은 이번 플레이에서 지나온 수, 에피소드 상세 진입은 계정 누적 해금 수. 카운트 조회 실패 시 null
total_event_countnull
number		YES전체 이벤트 수 — 카운트 조회 실패 시 null

click_event_map_point ​

플레이 이벤트맵에서 포인트(노드) 탭 (에피소드 상세 이벤트맵은 클릭 불가라 미발화)

PlatformStatusVersion
App✅v1.1.0
Web✅v1.1.0

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
play_idstringYES플레이 세션 ID
event_point_idstringYES이벤트맵 포인트 식별자 (eventMetaId — 스냅샷 무관 안정 키)
event_point_type'prologue'
'main_event'
'main_ending'
'sub_event'
'sub_ending'		YES포인트 타입
event_point_state'active'
'known'
'inactive'		YES포인트 상태 (active = 이번 플레이에서 경험 — 프롤로그 포함, known = 다른 플레이에서 해금했지만 이번 플레이 미경험, inactive = 미해금)

view_event_map_point_modal ​

플레이 이벤트맵 포인트 상세 카드 모달 노출 (카드 오픈당 1회, 단건 조회 완료 시점)

PlatformStatusVersion
App✅v1.1.0
Web✅v1.1.0

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
play_idstringYES플레이 세션 ID
event_point_idstringYES이벤트맵 포인트 식별자 (eventMetaId)
event_point_type'prologue'
'main_event'
'main_ending'
'sub_event'
'sub_ending'		YES포인트 타입
event_point_state'active'
'known'
'inactive'		YES포인트 상태 (active = 이번 플레이에서 경험 — 프롤로그 포함, known = 다른 플레이에서 해금했지만 이번 플레이 미경험, inactive = 미해금)
trigger_preview_state'locked'
'unlocked'		YES발견 조건(트리거) 공개 상태 — unlocked = condition 노출(계정 누적 경험 또는 구매 완료)

click_event_trigger_preview_purchase ​

발견 조건 잠금 해제(트리거 정보 구매) 시도 결과 — 구매 응답 확정 시점에 발화. 성공/스타 부족 외 실패와 최초 1회 안내 시트에서 취소한 경우는 발화하지 않아요.

PlatformStatusVersion
App✅v1.1.0
Web✅v1.1.0

Includes

이 이벤트는 EpisodeEventInfo 의 모든 속성을 포함합니다.

PropertyTypeRequiredDescription
play_idstringYES플레이 세션 ID
event_point_idstringYES이벤트맵 포인트 식별자 (eventMetaId)
event_point_type'prologue'
'main_event'
'main_ending'
'sub_event'
'sub_ending'		YES포인트 타입
price_starnumberYES표기 가격(스타) — 서버 조회값(GET /v1/episodes/event-info-purchase-costs), 조회 실패 시 300 fallback
purchase_result'success'
'insufficient_star'		YES구매 결과 (스타 부족 = 서버 errorCode CREDIT_NOT_ENOUGH)

Frontia Analytics Event Specification

© Deepgrov Inc.