Unity Game Onboarding Funnel Tracking with GameAnalytics: C# Implementation & Drop-Off Telemetry (Part 2)

using System;
using System.Collections.Generic;
using UnityEngine;
using GameAnalyticsSDK;

public class OnboardingFunnelTracker : MonoBehaviour
{
    private static OnboardingFunnelTracker instance;
    public static OnboardingFunnelTracker Instance => instance;

    // Track step start times for exact duration calculations
    private Dictionary<string, float> stepStartTimes = new Dictionary<string, float>();

    private void Awake()
    {
        if (instance != null && instance != this)
        {
            Destroy(gameObject);
            return;
        }
        instance = this;
        DontDestroyOnLoad(gameObject);
    }

    // =========================================================================
    // STEP START
    // =========================================================================
    public void TrackStepStart(string stepName)
    {
        string prefKey = $"Onboarding_Completed_{stepName}";
        if (PlayerPrefs.GetInt(prefKey, 0) == 1)
        {
            // Step already completed by this user in a previous session
            return;
        }

        if (!stepStartTimes.ContainsKey(stepName))
        {
            stepStartTimes.Add(stepName, Time.time);
        }
        else
        {
            stepStartTimes[stepName] = Time.time;
        }

        Debug.Log($"[Funnel Telemetry] Started Step: {stepName}");
        
        // Log Progression Start to GameAnalytics
        GameAnalytics.NewProgressionEvent(
            GAProgressionStatus.Start,
            "Tutorial",
            stepName
        );
    }

    // =========================================================================
    // STEP COMPLETE
    // =========================================================================
    public void TrackStepComplete(string stepName, int score = 0)
    {
        string prefKey = $"Onboarding_Completed_{stepName}";
        if (PlayerPrefs.GetInt(prefKey, 0) == 1)
        {
            return;
        }

        float durationSeconds = 0f;
        if (stepStartTimes.ContainsKey(stepName))
        {
            durationSeconds = Time.time - stepStartTimes[stepName];
            stepStartTimes.Remove(stepName);
        }

        // Save completed state locally
        PlayerPrefs.SetInt(prefKey, 1);
        PlayerPrefs.Save();

        Debug.Log($"[Funnel Telemetry] Completed Step: {stepName} in {durationSeconds:F1}s");

        // Log Progression Complete to GameAnalytics
        GameAnalytics.NewProgressionEvent(
            GAProgressionStatus.Complete,
            "Tutorial",
            stepName,
            score
        );

        // Also log a design event with time duration for custom funnel slicing
        GameAnalytics.NewDesignEvent(
            $"OnboardingTime:{stepName}",
            durationSeconds
        );
    }

    // =========================================================================
    // STEP FAIL / RETRY
    // =========================================================================
    public void TrackStepFail(string stepName, string failReason)
    {
        Debug.LogWarning($"[Funnel Telemetry] Failed Step: {stepName} | Reason: {failReason}");

        // Log Progression Fail to GameAnalytics
        GameAnalytics.NewProgressionEvent(
            GAProgressionStatus.Fail,
            "Tutorial",
            stepName
        );

        // Log specific fail reason design event
        GameAnalytics.NewDesignEvent($"OnboardingFail:{stepName}:{failReason}");
    }

    // =========================================================================
    // TUTORIAL SKIP
    // =========================================================================
    public void TrackTutorialSkipped(string lastStepName)
    {
        Debug.Log($"[Funnel Telemetry] Player Skipped Tutorial at Step: {lastStepName}");
        GameAnalytics.NewDesignEvent($"Onboarding:SkippedAt:{lastStepName}");
    }
}

// Example: Triggering Funnel Events in a Tutorial Dialogue Controller
public class TutorialDialogueStep : MonoBehaviour
{
    [SerializeField] private string stepName = "01_Welcome_Splash";

    private void OnEnable()
    {
        // Track when the player sees this tutorial dialog
        OnboardingFunnelTracker.Instance.TrackStepStart(stepName);
    }

    public void OnNextButtonClicked()
    {
        // Track when player clicks Next/Continue
        OnboardingFunnelTracker.Instance.TrackStepComplete(stepName);
        
        // Load next tutorial step...
    }
}