Live snapshot · Latest To Release
Events / 🎮 Engagement Analytics
custom_session_start
readySpec
Doc fields save here and survive re-import. Name, status, parameters, and pipeline flags change through a ticket.
Status is ready, introduced after 1.9.39. Firebase on, Adjust off (adj_custom_session_start).
Open change ticketSheet 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
- timestamp, user_id, platform, session_count, first_open, day_count, day_1, day_7, day_30, days_from_last_session
- start_source · Added notification source of opening app
- ab_test · 1st level original (A) and test (B) versions 50/50
- last_session_duration · we removed session_end, so let's track this in session start
Parameters
10 on this event
| Parameter | Type | Examples | Description | Flags |
|---|---|---|---|---|
Top values | string | — | first open on device | FirebaseNo Adjust |
Top values | string | — | days since first open | FirebaseNo Adjust |
Top values | unknown | — | — | FirebaseNo Adjust |
Top values | number | 39 minutes and 20 sec. = 39.3 | total time played in minutes since the user first opened the app for the current profile (account should inherit time played from selected profile) | FirebaseNo Adjust |
Top values | unknown | — | — | FirebaseNo Adjust |
Top values | enum | app_open, signed_in, signed_out, ?account_delete? notification_id allowed: app_open · signed_in · signed_out · ?account_delete? notification_id | — | FirebaseNo Adjust |
Top values | unknown | — | — | FirebaseNo Adjust |
Top values | enum | a / b allowed: a · b | — | FirebaseNo Adjust |
Top values | string | need to discuss and investigate current implementation for cust_start | — | FirebaseNo Adjust |
Top values | enum | date/time allowed: date · time | — | 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
Validation
- warning“current_level” is also a global ALL EVENTS parameter.
- warning“config_version” is also a global ALL EVENTS parameter.
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 × 3,5191.9.39 × 29,5271.9.41 × 311.9.42 × 19
| Version | Change | Details |
|---|---|---|
| misho detailed → release test 2 | Added | 5 parameters on introduction |
| misho detailed → release test 2 | Parameter added | first_open_date · BQ sample: 1786698957 | 1786272462 | 1786587538 | 1780839076 | 1787214143 | 1787620633 | 1786088504 … |
| misho detailed → release test 2 | Parameter added | day_number · BQ sample: 36 | 42 | 38 | 28 | 24 | 25 | 31 | 26 |
| misho detailed → release test 2 | Parameter added | current_level · BQ sample: 1 | 4 | 5 | 3 | 100 | 196 | 306 | 7 |
| misho detailed → release test 2 | Parameter added | session_number |
| misho detailed → release test 2 | Parameter added | days_since_last_session · BQ sample: 0 |
| release test 2 → production 3 | Parameter added | total_minutes_played · Sheet example: 39 minutes and 20 sec. = 39.3 BQ sample: 0 | 0.1 | 0.4 | 0.2 | 15899.1 | 1.7 | 4 | 2.4 |
| release test 2 → production 3 | Parameter added | start_source · Sheet example: app_open, signed_in, signed_out, ?account_delete? BQ sample: app_open | logout | notification_id |
| release test 2 → production 3 | Parameter added | config_version · BQ sample: 7/29/2026 20:49 | 9/18/2026 14:32 | 8/25/2026 12:30 |
| release test 2 → production 3 | Parameter added | user_id_guest |
| release test 2 → production 3 | Parameter removed | session_number |
| production 4 → 2026.03.31 | Parameter removed | user_id_guest |
| 2026.03.31 → 1.6.36 | Parameter added | ab_test · Sheet example: a / b |
| 2026.03.31 → 1.6.36 | Parameter added | first_opened · Sheet example: date/time |
| 1.6.36 → 1.9.23 | Parameter added | last_session_duration · Sheet example: need to discuss and investigate current implementation for cust_start BQ sample: 0.1 | 0 | 0.2 | 0.4 | 0.6 | 0.3 | 1.2 | 0.8 |