Tutorial Tracking

Overview

Tracking tutorial milestones is essential for understanding how players progress through your game's learning experiences. The Keewano SDK provides two approaches for tutorial tracking, depending on when the tutorial occurs:

1. ReportOnboardingMilestone - For first-time user experience (FTUE) during initial app launch
2. Custom Tutorial Events - For feature-specific tutorials that unlock later in the game

Why Track Tutorials?

By monitoring tutorial milestones, you can:

• Pinpoint exactly where users are dropping off
• Identify which tutorial steps cause confusion
• Optimize the learning experience
• Enable Keewano AI agents to automatically build tutorial funnels with insights into user churn

First-Time User Experience (FTUE)

When to Use ReportOnboardingMilestone

Use KeewanoSDK.ReportOnboardingMilestone for tracking your first-time user experience - the tutorial that happens during the player's first session when they launch your game for the first time.

The data is used to automatically generate a comprehensive FTUE funnel, with our AI agents analyzing each step to determine potential reasons for user churn.

Usage

Simply provide a unique milestone name to the function. Each milestone should have a unique name and be reported only once during onboarding to ensure that analytics accurately reflect the user's progress.

How Funnels Are Built

You don't need to define the order of milestones or specify which step comes after which. The Keewano system automatically analyzes event sequences from all users and builds the funnel based on the paths the majority of users actually took.

This approach reveals real user behavior rather than assumed flow - you'll see what players actually did, not just what you hoped they would do. This helps identify unexpected paths, skipped steps, or alternative routes through your tutorial.

Example

For example, to record that a user has completed the first steps of the tutorial, call:

KeewanoSDK.ReportOnboardingMilestone("Game Intro finished");
\\Continue gameplay code...
 
KeewanoSDK.ReportOnboardingMilestone("Got user name");
\\ Continue gameplay code...
 
KeewanoSDK.ReportOnboardingMilestone("Killed the first boss");
\\ Continue gameplay code....
 
KeewanoSDK.ReportOnboardingMilestone("Collected first reward");

This call logs the milestones, allowing you to analyze user progress and optimize the tutorial experience.

Tutorials for Advanced Game Features

When to Use Custom Tutorial Events

ReportOnboardingMilestone is perfect for tracking your first-time user experience (FTUE), but many games have additional tutorials that unlock later:

• A battle mode tutorial that unlocks at level 10
• A crafting system tutorial that appears after 3 days of play
• A PvP tutorial that becomes available at level 15
• A guild tutorial that unlocks after completing certain quests

For these scenarios, creating dedicated custom events provides better organization and type safety compared to using generic event names.

Creating Tutorial Custom Events

To create custom tutorial events, use the Custom Events Editor.

Recommended naming pattern: End tutorial event names with "Milestone" for consistency with ReportOnboardingMilestone.

Examples: TutorialBattleModeMilestone, TutorialCraftingMilestone, TutorialPvPMilestone

Parameter type: Use String to hold the milestone description.

Usage example:

// When the battle mode tutorial starts
KeewanoSDK.ReportTutorialBattleModeMilestone("Tutorial Started");
 
// As players progress through the tutorial
KeewanoSDK.ReportTutorialBattleModeMilestone("Learned Basic Attack");
KeewanoSDK.ReportTutorialBattleModeMilestone("Learned Combo System");
KeewanoSDK.ReportTutorialBattleModeMilestone("Defeated Tutorial Enemy");
KeewanoSDK.ReportTutorialBattleModeMilestone("Tutorial Completed");

Creating Multiple Tutorial Events

Repeat the process for each tutorial system in your game:

Event Name	When It Unlocks	Example Milestones
TutorialBattleModeMilestone	Level 10	"Tutorial Started", "Learned Combos", "Tutorial Completed"
TutorialCraftingMilestone	After 3 days	"Opened Forge", "Crafted First Item", "Tutorial Completed"
TutorialPvPMilestone	Level 15	"Entered Arena", "Won First Match", "Tutorial Completed"
TutorialGuildMilestone	Level 20	"Joined Guild", "Completed Guild Quest", "Tutorial Completed"

FTUE vs Feature Tutorials

// First app launch (FTUE)
// Use ReportOnboardingMilestone for the initial tutorial
KeewanoSDK.ReportOnboardingMilestone("First Battle Won");
KeewanoSDK.ReportOnboardingMilestone("Reached Level 3");
KeewanoSDK.ReportOnboardingMilestone("First Purchase");
 
// Advanced features (unlocked later)
// Use custom tutorial events for feature-specific tutorials
KeewanoSDK.ReportTutorialBattleModeMilestone("Learned Advanced Combos");
KeewanoSDK.ReportTutorialCraftingMilestone("Crafted Epic Weapon");
KeewanoSDK.ReportTutorialPvPMilestone("Ranked Match Won");