LevelSessionIdGlobalState

Note

A suggested event — define and log it yourself following the patterns in Defining Custom Events. The shape below is the canonical contract.

Category: Global state

Purpose — A global state event carrying the current LevelSessionId. Automatically attached to outgoing analytics events so any event can be trivially joined back to the containing level session.

Fields

LevelSessionId

Type: string · Required: Yes · Example: b1f4888f-aec5-487e-bec5-328c6c95e1b5

The ID of the current level session. A new ID is generated prior to playing any level — when the player presses Play on the main map, or replays a level after a failure. If the player runs out of moves but uses a continue option (paying with coins, IAP, or watching a rewarded ad), the level session ID remains the same — a new ID is only generated when a level is (re)started.

C# example

using TactileModules.TactileAnalyticsModule;

[TactileAnalytics.EventAttribute("LevelSessionIdGlobalState")]
[EventCategory("Global state")]
[EventDescription("Global state event carrying the current LevelSessionId. Attached to analytics events to make it trivial to join any event to the containing level session.")]
public class LevelSessionIdGlobalStateEvent
{
    [EventPropertyDescription("The ID of the current level session.")]
    private TactileAnalytics.RequiredParam<string> LevelSessionId { get; set; }

    public LevelSessionIdGlobalStateEvent(string levelSessionId)
    {
        this.LevelSessionId = levelSessionId;
    }
}

See also

• levelStarted — Each new level session begins here, generating a fresh LevelSessionId.
• UserProgressionGlobalState — Another suggested global state.