User & Attributes

Managing User Data

The NetmeraUser class allows you to send structured information about your application's users to Netmera. The ideal time to update user attributes is right after the user logs into your application.

User ID Management

For optimal performance and data integrity:

• Update user information at login: It’s crucial to update the user information as soon as the user logs in.

• Unique userId: Ensure that each user has a unique userId. Assigning the same userId to multiple users leads to data inconsistencies and is not recommended.

Updating User Information

Step 1: Identify the User

Use identifyUser after the user logs in:

NetmeraUser user = NetmeraUser();
user.setUserId(<UNIQUE_USER_ID>);
user.setEmail(<USER_EMAIL>);
user.setMsisdn(<USER_MSISDN>);
user.setWhatsAppNumber(<USER_WP_NUMBER>);

// identify without callback
Netmera.identifyUser(user);

// OR

// identify with callback
Netmera.identifyUser(user,
  onSuccess: () {
    ...
  },
  onFailure: (error) {
    ...
  });

Step 2: Update Profile Attributes

Use updateUserProfile to send user details:

final profile = NetmeraUserProfile();
profile.name.set("Muhammad Ali");
profile.surname.set("Clay");
profile.externalSegments.set(["sports", "boxing"]);
profile.gender.set(Gender.notSpecified);
profile.maritalStatus.set(MaritalStatus.married);
profile.childCount.set(9);
profile.country.set("USA");
profile.state.set("Kentucky");
profile.city.set("Louisville");
profile.district.set("West End");
profile.occupation.set("Professional Boxer");
profile.industry.set("Sports");
profile.favoriteTeam.set("favoriteTeam");
profile.language.set("English");
profile.dateOfBirth.set(DateTime(2000, 1, 1).millisecondsSinceEpoch);

// update profile without callback
Netmera.updateUserProfile(profile);

// OR

// update profile with callback
Netmera.updateUserProfile(profile,
  onSuccess: () {
    ...
  },
  onFailure: (error) {
    ...
  });

You should send a single user update request at a time.

Managing attributes with set, add, remove, and unset

The Netmera Flutter SDK supports four core operations for each profile attribute:

Operation	Description	Data Type
set()	Completely replaces the profile attribute	Available for all data types
unset()	Completely deletes the profile attribute	Available for all data types
add()	Adds new element(s) to the profile attribute	Available only for Array-type attributes
remove()	Removes specified element(s) from the profile attribute	Available only for Array-type attributes

For profile attributes defined as arrays, you do not need to manage the entire list at once. You can update them incrementally using add() and remove().

In the following examples, we use externalSegments, which is a predefined array-type profile attribute in the Netmera platform. However, you are free to define and use your own custom profile attributes as needed.

1. set() – Create List from Scratch

final profile = NetmeraUserProfile();
profile.externalSegments.set(["sports_fans","sports_fans"]);
Netmera.updateUserProfile(profile);

Explanation: This operation clears any existing values in the externalSegments field and assigns the new list containing "sports_fans" and "sports_fans". Only the provided segments will be retained.

Use case: Reinitializing the user's profile with a new segment configuration.

2. add() – Add New Elements

final profile = NetmeraUserProfile();
profile.externalSegments.add(["black_friday_2025"]);
Netmera.updateUserProfile(profile);

Explanation: Preserves existing values in the externalSegments list and appends the new segment "black_friday_2025".

Use case: Temporarily adding a user to a campaign-specific segment.

3. remove() – Remove Elements

final profile = NetmeraUserProfile();
profile.externalSegments.remove(["sports_fans"]);
Netmera.updateUserProfile(profile);

Explanation: Removes the "sports_fans" value from the user's externalSegments list. Other segment values remain unchanged.

Use case: Reflecting changes in user interests or preferences.

4. unset() – Clear All Data

final profile = NetmeraUserProfile();
profile.externalSegments.unset();
Netmera.updateUserProfile(profile);

Explanation: Clears all data from the externalSegments field. The user will no longer be associated with any segment.

Use case: When a user account is closed or profile data needs to be reset.

Creating Custom Profile Attributes

Step 1: Navigate to the Developers section

Custom profile attributes must be created and configured in the Netmera Panel before they can be used in the application.

• Go to Panel > Developers > Profile Attributes > Create New Attribute.

Step 2: Fill in Attribute Details

Define the following information:

• Name: The unique identifier for the attribute.

• Label: A user-friendly name for the attribute.

• Description: A brief description of the attribute.

• Data Type: Choose the appropriate data type for the attribute.

• Is Array: Define whether the attribute can hold multiple values.

Step 3: Save the Attribute

After clicking Save, the custom attribute will be available for assignment to your users.

Step 4: Generated Code for Custom Attributes

Once the attribute is defined in the Netmera Panel, the generated code can be found at the bottom of the Profile Attribute page, under the Generate Code section. This code must be added to your Netmera Panel under Profile Attributes > User Class.

Private Information Considerations

Under the KVKK law, the sharing of private user data is prohibited. To ensure compliance:

• Private Information Flag: When defining profile attributes or events, the Private Information feature must be selected to ensure that these attributes are not sent to the backend by the Netmera SDK.

Fetch Coupon

Fetch coupons using the request/response structure and manager:

Netmera.fetchCoupons(0, 10).then((fetchedCoupons) {
// handle coupons
}).catchError((error) {
  debugPrint(error);
});

Email Subscription Preferences

The Netmera SDK provides methods to manage email subscription preferences for your users.

Check Email Subscription Status

Use the following method to check if the user has allowed email subscriptions:

final emailAllowed = await Netmera.getEmailPermission();

• Returns: A Boolean value (true if the user has allowed email subscriptions, otherwise false).

Update Email Subscription Preferences

Set the user's preference for email subscriptions using one of the methods below:

1. Allow Email Subscriptions

await Netmera.setEmailPermission(true);

1. Disallow Email Subscriptions

await Netmera.setEmailPermission(false);

These methods enable you to respect user preferences for email communications within your application.

SMS Subscription Preferences

The Netmera SDK provides methods to manage SMS subscription preferences for your users.

Check SMS Subscription Status

Use the following method to check if the user has allowed SMS subscriptions:

final smsAllowed = await Netmera.getSmsPermission();

Returns: A Boolean value (true if the user has allowed SMS subscriptions, otherwise false).

Update SMS Subscription Preferences

Set the user's preference for SMS subscriptions using one of the methods below:

1. Allow SMS Subscriptions

await Netmera.setSmsPermission(true);

1. Disallow SMS Subscriptions

await Netmera.setSmsPermission(false);

These methods enable you to respect user preferences for SMS communications within your application.

WhatsApp Subscription Preferences

Use these APIs to check or update whether the user allows receiving WhatsApp messages. This permission controls eligibility for WhatsApp-based campaigns.

Check WhatsApp Subscription Status

Use the following method to check if the user has allowed WhatsApp subscriptions:

final whatsAppAllowed = await Netmera.getWhatsAppPermission();

Returns: A Boolean value (true if the user has allowed WhatsApp subscriptions, otherwise false).

Update WhatsApp Subscription Preference

Set the user's preference for WhatsApp subscriptions using one of the methods below:

1. Allow WhatsApp Subscriptions

await Netmera.setWhatsAppPermission(true);

1. Disallow WhatsApp Subscriptions

await Netmera.setWhatsAppPermission(false);

These methods enable you to respect user preferences for WhatsApp communications within your application.