Skip to main content

event_tracker_handler 0.2.0 copy "event_tracker_handler: ^0.2.0" to clipboard
event_tracker_handler: ^0.2.0 copied to clipboard

Multi-provider event tracking with Firebase Analytics, Mixpanel, and webhooks.

event_tracker_handler #

Multi-provider event tracking with Firebase Analytics, Mixpanel, and custom webhooks.

Features #

  • Track predefined events with a single handler.
  • Firebase Analytics, Mixpanel, and custom webhook backends.
  • Typed user and event data (items, value, currency, custom fields).
  • Timed event manager with lifecycle-aware flushing.
  • Delivery outcomes per tracker plus identity merge support.

Getting started #

Add event_tracker_handler to your pubspec.yaml and complete the setup for any providers you plan to use (Firebase/Mixpanel).

If you plan to use Mixpanel on Flutter web, load the Mixpanel script from the plugin assets in web/index.html before the Flutter app initializes:

<!-- web/index.html -->
<script src="/assets/packages/mixpanel_flutter/assets/mixpanel.js"></script>

Usage #

Create settings for each tracker and build a handler instance:

import 'package:decimal/decimal.dart';
import 'package:event_tracker_handler/event_tracker_handler.dart';

final handler = EventTrackerHandler.instance([
  EventTrackerSettingsFirebase(
    eventsToTrack: [EventTrackerEvents.openApp, EventTrackerEvents.purchase],
  ),
  EventTrackerSettingsMixpanel(
    token: 'YOUR_MIXPANEL_TOKEN',
    eventsToTrack: [EventTrackerEvents.openApp, EventTrackerEvents.purchase],
  ),
  EventTrackerSettingsCustomWebhook(
    url: 'https://example.com/events',
    eventsToTrack: [EventTrackerEvents.openApp],
  ),
]);

Future<void> trackPurchase() async {
  await handler.init();

  handler.logEvent(
    type: EventTrackerEvents.purchase,
    userData: EventTrackerUserData(
      uuid: 'user-123',
      email: 'user@example.com',
      isAnonymous: false,
    ),
    data: EventTrackerData(
      value: Decimal.parse('29.90'),
      currency: 'USD',
      customData: {'plan': 'pro'},
    ),
  );
}

Log events return delivery outcomes per tracker:

final outcomes = await handler.logEvent(
  type: EventTrackerEvents.openApp,
  userData: EventTrackerUserData(
    uuid: 'user-123',
    email: 'user@example.com',
    isAnonymous: false,
  ),
);
final failed = outcomes.where((outcome) => outcome.isFailure);

You can also build tracker settings from a map:

final settings = EventTrackerSettingsModel.fromMap({
  'type': 'EventTrackerType.mixpanel',
  'token': 'YOUR_MIXPANEL_TOKEN',
  'events': ['EventTrackerEvents.openApp', 'EventTrackerEvents.purchase'],
  // Or set track_all: true to track every EventTrackerEvents value.
});

Timed events #

Use the timed event manager to start, finish, or flush active timers:

final timedManager = EventTrackerTimedEventManager(
  handler: handler,
  userDataProvider: () async => EventTrackerUserData(
    uuid: 'user-123',
    email: 'user@example.com',
    isAnonymous: false,
  ),
);

final handle = timedManager.start(type: EventTrackerEvents.viewContent);
await timedManager.finish(handle);

Attach a lifecycle observer to flush when the app goes inactive:

final observer = EventTrackerLifecycleObserver(
  timedEventManager: timedManager,
);
WidgetsBinding.instance.addObserver(observer);

Identity merge #

Merge identities when a user logs in or links accounts:

await handler.mergeIdentity(
  previousUserId: 'anon-456',
  userData: EventTrackerUserData(
    uuid: 'user-123',
    email: 'user@example.com',
    isAnonymous: false,
  ),
);

Additional information #

Custom webhook events include an envelope with type, timestamp, context, and payload. The context includes app, device, user, and web metadata when available, while the payload carries event properties and timing details.

0
likes
0
points
277
downloads

Publisher

unverified uploader

Weekly Downloads

Multi-provider event tracking with Firebase Analytics, Mixpanel, and webhooks.

Repository (GitHub)
View/report issues

License

unknown (license)

Dependencies

decimal, device_info_plus, firebase_analytics, flutter, http, mixpanel_flutter, package_info_plus, web

More

Packages that depend on event_tracker_handler