MoEngage highly recommends using the optional step for MoEngage Web SDK integration.
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.
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("firstname.lastname@example.org"); 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));
// 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.
If the user log in and log out is not handled correctly, user data may get corrupted.
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.
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.
Use this function to forcefully log out the current user.
Use this function to update the Unique ID of the user.
Unique ID restrictions
Track User Attributes
Ensure that you are tracking user attributes in the following cases:
- 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.
- When the value of an existing attribute is updated.
- 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).
Make sure that you are not using a single unique id for all the users, this is possible only when the unique id value is hardcoded, instead of retrieving from your servers.
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 email@example.com.