analytics_hub_mixpanel 0.3.1

Mixpanel provider for analytics_hub. Forwards LogEvents to Mixpanel.track with optional properties and supports identify/reset for session and anonymous users.

Analytics Hub Mixpanel Provider

Ukrainian version: README.ua.md

analytics_hub_mixpanel connects analytics_hub to Mixpanel.

Current scope is log-only: this package maps LogEvent to Mixpanel.track. It uses the core EventResolver contract with ResolvedEvent payload.

Installation

dependencies:
  analytics_hub: ^0.3.1
  analytics_hub_mixpanel: ^0.3.1
  mixpanel_flutter: ^2.0.0

Usage

final mixpanel = await Mixpanel.init(
  'YOUR_MIXPANEL_TOKEN',
  trackAutomaticEvents: false,
);

final hub = AnalyticsHub(
  sessionDelegate: yourSessionDelegate,
  providers: [
    MixpanelAnalyticsHubProvider(mixpanel: mixpanel),
  ],
);

await hub.initialize();
await hub.sendEvent(const SignupEvent('email'));

Event example:

class SignupEvent extends LogEvent {
  const SignupEvent(this.method) : super('sign_up');

  final String method;

  @override
  Map<String, Object?> get properties => {'method': method};

  @override
  List<EventProvider> get providers => const [
        EventProvider(MixpanelAnalyticsHubProviderIdentifier()),
      ];
}

Session handling

MixpanelAnalyticsHubProvider behavior:

• If session is present: calls identify(session.id).
• If session is null and getAnonymousId callback is provided: identifies with that ID.
• Otherwise: calls reset().