VocaStory 故事魔法

每一步還剩多少人，看在哪一步流失最多。

安裝後有多少人完成註冊。

看到付費牆的人有多少付款；用細分維度看是哪個付費牆。

細分維度：paywall_id

purchase 要等 RevenueCat → Firebase 串接開好（或 app 自己送）才會有。

各功能用了多少：報表 → 參與 → 事件，點 cfd_feature_enter，依 feature_id 拆分。這個不適合做成漏斗：漏斗的細分看第一步，而 first_open 沒有 feature_id。

步驟：voice_clone_intro → story_creation_intro → immersive_intro

All scene images finished rendering for a newly created story. Carries no feature_id: the client no longer holds the creation mode by then (neither the draft nor the progress entity carries it), and a guessed one would credit one mode's render cost to another. The same session's voca_story_create_submit has it.

參數 scene_count：integer, number of scenes rendered

參數 render_ms：integer, wall-clock time of the whole render (server-side generation, deliberately NOT duration_ms - that one means active play time in the shared table)

A recording sample is submitted for cloning (not on entering the page, which is opened and abandoned constantly). No voice_role and never the voice's name: the name is user-typed and routinely a real family member's, and the role is not exposed on the client since voices became named.

參數 language：zh_TW | zh_CN | en_US | ja_JP | ko_KR

The cloned voice becomes usable for narration, or the upload failed. A voice still processing is NOT a completion - counting it would put the success rate at 100% by definition.

參數 language：zh_TW | zh_CN | en_US | ja_JP | ko_KR

參數 outcome（與共用表同義）：completed | failed

The generation request is accepted by the server - the real moment a creation attempt begins, distinct from entering the creation mode

參數 feature_id（與共用表同義）

參數 child_id_present：true | false - whether a child profile was attached

A child profile is created and confirmed by the server. Activation signal - personalisation is impossible before this.

參數 ordinal：integer, 1 for the first child profile on this account

The first chapter of a branching adventure is playable

參數 play_id：random id shared with the matching voca_adventure_end; BigQuery only, never register

參數 setting：the chosen adventure setting id; omitted when none was chosen

An ending chapter is reached, for a run whose voca_adventure_start was reported. Leaving mid-run is NOT reported - a crash sends nothing either, so a start with no end is unknown drop-off (same rule as story playback).

參數 play_id

參數 outcome（與共用表同義）：completed (the only value emitted today)

參數 depth：integer, how many chapters deep the run got

A parental PIN is created and stored for the first time. Signals that the adult actually finished setting the guard up, not just opened it.

參數 entry_point（與共用表同義）：menu (from the parental-control menu) | other (sent by a gate that needed a PIN first - social features, purchases, the parental gate, enabling social settings)

A PIN entry attempt resolves. Fires on every attempt, so a high failed rate means adults are locked out of their own settings.

參數 outcome（與共用表同義）：completed | failed | quit

參數 gate_context：parental_control | social_feature

The server confirms a story is published to the community. Never on tapping publish - the social gate or the server can still refuse. No allow_remix: publishing does not set it (remix is a separate endpoint the author toggles afterwards), so at this moment the value is a server default the client never sees.

參數 item_id（與共用表同義）

A publication is liked (not on unlike)

參數 item_id（與共用表同義）

A comment is accepted by the server (passes the content filter)

參數 item_id（與共用表同義）

A creator is followed (not on unfollow)

The three adaptation dimensions are confirmed and the generation is submitted. Shows which retellings children actually want.

參數 source_tale：skeleton slug of the classic being retold, e.g. cinderella

參數 protagonist：original | robot | astronaut | dinosaur | wizard | animal | detective

參數 setting：original | space | undersea | future_city | dinosaur_age | magic_school | snow

參數 ending：original | befriend | self_reliant | happy_all | twist | open

The store purchase flow is launched for a product - the last moment the app controls. What happens next (cancel, decline, success) is the store's, and only a success comes back as RevenueCat's purchase event.

參數 product_id：store product id, e.g. com.gcdm.vocastory.credits.pack1

參數 product_kind：subscription | credit_pack

參數 placement（與共用表同義）：onboarding | feature_gate | game_gate | settings | promo | other

A story is added to favourites (not on removal)

參數 item_id（與共用表同義）

參數 source：own | library | published

Audio actually starts for a story (not on tap, not on page open - a feed card autoplays when it scrolls into view, so opening is not a play). Reported from all four players: the story player, both feed cards (original and classic) and the library fallback player.

參數 item_id（與共用表同義）：the story id; for a library story always the LIBRARY id (the player's per-user shadow row id would split one tale into many items)

參數 source：own | library | published

參數 play_id：random id shared with the matching voca_story_play_complete; BigQuery only, never register as a dimension (high cardinality)

North Star (WSPC). The story reached its end AND more than half of it was actually heard. "Heard" counts forward progress only - dragging the scrubber to the end, or a chapter change, adds nothing. The end is a stop at the end of the last chapter (story player, fallback player) or a wrap back to the start (feed cards, which loop). A start with no complete is unknown drop-off; nothing reports a quit.

參數 item_id（與共用表同義）

參數 source：own | library | published

參數 play_id：matches the voca_story_play_start of this playback

參數 duration_ms（與共用表同義）：integer, active listening time (same meaning as the shared table's duration_ms)

The backend accepted a change of narrating voice on a story (from cache or by starting a render). official | family only - the client cannot tell a mother's voice from a father's, and guessing from the typed voice name would be both a guess and personal data.

參數 item_id（與共用表同義）

參數 voice_role：official | family