Flutter SDK (Dart)

Add install and purchase attribution to your Flutter app with a single Dart package.

Prerequisites

Flutter 3.0 or later
Dart 3.0 or later
An Instally account with an App ID and API Key (available at app.instally.io)

Step 1: Add the dependency

Add the Instally package to your pubspec.yaml:

pubspec.yaml

dependencies:
  flutter:
    sdk: flutter
  instally: ^1.0.1

Then run the following command to fetch the package:

Terminal

flutter pub get

Step 2: Configure and track install

Initialize the SDK as early as possible. You can do this in your main() function or in the initState() of your root widget. Replace the placeholder values with the App ID and API Key from your Instally dashboard.

In main()

main.dart

import 'package:flutter/material.dart';
import 'package:instally/instally.dart';

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

  Instally.configure(appId: 'YOUR_APP_ID', apiKey: 'YOUR_API_KEY');
  await Instally.trackInstall();

  runApp(const MyApp());
}

In initState()

my_app.dart

import 'package:flutter/material.dart';
import 'package:instally/instally.dart';

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    _initInstally();
  }

  Future<void> _initInstally() async {
    Instally.configure(appId: 'YOUR_APP_ID', apiKey: 'YOUR_API_KEY');
    await Instally.trackInstall();
  }

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: HomeScreen(),
    );
  }
}

Step 3: Track purchases (optional)

To attribute revenue to referrers, call trackPurchase() after every successful in-app purchase.

purchase_handler.dart

import 'package:instally/instally.dart';

Future<void> handlePurchase(PurchaseDetails purchaseDetails) async {
  if (purchaseDetails.status == PurchaseStatus.purchased) {
    await Instally.trackPurchase(
      productId: purchaseDetails.productID,
      revenue: 9.99,
      currency: 'USD',
      transactionId: purchaseDetails.purchaseID ?? '',
    );
  }
}

Important notes

No special permissions required

The Instally SDK does not use IDFA on iOS or advertising IDs on Android. No ATT prompt is needed. Attribution is handled through Instally's click and install matching flow.

Testing development builds

Development builds are supported. Click one fresh tracking link on the same physical device, launch the app within a few minutes, and avoid clicking the same link repeatedly before the first launch. During local testing, call Instally.resetForTesting() inside a debug-only block before rerunning the same test.

trackInstall() is safe to call on every app launch. It only fires once per install.
trackPurchase() should be called after every successful in-app purchase.
The SDK is lightweight and designed for production apps.
Works alongside any other analytics or attribution provider.

← Android SDK React Native SDK →