DevFeedbackHub Analytics SDK

Flutter SDK for tracking tester behavior and rewarding goal achievements in DevFeedbackHub.

Features

• Automatic tester identification - Device ID based, no user input required
• Event tracking - Track any custom events in your app
• Goal completion notifications - Optional snackbar when testers achieve goals
• Owner preview mode - Test SDK behavior without earning credits

Installation

Add to your pubspec.yaml:

dependencies:
  devfeedbackhub_analytics: ^1.0.0

Usage

Initialize

import 'package:devfeedbackhub_analytics/devfeedbackhub_analytics.dart';

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

  // Initialize with your request ID from DevFeedbackHub
  await DFHAnalytics.init('your-request-id');

  runApp(MyApp());
}

Track Events

// Track events anywhere in your app
DFHAnalytics.track('app_open');
DFHAnalytics.track('purchase');
DFHAnalytics.track('share');

Enable Notifications (Optional)

Show a snackbar when testers achieve goals:

final scaffoldMessengerKey = GlobalKey<ScaffoldMessengerState>();

await DFHAnalytics.init(
  'your-request-id',
  showNotification: true,
  messengerKey: scaffoldMessengerKey,
  notificationConfig: DFHNotificationConfig(
    position: DFHPosition.bottom,
    backgroundColor: Colors.green,
    textColor: Colors.white,
    duration: Duration(seconds: 3),
    icon: Icons.celebration,
  ),
);

// Use the key in your MaterialApp
MaterialApp(
  scaffoldMessengerKey: scaffoldMessengerKey,
  // ...
)

How It Works

1. Developer activates Analytics in DevFeedbackHub app
2. Developer sets up reward goals (e.g., "purchase", "share")
3. Developer integrates this SDK with the request ID
4. Testers use the app - SDK automatically identifies them
5. When testers achieve goals, they earn credits automatically
6. Optional: SDK shows a celebration snackbar

Owner Preview Mode

When the app owner tests the SDK:

• Events are tracked normally
• Goal completion shows preview notification (orange snackbar)
• No credits are awarded (credits are for testers only)

Additional Information

• Package: pub.flutter-io.cn/packages/devfeedbackhub_analytics
• Issues: GitHub Issues