React Native User

Use NetmeraUser class to send information about your application's users to Netmera in a structured way.

User ID Management: For optimal performance and data integrity, we strongly recommend updating user information at the point of login. Ensure that the same userId value is assigned exclusively to users who log in with the corresponding account credentials. Assigning the same userId to multiple users can lead to data inconsistencies and is not considered a best practice.

Typical place to inform Netmera about application user's attributes is after your users has logged in to your application. After you have information about your logged in user, you should create a NetmeraUser object, set values, then call Netmera.updateUser() method like below.

import {Netmera, NetmeraUser} from "react-native-netmera"

   const user = new NetmeraUser()
   user.userId = "the_greatest"
   user.email = "[e-mail]"
   user.msisdn = "001XXXXXXXXX"
   user.name = "Netmera"
   user.surname = "Notification"
   user.gender = NetmeraUser.GENDER_MALE
   user.externalSegments = ["sports", "box"]
   user.dateOfBirth = 743069748000
   user.maritalStatus = NetmeraUser.MARITAL_STATUS_SINGLE
   user.country = "USA"
   user.state = "Arizona"
   user.city = "Scottsdale"
   user.district = "Old Town Scottsdale"
   user.favoriteTeam = "My Team"
   user.language = "English"
   user.industry = "Sports"
   user.occupation = "Professional Boxer"
   Netmera.updateUser(user)

UserId cannot be removed:

userId cannot be removed even if you set null to it.

After React Native 1.5.0 Update:

With the React Native version 1.5.0 update, the NetmeraUser gender information is now accessed through the NMUserGender enum:

import {NMUserGender} from "react-native-netmera";

NetmeraUser.GENDER_NOT_SPECIFIED --> No longer needed
NMUserGender.NOT_SPECIFIED

Netmera.updateUser() method after v.1.6.4:

After updating to React Native SDK version 1.6.4 or later, you can utilize the user update feature as demonstrated below:

Netmera.updateUser(user)
  .then(() => {
    console.log('User updated successfully!');
    Toast.show({
      type: 'success',
      text1: 'User updated successfully!',
    });
  })
  .catch(error => {
    console.log(error.code, error.message);
    Toast.show({
      type: 'error',
      text1: error.message,
    });
  });

This example demonstrates how to use the user update feature in React Native SDK version 1.6.4 or later. It includes handling success and error cases with appropriate logging and toast messages.

Adding Custom Attributes to User

Before Generating a Custom Profile Attribute

Before generating a custom profile attribute, ensure that it is first defined in the Netmera Panel. Custom attributes must be created and configured within the panel before they can be used. For detailed instructions on setting up custom profile attributes, please refer to the guide: Creating Custom Profile Attributes.

Similar to events, you can generate a custom NetmeraUser subclass using Netmera Dashboard if the set of built-in attributes is not enough for use case.

• Expand Developers section from left menu. Click on Profile Attributes > Create Attribute.

• After you click Create Attribute, you will see Name, Label, Description, Data Type and Is Array fields. Fill those fields like the image below

• After you click Save, your new attribute will be saved and you will be able to add this attribute to your users.

Generated Code:

For all custom profile attributes, you can find the generated code at the bottom of the 'Profile Attribute' page under the 'Generate Code' section. Be sure to include this generated code in your Netmera Panel under the title Profile Attributes > User Class.

Private Info

The sharing of private datas are prohibited under KVKK law. In the profile and event definitions in the application, firstly the user defines the attributes in the Netmera panel. When the Private Information feature is selected while defining, the value of the attribute is not passed to the backend by the Netmera SDK. This check is done on the SDK side(Netmera.update(user)), the request does not go backend.

fetchCoupon

Use this method to fetch and display the coupons earned by users in your React Native application.

Netmera.fetchCoupons(0, 2)
      .then(result => {
        console.log(result);
      })
      .catch(error => console.log(error));