GameAnalytics
Unity Analytics
Mobile Game Development
Telemetry
Game Engineering

GameAnalytics Unity SDK Integration Guide: Tracking D1/D7 Retention, Level Progression & ARPU

4 min read
Eshan Naithani

Without structured telemetry, running a mobile game is like flying blind. Knowing your total download count is meaningless if you don't know where 80% of your players drop off during the first 10 minutes.

To measure and optimize Day 1 (D1), Day 7 (D7), and Day 30 (D30) player retention, mobile game studios rely on the GameAnalytics SDK — the industry-standard analytics platform built specifically for game development.

In this guide, we detail the step-by-step integration of the GameAnalytics Unity SDK to track retention, level progression funnels, and player revenue metrics.


1. Key Mobile Game Metrics & Telemetry Targets

Using GameAnalytics, game development teams can pinpoint gameplay friction points and balance game economy progression in real time.

Key MetricTarget BenchmarkHow GameAnalytics Measures ItKey Remediation Action
Day 1 Retention (D1)> 35% – 45%Automatic user session tracking 24 hours post-installSimplify onboarding / FTUE (First Time User Experience)
Day 7 Retention (D7)> 12% – 18%Automatic user session tracking 7 days post-installImplement daily rewards, meta-progression, & pushes
Level 1–5 Funnel Completion> 85%Tracked via GAProgressionStatus start/complete eventsIdentify and nerf spikes in level difficulty
ARPDAU$0.05 – $0.25+Tracked via GameAnalytics.NewBusinessEventOptimize ad placement frequency & IAP starter packs

2. Integrating the GameAnalytics Unity SDK

To get started, download the latest package from the GameAnalytics Unity SDK Repository or Unity Asset Store.

1. SDK Initialization & Configuration

Configure your Game Key and Secret Key inside the Unity Editor via Window > GameAnalytics > Select Settings.

2. C# Progression & Telemetry Script

Implement clean level progression hooks using the official GameAnalyticsSDK namespace:

CSHARP
using UnityEngine;
using GameAnalyticsSDK;

public class GameTelemetryManager : MonoBehaviour
{
    private void Awake()
    {
        // Initialize GameAnalytics SDK on game start
        GameAnalytics.Initialize();
    }

    public void TrackLevelStart(int levelNumber)
    {
        // Track when player starts a level
        GameAnalytics.NewProgressionEvent(
            GAProgressionStatus.Start,
            $"World_01",
            $"Level_{levelNumber:D2}"
        );
        Debug.Log($"GameAnalytics: Started Level {levelNumber}");
    }

    public void TrackLevelComplete(int levelNumber, int score, int durationSeconds)
    {
        // Track successful level completion with score
        GameAnalytics.NewProgressionEvent(
            GAProgressionStatus.Complete,
            $"World_01",
            $"Level_{levelNumber:D2}",
            score
        );
        
        // Track custom design event for level completion duration
        GameAnalytics.NewDesignEvent($"LevelDuration:Level_{levelNumber:D2}", durationSeconds);
    }

    public void TrackLevelFailed(int levelNumber, string failReason)
    {
        // Track level failure and specific death/fail reason
        GameAnalytics.NewProgressionEvent(
            GAProgressionStatus.Fail,
            $"World_01",
            $"Level_{levelNumber:D2}"
        );

        GameAnalytics.NewDesignEvent($"FailReason:{failReason}:Level_{levelNumber:D2}");
    }
}

3. Tracking In-App Purchase (IAP) Business Events

GameAnalytics provides built-in validation for Apple App Store and Google Play Store receipt verification:

CSHARP
using UnityEngine;
using GameAnalyticsSDK;

public class GameBusinessTelemetry : MonoBehaviour
{
    public void TrackInAppPurchase(string itemCategory, string itemId, int amountInCents, string currency, string receipt, string signature)
    {
#if UNITY_IOS
        GameAnalytics.NewBusinessEventIOS(
            currency,
            amountInCents,
            itemCategory,
            itemId,
            "shop_screen",
            receipt
        );
#elif UNITY_ANDROID
        GameAnalytics.NewBusinessEventGooglePlay(
            currency,
            amountInCents,
            itemCategory,
            itemId,
            "shop_screen",
            receipt,
            signature
        );
#endif
    }
}

4. Telemetry Implementation Checklist

Implementation StageRecommended PracticeRed Flag to Avoid
Event TaxonomyStandardized hierarchy (World_01:Level_02)Random ad-hoc strings typed by different developers
Funnel GranularityTrack each level stage individuallyGrouping the entire tutorial into 1 single event
Data OverheadLet GameAnalytics SDK auto-batch HTTP payloadsSending manual HTTP web requests inside Update()
IAP VerificationPass native receipts to NewBusinessEvent for validationLogging unverified client-side purchase events

Want to know how proper architecture and telemetry keep your development budget under $15,000? Check out our 2026 Mobile Game Development Cost Guide or 5 Engineering Levers to Reduce Game Dev Costs.

Share this article

Looking to build a production-ready game?

See how I built Bird Sort Mania in 20 days using AI, or check out my full Mobile Games Portfolio to see my shipped titles on Android and iOS.

Join 5,000+ Game Developers

Get weekly insights on Unity performance optimization, AI gameplay architectures, and robust system design. No spam, just deep technical breakdowns.

Unsubscribe at any time. Your data is never shared.

Recommended Reading

More articles in GameAnalytics