FAQ
Common questions about Flutter SDK platforms, integration, and troubleshooting.
General
Which platforms does the Flutter SDK support?
iOS and Android.
Are there differences between the native Android/iOS SDKs and the Flutter SDK?
No. The Flutter SDK wraps the native Adtrace Android and iOS SDKs. Behavior and capabilities match the underlying native integrations.
Implementation
How do I find the Flutter SDK for Adtrace?
Search for adtrace on pub.dev or use the official package:
Add the latest version to your pubspec.yaml. See Integration.
I need a specific version of the Flutter SDK — where do I find it?
Releases are listed on the Adtrace Flutter GitHub repository and on pub.dev for each package version.
Why don't I see data on the Adtrace dashboard after integrating the Flutter SDK?
Common causes:
| Cause | Fix |
|---|---|
| SDK not fully integrated | Review Integration for both native (Android/iOS) and Dart setup. Contact support if issues persist. |
| Dashboard filters | Check date range, data type, locale, and fraud settings in the panel. |
I have problems receiving deferred deep links
Deferred deep link testing requires a specific flow:
- Confirm the tracker URL is formatted correctly.
- If the tracker URL does not include your test device ID, enable probabilistic matching for the test tracker in dashboard settings.
- Uninstall the app from the test device.
- Forget the test device via Settings → Testing Console in the panel.
- Click the tracker URL in the device browser.
- Ignore the redirect to the App Store or Play Store.
- Install the app and launch the SDK (preferably in sandbox with verbose logging).
- If successful, you should see install tracked, deferred deep link returned, and your deferred deep link callback invoked.
See Deep linking for setup details.
Install tracking works in sandbox but not in production
Obfuscation (ProGuard, R8, etc.) can strip SDK classes in release builds. Add the required ProGuard rules from Proguard settings.
Could not build module 'adtrace_sdk'
In Xcode, open Build Settings for your target and set Allow Non-modular Includes in Framework Modules to YES.
My app crashes after adding the Adtrace SDK
Use the latest version from pub.dev. Older releases may be incompatible with recent Flutter SDK versions.
If a crash trace points to Adtrace, open an issue on GitHub or contact support.
How many events can I send per user, and how many parameters per event?
There is no limit on event count or value parameters. See the Android event FAQ for best practices, and Event tracking for Flutter-specific usage.