mobiqo_flutter 1.0.0

Mobiqo SDK for Flutter. Integrate with Mobiqo for user analytics, predictions, and insights.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.0 - 2025-12-06

Added

• MAJOR RELEASE: First stable production release of Mobiqo Flutter SDK
• Added AdditionalData class for structured user data with fields:
  • userId: Optional user identifier
  • userName: Optional user display name
  • userEmail: Optional user email address
  • referrer: Optional referrer/source tracking
• Added updateUser() method to update user information without creating a new session
• Added additionalData parameter to syncUser() method for passing structured user data
• Enhanced API requests to include personal_data field with user information
• Comprehensive documentation for all public methods and classes

Changed

• syncUser() now accepts typed AdditionalData parameter instead of generic Map<String, dynamic>
• syncUser() API request now includes project_id in the request body for consistency
• updateUser() API request includes project_id for proper server-side validation
• Improved type safety across all user-related operations
• Enhanced error handling in updateUser() method
• Updated README with detailed examples of new features and correct class usage

Fixed

• Corrected code examples to use proper AdditionalData class
• Updated all examples to reflect actual class structure

Documentation

• Updated README with updateUser() method usage examples
• Added AdditionalData class documentation
• Corrected all examples to use proper field names matching the Dart classes
• Enhanced method documentation with clearer parameter descriptions

0.0.10

0.0.9

Added

• Added group attribute to AppUser class for A/B testing support (values: 'red' or 'blue')
• Added device model tracking - now automatically captured and sent with syncUser() requests
• Optional support for device_info_plus package to get actual hardware identifiers (e.g., "iPhone13,2", "SM-G991B")
• Fallback to Platform API when device_info_plus is not installed

Changed

• PERFORMANCE IMPROVEMENT: Heartbeat interval reduced from 30 seconds to 20 seconds for better session accuracy
• Updated syncUser() method to include device model in API requests

Notes

• For best device model detection, install: flutter pub add device_info_plus
• Works without device_info_plus but provides less detailed information

0.0.8

Added

• Added includeAdvancedAnalysis parameter to syncUser() method
• Added includeAdvancedAnalysis parameter to getUserInfo() method
• Enhanced API requests to support advanced analysis options (purchase probability and other data)

Changed

• BREAKING CHANGE: Renamed purchaseProbability to purchaseIntent in Statistics class
• Updated method signatures for syncUser() and getUserInfo() to include optional advanced analysis parameter
• Improved documentation with examples of advanced analysis usage

0.0.7

Added

• Added PURCHASE_FAILED MobiqoEvent
• Now supports getUserInfo method

0.0.6 2025-06-XX

Changed

• BREAKING CHANGE: Renamed EventType enum to MobiqoEvent
• Updated all imports from EventType to MobiqoEvent
• Updated extension name from EventTypeExtension to MobiqoEventExtension
• Updated all usage examples and documentation to use MobiqoEvent

Migration Guide

If you're upgrading from a previous version:

1. Change all imports from EventType to MobiqoEvent
2. Update all usage in your code from EventType.xxx to MobiqoEvent.xxx

// Before
await mobiqo.trackEvent('button_pressed', EventType.click);

// After  
await mobiqo.trackEvent('button_pressed', MobiqoEvent.click);

0.0.5 2025-06-XX

Added

• Initial release of Mobiqo Flutter SDK
• User identification and session tracking with syncUser() method
• Custom event tracking with trackEvent() method
• Automatic heartbeat for session management (every 30 seconds)
• User analytics and predictions retrieval with getUserInfo() method
• Support for additional metadata in user sync and event tracking
• Comprehensive data models for user information and statistics
• Built-in error handling and logging
• SharedPreferences integration for session persistence

Features

• User Management: Sync users with RevenueCat IDs and additional metadata
• Event Tracking: Track user interactions with predefined event types
• Session Management: Automatic session tracking with heartbeat functionality
• Analytics: Retrieve user statistics including purchase probability, LTV, and ARPU
• Error Handling: Graceful error handling with informative logging

Dependencies

• Flutter SDK 1.17.0+
• Dart SDK 2.12.0+ (null safety)
• http ^1.1.0
• shared_preferences ^2.2.2