User attributes are specific traits of a user such as an email, username, mobile, gender and so on. User Attributes helps target users based on these attributes across devices or installs or to personalize the messages.

Pre-defined Attributes

Use the following helper functions to make use of the MoEngage reserved user attributes.

Moengage.add_first_name("Dominick");
Moengage.add_last_name("Cobb");
Moengage.add_email("dom@level5.com");
Moengage.add_mobile("+12399999999");
Moengage.add_user_name("Dominick (Dom) Cobb"); // Full name for user
Moengage.add_gender("M");
Moengage.add_birthday(new Date(1980, 2, 31));

Custom Attributes

// string
Moengage.add_user_attribute("ATTRIBUTE_NAME_1", "value");
// Integer - Numeric
Moengage.add_user_attribute("ATTRIBUTE_NAME_2", 1);
// Double - Numeric
Moengage.add_user_attribute("ATTRIBUTE_NAME_3", 5.99);
// Date
Moengage.add_user_attribute("ATTRIBUTE_NAME_4", new Date(2021, 2, 10));
// Boolean
Moengage.add_user_attribute("ATTRIBUTE_NAME_5", false); 
// Array (all items should be of same data type)
Moengage.add_user_attribute('colors', ['blue', 'green', 'red']); 

User Login and Logout

UNIQUE_ID is used to uniquely identify a user within the MoEngage dashboard.

Ensure log in and log out of users are implemented correctly during the visit to your website and users are authenticated. 

When you go live with MoEngage web SDK for the first time, ensure that you are setting the unique id of your existing website users on page load.

As soon as the user is authenticated, ensure that the user id is passed on to the MoEngage SDK using the login method. After the user logs out of your app, ensure to call the logout method of MoEngage. If two different unique id information are passed without calling the logout method in between, previous user information is overwritten by the new user.

Use the following function on user login, user log out and update user.

Log In

Use this function to create and log in a user.

Moengage.add_unique_user_id(UNIQUE_ID); // UNIQUE_ID is used to uniquely identify a user.

Log Out

Use this function to forcefully log out the current user.

Moengage.destroy_session();

Update User

Use this function to update the Unique ID of the user.

Moengage.update_unique_user_id(NEW_UNIQUE_ID);

Track User Attributes

Ensure that you are tracking user attributes in the following cases:

1. When a new attribute is set for a user.
   For example, set the Email Id or Mobile No. attribute for the user after a user logs in or signs up on the website.
2. When the value of an existing attribute is updated.
3. When you go live for the first time with MoEngage web SDK integration, ensure that you are passing the user attributes set for your existing website users after page load (if they are not already sent to MoEngage).

Attribute tracking via Google Tag Manager (GTM)

You can also place the above function as a Custom HTML Tag inside GTM. This Tag can be fired once per event/page and triggered on the elements where you wish to track website user attributes. These attributes can be picked up from GTM Data Layer. You can also place the above function as a Custom HTML Tag inside GTM. The GTM Tag is used once per event/page and triggered on the elements where you wish to track website user attributes. The attributes are picked up from GTM Data Layer.

For more information about the default attributes collected by MoEngage SDK, refer to Web SDK Data Collection.

Reach out to us directly from your MoEngage Dashbaord -> Need Help? -> Contact Support or send an email to support@moengage.com.