Getting Started with the Adopture Flutter SDK

Prerequisites

Before getting started, make sure you have:

• A Flutter project (2.0 or later)
• An Adopture account with an app configured
• Your App ID from the Adopture dashboard

Step 1: Add the Dependency

Add the Adopture SDK to your pubspec.yaml:

dependencies:
  adopture: ^1.0.0

Then run:

flutter pub get

Step 2: Initialize the SDK

In your main.dart, initialize Adopture before running your app:

import 'package:adopture/adopture.dart';
 
void main() {
  Adopture.init(
    appId: 'your-app-id',
    apiUrl: 'https://api.adopture.com',
  );
 
  runApp(MyApp());
}

The SDK will automatically begin tracking screen views when your app navigates between routes.

Step 3: Track Custom Events

For custom events like button taps, purchases, or feature usage:

// Simple event
Adopture.track('button_click');
 
// Event with properties
Adopture.track('purchase', properties: {
  'plan': 'pro',
  'amount': 9.99,
});

All event data is aggregated — no individual user profiles are created.

Step 4: Verify in the Dashboard

Open your Adopture dashboard and navigate to the Realtime view. You should see events appearing within seconds of triggering them in your app.

What Gets Tracked Automatically

Out of the box, the SDK captures:

• Screen views — Which screens users visit and in what order
• Session duration — How long users spend in your app
• Device metadata — OS version, app version, screen size (no device fingerprinting)
• Geography — Country-level location from IP (IP is never stored)

What Doesn't Get Tracked

Equally important — here's what the SDK explicitly avoids:

• No device IDs or advertising identifiers
• No user names, emails, or personal data
• No cross-app tracking
• No cookies or persistent storage

Next Steps

Once you have basic tracking running, explore these features:

• Funnels — Track conversion flows through multi-step processes
• Retention — Understand how often users return to your app
• Custom dashboards — Build views tailored to your KPIs

Check out the full documentation for advanced configuration options and API reference.