Flutter Onboarding Tracking: Measure Where Users Drop Off

What you're trying to measure

The goal isn't tracking. The goal is answering: which step in my onboarding flow causes the most users to quit?

To answer that, you need:

1. An event fired at each meaningful step (not page view - completed action)
2. A funnel that sequences those events
3. Per-step conversion rates, split by platform if needed

Install the Flutter SDK

Add the OnRamp SDK to your pubspec.yaml:

dependencies:
  onramp_sdk: ^0.2.0

Then run:

flutter pub get

Initialise in main()

import 'package:onramp_sdk/onramp_sdk.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await OnRamp.init(apiKey: 'onr_your_key_here');

  runApp(const MyApp());
}

Track each onboarding step

import 'package:onramp_sdk/onramp_sdk.dart';

class SignupScreen extends StatefulWidget {
  // ...
}

class _SignupScreenState extends State<SignupScreen> {
  Future<void> _handleSignup(String email, String password) async {
    await AuthService.createAccount(email, password);

    // Fire after the action succeeds
    await OnRamp.step('account_created');

    if (mounted) {
      Navigator.pushNamed(context, '/verify-email');
    }
  }
}

Add properties for segment analysis

await OnRamp.step('account_created', properties: {
  'plan': 'trial',
  'signup_method': 'google',
  'platform': Platform.isIOS ? 'ios' : 'android',
});

Properties let you split the funnel: if iOS users complete onboarding at 70% and Android at 45%, you've found a platform-specific problem to fix.

Recommended step map for Flutter onboarding

Build the funnel

Reading the funnel

What to act on first: the step with the highest count of abandoned users, not necessarily the highest abandonment rate.

Flutter-specific things to watch for

Permission prompt timing. If you ask for push notification permissions during onboarding, many users deny it and immediately close the app. Track permissions_granted and permissions_denied separately so you can distinguish permission refusal from genuine onboarding failure.

iOS vs Android differences. Flutter renders identically but the platform behaves differently. Background app refresh, keyboard behavior, and system permission dialogs all differ. If iOS and Android show different drop-off at the same step, it's almost always a platform-specific behavior - not the design.

Deep link re-entry. If your flow includes email verification with a deep link back into the app, the deep link handler needs to fire the corresponding step. This is a common gap - users click the link, the app opens, but the step never fires.