Flutter SDK

traqio is the Traqio SDK for Flutter: a Dart package with an Android and an iOS plugin. On Android it reads the Google Play Install Referrer for deterministic attribution; on iOS it registers installs with SKAdNetwork. It queues events in shared_preferences, records app opens from the app lifecycle, and forwards deep links. No pasteboard, and no advertising id — the opt-in the iOS, Android and React Native SDKs offer is not in this one yet.

Requirements#

• Dart 3, Flutter 3.
• Android 5.0 (API 21) or later; iOS 13 or later.

Set up#

1. Add the package#

   flutter pub add traqio

   Until the package is on pub.dev, reference the copy we send you by path:

   # pubspec.yaml — the package you received, until it is on pub.dev
   dependencies:
     traqio:
       path: ../traqio

2. Initialise in main()#

   lib/main.dart

   import 'package:flutter/widgets.dart';
   import 'package:traqio/traqio.dart';
   
   Future<void> main() async {
     WidgetsFlutterBinding.ensureInitialized();
     await Traqio.init(sdkKey: 'YOUR_SDK_KEY', endpoint: 'https://api.traqio.app');
     runApp(const MyApp());
   }

   init reports the install on first launch, resolves the deferred deep link and records the app open. Awaiting it before runApp makes sure the URL that opened the app is not missed.

3. Track events and set the user id#

   Traqio.setUserId(user.id); // after sign-in — same id as RevenueCat's app_user_id
   Traqio.track('signup');
   Traqio.track('purchase', value: 9.99, currency: 'EUR');

   Names Meta and TikTok can optimise on: Event names.

4. Declare the SKAdNetwork endpoint#

   ios/Runner/Info.plist

   <key>NSAdvertisingAttributionReportEndpoint</key>
   <string>https://api.traqio.app</string>

Deep links#

final unsubscribe = Traqio.onDeepLink((link) {
  if (link.deepLink != null) router.go(link.deepLink!);
});

// The install's deferred link, or null:
final deferred = await Traqio.getDeferredDeepLink();

The plugin forwards URLs on its own and never consumes them: your router still receives every one. An iOS app on the UIScene lifecycle does not get the app-delegate callbacks the plugin listens to, and forwards URLs itself:

// iOS apps on the UIScene lifecycle only: forward the URL yourself
Traqio.handleUrl(url.toString());

Consent#

await Traqio.setConsent(granted); // sharing with ad networks, not measurement

API#

Not in this SDK yet#

• iOS conversion values and Apple Ads. Installs are registered with SKAdNetwork, but no conversion value is set and no Apple Ads token is reported.
• Install Referrer retries. The referrer is read once at first launch; if Google Play does not answer, the install is reported organic.
• Purchase transaction ids, AdMob ad revenue, in-app erasure. Use RevenueCat for purchases and the server-side erasure.

Frequently asked questions#

Does the Flutter SDK set SKAdNetwork conversion values?

Not yet. On iOS it registers each install with SKAdNetwork, so installs from ad networks are attributed through Apple's postbacks, but it does not set conversion values from your mapping, so those postbacks carry no revenue signal. The React Native and native iOS SDKs do set them.

Do I need to forward deep links myself?

Usually not. The plugin forwards the launch intent and new intents on Android, and universal links and URL opens received by the iOS app delegate. Only an iOS app on the UIScene lifecycle passes URLs to Traqio.handleUrl itself.