tiktok_events_sdk
TikTok Events Manager for Flutter. Implement the TikTok Events Manager in your iOS and Android applications in Flutter.
1.3.0
23K downloads/mo
#2085 most downloaded on pub.dev
marcelomoresco/flutter_tiktok_events_sdk
What this package is like to depend on
Last release 3 months ago
20 May 2026
Ships unpredictably
gaps range from 1 weeks to 6 months
Nearly every release is documented
notes for 22 of 22 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
22 releases · first in 2025
9 releases in the last 12 months
see the full history below
Release timeline
22 releases · Jan 2025 to May 2026
2026
Releases
latest 22-
1.3.020 May 2026Release notes
Open source →- Added runtime tracking controls aligned with the native SDK:
TikTokEventsSdk.setTrackingEnabled(enabled:)— toggle event tracking after init (GDPR/CCPA consent flows). Maps toTikTokBusiness.setTrackingEnabledon iOS andTikTokBusinessSdk.setSdkGlobalSwitchon Android.TikTokEventsSdk.isTrackingEnabled()— read current tracking state.TikTokEventsSdk.flush()— force an immediate flush of queued events. Maps toexplicitlyFlush()on iOS andflush()on Android.TikTokEventsSdk.updateAccessToken(accessToken:)— rotate the access token without re-initializing.
- Added Limited Data Use (LDU) mode for privacy-sensitive markets:
TikTokAndroidOptions.enableLimitedDataUse(maps toTTConfig.enableLimitedDataUse()).TikTokIosOptions.enableLDUMode(maps toTikTokConfig.enableLDUMode()).
- Exposed additional native init-time configuration:
disableAutoEnhancedDataPostbackEventon both Android and iOS — opts out of the SDK's Enhanced Data Postback (EDP) collection.isLowPerformanceDeviceon both Android and iOS — marks the device so the SDK can skip non-essential background work.flushTimeIntervalSecondson Android (maps toTTConfig.setFlushTimeInterval(int)).initialFlushDelaySeconds,attUserAuthorizationDelaySeconds, andcustomUserAgenton iOS (map toTikTokConfig.initialFlushDelay,setDelayForATTUserAuthorizationInSeconds, andsetCustomUserAgent).
- Added iOS-only runtime helpers (no-op or
nullon Android):TikTokEventsSdk.getIdfa()— returns the current IDFA, ornullwhen ATT permission has not been granted.TikTokEventsSdk.setCustomUserAgent(userAgent:)— overrides the SDK's User-Agent at runtime.
- Added runtime tracking controls aligned with the native SDK:
-
1.2.128 Apr 2026Release notes
Open source →- Added optional
appSecretfield toTikTokAndroidOptions. When provided, the SDK initializes viaTTConfig(context, appSecret)to support TikTok Android SDK v1.3+ event authentication. Falls back toTTConfig(context)when omitted (backward compatible). Mirrors the existing iOSaccessTokensupport onTikTokIosOptions.
- Added optional
-
1.2.027 Apr 2026Release notes
Open source →- Migrated iOS plugin to Flutter 3.38
UIScenelifecycle.TiktokEventsSdkPluginnow conforms toFlutterSceneLifeCycleDelegateand registers on bothaddApplicationDelegateandaddSceneDelegatefor legacy and scene-based hosts. See the Flutter 3.38 migration guide. - Breaking: Minimum Flutter version bumped to
3.38.0and Dart SDK to^3.10.0.
- Migrated iOS plugin to Flutter 3.38
-
1.1.521 Apr 2026Release notes
Open source →- Made
externalUserNameandemailoptional inTikTokIdentifier. OnlyexternalIdremains required, matching the native iOS/Android behavior.
- Made
-
1.1.417 Apr 2026Release notes
Open source →- Added Swift Package Manager support for iOS.
- Updated TikTok Business SDK to 1.6.1 on both Android and iOS.
- Migrated Android
build.gradleto Kotlin DSL with conditionalkotlin-androidapply for AGP 9. - Bumped Android Gradle wrapper to 9.4.1.
-
1.1.319 Jan 2026Release notes
Open source →- Added support for the
hasConsentparameter in the Dart API, aligning it with the existing Kotlin implementation.
- Added support for the
-
1.1.211 Dec 2025Release notes
Open source →- Added
isAlreadyInitialized()method to check if the TikTok SDK has been initialized. - Improved
initSdk()to automatically skip re-initialization during hot restarts. - Replaced print statements with debugPrint for improved logging consistency across the SDK.
- Refactored and streamlined code structure in TikTok SDK handlers for better readability and maintainability.
- Added
-
1.1.110 Nov 2025Release notes
Open source →- Improved iOS logging implementation
- Replaced print statements with debugPrint in Dart code
-
1.1.030 Oct 2025Release notes
Open source →- Updated minimum iOS deployment target to 14.0.
- Added ATT (App Tracking Transparency) support with NSUserTrackingUsageDescription and ATT status checks in StartTrackHandler.swift.
- Implemented user consent validation for the startTrack method on both Android and iOS (GDPR/privacy compliance).
- Streamlined event creation with support for content parameters (TTContentParams) on both Android and iOS.
- Updated example app UI to include TikTok SDK initialization fields and improved user input handling.
-
1.0.926 Apr 2025 -
1.0.826 Apr 2025Release notes
Open source →- Start Track: Added startTrack option to SDK initialization.
- iOS Enhancement: Added accessToken field support to TikTokIosOptions.
- Documentation: Updated documentation to reflect new features, configuration steps, and additional setup notes.
-
1.0.701 Apr 2025Release notes
Open source →- Update SDK (Android): Updated TikTok SDK to version 1.3.8 for improved compatibility and performance.
-
1.0.620 Mar 2025Release notes
Open source →- SDK Downgrade: Reverted TikTok SDK on Android to a previous stable version due to dependency resolution issues with JitPack.
-
1.0.512 Mar 2025 -
1.0.411 Mar 2025Release notes
Open source →- Enhancement: The phone number field is now nullable, allowing events to be tracked even when a user's phone number is not provided
-
1.0.307 Mar 2025Release notes
Open source →- iOS: Added a new configuration field to control the automatic display of the ATT prompt in iOS settings.
-
1.0.218 Feb 2025Release notes
Open source →- Documentation: Updated documentation to include JitPack repository for proper dependency resolution.
- Update SDK: TikTok SDK to version 1.3.7.
-
1.0.117 Feb 2025Release notes
Open source →- Bug Fix: Fixed an issue where setting the "value" property as a Number in iOS caused a crash due to an unexpected type mismatch in the TikTokBusinessSDK. Now, numerical values are properly handled to prevent errors related to isEqualToString:.
-
1.0.011 Feb 2025Release notes
Open source →- Stable Release: First stable release of the TikTok Events Manager SDK Flutter Plugin.
-
0.0.325 Jan 2025Release notes
Open source →- iOS Support: Added support for iOS, enabling seamless integration of the TikTok Events Manager SDK on Apple devices.
- Bug Fixes: Resolved several issues related to event tracking and parameter handling for better stability and performance.
-
0.0.225 Jan 2025Release notes
Open source →- Documentation: Enhanced the
README.md - Flutter Environment: Broadened the minimum Flutter SDK requirement to support more projects.
- Example Project: Added a sample Flutter.
- Documentation: Enhanced the
-
0.0.125 Jan 2025