DevFeedbackHub Analytics SDK for Flutter/Dart #

Lightweight analytics SDK for DevFeedbackHub - track tester behavior and goal completion in your app.

Features #

• Track custom events from testers during beta testing
• One-time goal completion with credit rewards
• Recurring daily goal tracking (e.g., "7 consecutive days of usage")
• Automatic event batching and retry
• Zero Flutter dependency (pure Dart - works in any Dart project)

Getting Started #

1. Install #

dependencies:
  devfeedbackhub_analytics: ^1.0.0

2. Initialize #

import 'package:devfeedbackhub_analytics/devfeedbackhub_analytics.dart';

void main() async {
  await DFHAnalytics.init(
    'YOUR_REQUEST_ID',  // From DevFeedbackHub dashboard
    onGoalCompleted: (goalName, credits) {
      print('$goalName completed! +$credits credits');
    },
    onRecurringProgress: (goalName, completed, target) {
      print('$goalName: $completed/$target days');
    },
  );

  runApp(MyApp());
}

3. Track Events #

// Track any event
DFHAnalytics.track('app_open');
DFHAnalytics.track('login');
DFHAnalytics.track('purchase', data: {'item': 'premium'});
DFHAnalytics.track('level_complete', screenName: 'game');

4. Cleanup #

// When app is closing
await DFHAnalytics.dispose();

How It Works #

1. Register events in the DevFeedbackHub dashboard
2. Add this SDK to your app
3. Testers install your app via DevFeedbackHub
4. Events are automatically tracked and matched to testers
5. Testers earn credits when they complete goal events

Debug Logging #

Debug logging is enabled by default. You'll see output like:

DFHAnalytics: Initialized (request: abc-123, device: xxx-yyy)
DFHAnalytics: Events sent: 1
DFHAnalytics:   tester_matched: true
DFHAnalytics:   goal_completed: true (app_open)
DFHAnalytics:   credits_awarded: 3

To disable: DFHAnalytics.init('...', debug: false);

API Reference #

DFHAnalytics.init(requestId, {...}) #

Initialize the SDK. Must be called before track().

DFHAnalytics.track(eventName, {...}) #

Track an event. Events are batched and sent every 5 seconds or when 20 events accumulate.

DFHAnalytics.flush() #

Manually send all queued events immediately.

DFHAnalytics.dispose() #

Flush remaining events and clean up resources.

License #

MIT