Live snapshot · Latest To Release

Events / gameplay events

foreground_change

ready

Spec

Doc fields save here and survive re-import. Name, status, parameters, and pipeline flags change through a ticket.

Add visual aid to description

png, jpeg, webp, or gif. 5 MB max. Alt text is required. This is not a QA screenshot.

Status is ready, introduced after 1.9.39. Firebase on, Adjust off (adj_foreground_change).

Open change ticket

Sheet statuses: draft, ready, implemented, verified, deprecated.

Edits

Nickname recorded with each doc save or comment. It is not a verified identity.

No edits recorded yet.

    Sheet notes

    • current_foreground_id · ID of popup or screen whatever is in focus / foreground after this screen change
    • batch_close · array of ids
    • prev_foreground_duration · seconds spent in previous foreground till this change
    • prev_screen_duration · seconds spent in previous screen till screen change

    Parameters

    7 on this event

    ParameterTypeExamplesDescriptionFlags

    current_foreground_id

    Top values

    		unknown——FirebaseNo Adjust

    current_screen_id

    Top values

    		unknown——FirebaseNo Adjust

    batch_close

    Top values

    		unknown——FirebaseNo Adjust

    prev_foreground_duration

    Top values

    		unknown——FirebaseNo Adjust

    prev_screen_duration

    Top values

    		stringon screen change - report duration of the previous screen. Send nothing for value to be recorded as Null—FirebaseNo Adjust

    prev_foreground_id

    Top values

    		unknown——FirebaseNo Adjust

    prev_screen_id

    Top values

    		stringloading - consider as screen—FirebaseNo Adjust

    Add, remove, or rename parameters from a change ticket.

    Also on every event

    14 global parameters are sent with ALL EVENTS, including this one.

    • custom_user_id
    • user_id_acct
    • user_id_guest
    • online_status
    • custom_time_stamp
    • current_level
    • custom_app_version
    • custom_session_number
    • purchaser_user
    • lives_remaining
    • ab_test_assigned
    • config_version
    • custom_session_id
    • crnt_active_screen

    Version history

    Consecutive backup snapshots, plus rename and delete notes on the sheet. BigQuery 14-day counts annotate a row when the name matches. They do not create renames.

    Seen in BigQuery: 1.9.23 × 100,2241.9.39 × 722,5061.9.41 × 8091.9.42 × 423

    VersionChangeDetails
    1.6.36 → 1.9.23Added7 parameters on introduction
    1.6.36 → 1.9.23Parameter addedcurrent_foreground_id · BQ sample: Home | Gameplay | Loading | StartLevel | OutOfSpace | Win | LevelFailed | DailyGifts
    1.6.36 → 1.9.23Parameter addedcurrent_screen_id · BQ sample: Home | Gameplay | Loading | Win | LevelFailed | Shop | Teaming | LivesBank
    1.6.36 → 1.9.23Parameter addedbatch_close · BQ sample: StartLevel | OutOfSpace | DailyGifts | OutOfSpace, Shop | LoseTime | BaseRewardChestMedia…
    1.6.36 → 1.9.23Parameter addedprev_foreground_duration · BQ sample: 2 | 1 | 3 | 4 | 5 | 6 | 7 | 8
    1.6.36 → 1.9.23Parameter addedprev_screen_duration · Sheet example: on screen change - report duration of the previous screen. Send nothing for val… BQ sample: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 0
    1.6.36 → 1.9.23Parameter addedprev_foreground_id · BQ sample: OutOfSpace | DailyGifts | Shop | LoseTime | BaseRewardChestMediator | Refill | StartLevel…
    1.6.36 → 1.9.23Parameter addedprev_screen_id · Sheet example: loading - consider as screen BQ sample: Home | Gameplay | Loading | Win | LevelFailed | Shop | Teaming | LivesBank