levelCompleted

Note

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

Category: Progression

When it fires — At the moment the player successfully clears the current level session. Closes the session opened by levelStarted and carries the same LevelSessionId.

Fields

LevelNumber

Type: int · Required: Yes · Example: 22

Level number within the main progression.

LevelSessionId

Type: string · Required: Yes · Example: 9d7e8a41-5af0-42f3-996e-4d8aa03fb855

The session identifier from the matching levelStarted.

LevelSecondsPlayed

Type: int · Required: Yes · Example: 156

Seconds spent actively playing this level session. Powers downstream session-duration metrics.

C# example

using TactileModules.TactileAnalyticsModule;

[TactileAnalytics.EventAttribute("levelCompleted")]
[EventCategory("Progression")]
[EventDescription("Fired when the level is successfully completed.")]
public class LevelCompletedEvent
{
    [EventPropertyDescription("Level number within the main progression.")]
    private TactileAnalytics.RequiredParam<int> LevelNumber { get; set; }

    [EventPropertyDescription("Unique identifier of the level session.")]
    private TactileAnalytics.RequiredParam<string> LevelSessionId { get; set; }

    [EventPropertyDescription("Seconds spent actively playing this level session.")]
    private TactileAnalytics.RequiredParam<int> LevelSecondsPlayed { get; set; }

    public LevelCompletedEvent(int levelNumber, string levelSessionId, int levelSecondsPlayed)
    {
        this.LevelNumber = levelNumber;
        this.LevelSessionId = levelSessionId;
        this.LevelSecondsPlayed = levelSecondsPlayed;
    }
}

See also

• levelStarted — Opens the session.
• levelFailed — Fires on each failure during the session.
• levelAbandoned — Closes the session — player exited.
• levelContinued — Fires after each levelFailed when the player continues.