Flutter SDK

Reflect SDK for Flutter — a thin Dart + native bridge over the shared ReflectCore engine. Mobile attribution, event tracking, deep linking, and SKAN for iOS and Android.

Installation

Add the dependency to your pubspec.yaml, pinned to a release tag:

dependencies:
  reflect_sdk:
    git:
      url: https://github.com/bablu147/reflect-sdk-flutter.git
      ref: v1.7.0

Then run flutter pub get. Because the plugin pulls its native core as a versioned dependency, a consumer app needs two one-time additions so the published cores resolve.

Android — add the JitPack repo in your app's android/settings.gradle:

dependencyResolutionManagement {
  repositories {
    maven { url 'https://jitpack.io' }   // com.github.bablu147:reflect-android
  }
}

The AAR brings its transitive dependencies (Play Install Referrer, App Set ID, ads-identifier) and R8 keep-rules automatically.

iOS — run cd ios && pod install. If the ReflectCore pod is not yet on CocoaPods trunk, add it to your ios/Podfile:

pod 'ReflectCore', :git => 'https://github.com/bablu147/reflect-ios.git', :tag => '1.0.0'

Requirements

• Dart >=3.0.0, Flutter >=3.10.0
• Android: minSdkVersion 21
• iOS: 12+
• Pulls the shared ReflectCore native engine (JitPack AAR on Android, the ReflectCore pod on iOS) — no other third-party dependencies

Quick start

import 'package:reflect_sdk/reflect_sdk.dart';

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

  await Reflect.initialize(ReflectConfig(
    appKey:        "app_live_...",
    companyKey:    "co_live_...",
    baseUrl:       "https://api.reflect.cloud",
    // signingSecret: "sec_...",  // optional — HMAC-signs ingest + surfaces attribution
  ));

  runApp(MyApp());
}

With a signingSecret set, every event batch is HMAC-signed and posted to the authenticated /event endpoint; without one the SDK falls back to the unsigned /event/batch path.

API reference

Event tracking

// Simple event
await Reflect.trackEvent("level_complete", properties: {
  "level": 5,
  "score": 12340,
});

// Revenue event
await Reflect.trackRevenue(RevenueParams(
  amount: 4.99,
  currency: "USD",
  productId: "gems_500",
  transactionId: "txn_abc123",
));

// Attribute installs/revenue to an email (pass it RAW — the server hashes it;
// only sent while consent is not denied).
await Reflect.setEmail("[email protected]");
await Reflect.clearEmail();   // on logout

The SDK sends the event property bag on the wire as properties; the server maps it to its canonical props field, so props.email reaches attribution. See Privacy & consent for the consent gate and hashing details.

Deep linking

// Get the link that launched the app (incl. server-resolved deferred links)
final initial = await Reflect.getInitialDeepLink();
if (initial != null) {
  navigateTo(initial.path);
}

// Listen for links while running (isDeferred = true for deferred links)
Reflect.onDeepLink.listen((data) {
  navigateTo(data.path);
});

SKAN (iOS)

final result = await Reflect.updateConversionValue(
  42,
  coarseValue: "high",
  lockWindow: false,
);
if (!result.success) print("SKAN error: ${result.error}");

Standard events

Pre-built helpers with typed parameters:

import 'package:reflect_sdk/reflect_sdk.dart';

ReflectStandardEvents.signUpWith("google");
ReflectStandardEvents.levelCompleted(5, score: 12340);
ReflectStandardEvents.addedToCart("gems_500", 4.99, "USD");
ReflectStandardEvents.adShown("admob", "interstitial", revenue: 0.02, currencyCode: "USD");

Global properties

await Reflect.setGlobalProperty("ab_group", "variant_b");
await Reflect.unsetGlobalProperty("ab_group");
await Reflect.clearGlobalProperties();

Purchase & subscription

await Reflect.trackPurchase(PurchaseParams(
  productId: "gems_500",
  price: 4.99,
  currency: "USD",
  receiptData: "<base64-receipt>",
));

await Reflect.trackSubscription(SubscriptionParams(
  productId: "pro_monthly",
  price: 9.99,
  currency: "USD",
  isTrial: true,
));

// Verify a receipt server-side AND track it in one call
final result = await Reflect.verifyAndTrackPurchase(PurchaseParams(
  productId: "gems_500",
  transactionId: "txn_abc123",
  receiptData: "<base64-receipt>",
));

Privacy (GDPR)

final deleted = await Reflect.deleteUserData();
// Clears local state + sends deletion request to server