Analytics Hub Appsflyer Provider

Ukrainian version: README.ua.md

analytics_hub_appsflyer connects analytics_hub to Appsflyer.

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

Installation

dependencies:
  analytics_hub: ^0.4.0
  analytics_hub_appsflyer: ^0.4.0
  appsflyer_sdk: ^6.15.0

Usage

final options = AppsFlyerOptions(
  afDevKey: 'YOUR_DEV_KEY',
  appId: 'YOUR_APP_ID',
  showDebug: true,
);

final sdk = AppsflyerSdk(options);
await sdk.initSdk(
  registerConversionDataCallback: false,
  registerOnAppOpenAttributionCallback: false,
  registerOnDeepLinkingCallback: false,
);

final hub = AnalyticsHub(
  sessionDelegate: yourSessionDelegate,
  providers: [
    AppsflyerAnalyticsHubProvider(
      appsFlyerSdk: sdk,
      getAnonymousId: () => 'anonymous-user-id',
    ),
  ],
);

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(AppsflyerAnalyticsHubIdentifier()),
      ];
}

Session handling

AppsflyerAnalyticsHubProvider behavior:

• If session is present: calls setCustomerUserId(session.id).
• If session is null: calls the required getAnonymousId callback and uses that value with setCustomerUserId(...).