Skip to main content
SDK Version Selection

Choose your SDK version below:

  • Apptrove SDK → Recommended for all projects (Latest: v2.0.0)
  • Trackier SDK → Will be deprecated in May 2026 (v1.x.xx)

Use the tabs below to view user data code for your chosen SDK.

Overview

This guide provides instructions for passing user data, such as User ID, Email, and additional details (e.g., Name, Mobile Number), to the Apptrove Flutter SDK. Associating user data with events enhances tracking and allows correlation with Apptrove data and logs for improved attribution and analytics.

Prerequisites​

  • A Flutter application with the Apptrove SDK installed and initialized
  • Flutter 2.0 or later, Dart 2.12 or later
  • Basic knowledge of Dart and Flutter development

User Data​

Apptrove allows you to pass user data, such as User ID, Email, and additional details, to the SDK. This data can be correlated with Apptrove's data and logs to enhance tracking accuracy and provide richer analytics.

Passing User Data to SDK​

You can pass essential user information like User ID and Email using dedicated SDK methods. Additionally, you can include extra user details (e.g., Name, Mobile Number) using a Map.

Dart Example​

UserDetails.dart
void userDetails() {
  AppTroveFlutterSdk.setUserId("XXXXXXXX");
  AppTroveFlutterSdk.setUserEmail("abc@gmail.com");
}

Dart Example with Additional Data​

UserDetails.dart
void userDetails() {
  AppTroveFlutterSdk.setUserId("XXXXXXXX");
  AppTroveFlutterSdk.setUserEmail("abc@gmail.com");

  var userDetails = Map<String, Object>();
  userDetails["name"] = "abcd";
  userDetails["mobile_number"] = "872xxxxx87";
  AppTroveFlutterSdk.setUserAdditionalDetails(userDetails);
}

Available Methods​

  • setUserId(String): Sets a unique user identifier.
  • setUserEmail(String): Sets the user's email address.
  • setUserAdditionalDetails(Map<String, Object>) (Apptrove) / setUserAdditonalDetail(Map<String, Object>) (Trackier): Sets custom key-value pairs for additional user metadata (e.g., name, mobile number, age, gender).

Best Practices​

  • Set User Data Early: Pass user data as soon as it's available (e.g., after login) to ensure all subsequent events are associated with the user.
  • Use Unique Identifiers: Ensure the User ID is unique to avoid data conflicts in Apptrove's logs.
  • Secure Sensitive Data: Handle user data (e.g., Email, Mobile Number) in compliance with privacy regulations (e.g., GDPR, CCPA).
  • Test in Development Mode: Use "development" or "testing" environments to verify user data integration without affecting production data.

Troubleshooting​

  • User Data Not Recorded: Ensure user data methods (e.g., setUserId, setUserAdditionalDetails) are called before tracking events.
  • Invalid Data Format: Verify that the Map used in setUserAdditionalDetails contains valid key-value pairs.
  • Data Not Visible in Dashboard: Confirm that the SDK is initialized correctly and the user data is being sent to the Apptrove servers.

For further assistance, refer to the Apptrove Documentation Portal or contact support at support@apptrove.com.