The Data Management feature provides a comprehensive insight into the data you track in MoEngage. The data encompasses various crucial elements, including events and user attributes. You can access this feature from Settings > Data > Data Management.
Following are the key information available from the Data Management dashboard:
- Clear visibility of unique events and unique user attributes tracked for your MoEngage account out of the total allowed quota of events and user attributes.
- Displays the count of auto-blocked events and user attributes automatically blocked due to limit breach.
- Displays the volume of users and events processed through MoEngage.
- Displays the top 10 events based on volume.
Overview Tab
The Overview tab of data management gives you high-level information about the number of unique events and user attributes currently tracked for your MoEngage account.
Usage
Provides information about the usage of events and user attributes in MoEngage.
Events
-
Unique events used
This denotes the number of unique events tracked for your MoEngage account out of the total available events that can be tracked. Clicking the Unique events used card takes you to the Event tab. -
Auto-blocked events
This denotes the number of unique events that were blocked in your MoEngage account automatically when the unique events reached 100% of your workspace quota.
Perform the following steps to view the list of auto-blocked events:- On the Overview tab, click the Auto-blocked events card
- You can view the list of all auto-blocked events on the Event tab
User attributes
-
Unique user attributes used
This denotes the number of unique user attributes tracked for your MoEngage account out of the total available events that can be tracked. Clicking the Unique user attributes used card takes you to the User attributes tab. -
Auto-blocked user attributes
This denotes the number of unique user attributes that were blocked in your MoEngage account automatically when the unique user attributes reached 100% of your workspace quota.
Perform the following steps to view the list of auto-blocked user attributes:- On the Overview tab, click the Auto-blocked user attributes card
- You can view the list of all auto-blocked user attributes on the User attributes tab
Limits on Events and Attributes Tracked in MoEngage
The below limits apply when you track data in MoEngage:
Type | Default Limit | Handling for overage |
---|---|---|
Unique Events | 512 | Events not tracked in the last 60 days are auto-blocked first, and then new events are blacklisted if the limit is still breached. |
Unique User Attributes | 256 | User attributes not tracked in the last 60 days are auto-blocked first, and then new user attributes are blacklisted if the limit is still breached. |
Unique Event Attributes | 100 per event | Only the first 100 event attributes will be ingested. |
For more information, refer to Data Tracking Policies.
Volume
Provides information about the volume of users and events processed through MoEngage. Changing the date range filter affects the Event Volume (All Events) and Event Volume (Custom Events) charts. The system generates charts based on the date range defined by the user.
-
Event volume (All events)
This denotes the total count of all events ingested into MoEngage from various sources. The total event includes both system and custom events. Clicking the Event volume card directs you to the analytics chart, allowing you to filter events based on day-level granularity. -
Event volume (Custom events)
This denotes the total count of custom events ingested into MoEngage from various sources. Clicking the Event volume card directs you to the analytics chart, allowing you to filter events based on day-level granularity. -
Web user volume (30-Day)
This denotes the count of users who have executed the event App/Site opened using the Web platform. Note that a user who opens an app/site at least once a month is considered an active user. Clicking the Web user volume card directs you to the analytics chart, allowing you to filter users based on month-level granularity. -
Mobile user volume (30-Day)
This denotes the count of users who have executed the event App/Site opened using the Mobile platform. Note that a user who opens an app/site at least once a month is considered an active user. Clicking the Mobile user volume card directs you to the analytics chart, allowing you to filter users based on month-level granularity. -
Top events by volume
This displays the top 10 events with the maximum volume. Based on your requirements, you can filter for the top events from All events or Custom events.
Event Tab
The Event tab lists all the events tracked for your MoEngage account and enables you to take action on your events. You can click the following event cards to view the associated list of events.
-
Unique events used
This denotes the number of unique events tracked for your MoEngage account out of the total available events that can be tracked. -
Auto-blocked events
This denotes the number of unique events that were blocked in your MoEngage account automatically when the unique events reached 100% of your workspace quota. -
Events not tracked
This denotes the number of events that have received no data since the chosen time duration. After reaching 100% of your workspace quota, these events can be blocked to create new events.
You can perform the following action on your events:
- Click
to download the event list in CSV format.
- Click
to filter events based on Visibility, Category, Platform, Last seen, First seen and click Apply.
- Click
and select the columns you want to view in the events table.
User Attributes Tab
The User attribute tab lists all the user attributes tracked for your MoEngage account and enables you to take action on your user attributes. You can click Unique user attributes used, Auto-blocked user attributes cards to view the list of user attributes associated with it.
You can perform the following actions on your user attributes:
- Click
to download the event list in CSV format.
- Click
to filter events based on Visibility, Category, Platform, Last seen, First seen,Tracked Data type, Allowed Data type, PII Masking and click Apply.
- Click
and select the columns you want to view in the user attributes table.
Categories
The events and user attributes listed on this dashboard are placed under their respective categories which are pre-created by MoEngage. You can expand any category to see the events or user attributes under that category as shown below.
Actions
The data management dashboard supports the following actions:
Action | Result | Supported for |
---|---|---|
Edit Attribute or Event details |
You can edit event, event attribute, or user attribute details. The event details include:
The attribute details include:
|
|
Set / Edit Display Name | On setting/editing the display name of an event or event attribute, the same will be visible in drop-downs to make it easier for marketers when creating the segments/campaigns. |
|
Change Status: Allowed | On changing the status of a blocked event to allowed, the event will start getting tracked for your MoEngage account. By default, all unique events will be allowed unless you breach data tracking limits. |
|
Change Status: Blocked | On changing the status of an event to blocked, the event will no longer be tracked for your MoEngage account even if received. All your existing campaigns for this event will not work. |
|
Change Visibility: On | On changing the visibility of an event to on, the event will start being visible in your drop-downs. By default, all unique events will be visible in drop-downs. |
|
Change Visibility: Off | On changing the visibility of an event to off, the event will stop being visible in your drop-downs. The campaigns/segments which are using events with visibility off will continue to work just fine as the events will still be tracked in your MoEngage account but only hidden from drop-downs. |
|
Set / Edit Description | On setting/editing the description of an event/event attribute, you will be able to get additional context about tracking. This is already set by MoEngage for the MoEngage events as of now and those cannot be edited. |
|
Data privacy configuration |
|
|
Set Allowed Data type | Set a single allowed data type of attributes so that incorrect data types are not ingested into the database. |
|
Status
The Status option allows you to view the allowed or blocked status of events, event attributes, or user attributes.
Whenever an attribute is ingested into the MoEngage system, its status is set to Allowed. Over time, you may start noticing incorrect events, event attributes, or user attributes in your account, likely due to incorrect integration or testing. If you wish to prevent such inaccurately tracked data points, you can block these attributes, which will then change their status to Blocked.
Perform the following steps to block allowed events, event attributes, or user attributes:
- Select the event or user attribute you want to block.
- Click Block.
- In the following dialog box that appears, click Update.
- After blocking, the status changes from Allowed to Blocked.
Perform the following steps to allow the blocked events, event attributes, or user attributes:
- Select the event or user attribute you want to allow.
- Click Allow.
- In the following dialog box that appears, click Update.
- After allowing, the status changes from Blocked to Allowed. Note that you can also allow auto-blocked events using the same procedure explained above.
- Click the ellipsis icon to Edit an attribute or event, Turn visibility off, or Block.
Blocking due to Limits of data tracking
At times, if your events, event attributes, or user attributes breach the limits mentioned here or as shown in your overview tab, then your new events, event attributes, or user attributes may be automatically blocked.
Visibility
The Visibility option helps you hide or unhide events, event attributes, and user attributes from your drop-downs. By default, visibility is on for all events, event attributes, or user attributes ingested into the MoEngage system.
Your drop-downs may become cluttered over time due to too many events and event attributes, even the ones your marketers don't need. In such cases, hiding ensures that such events and event attributes no longer appear in the drop-down.
Perform the following steps to turn off the visibility of your events, events attributes, or user attributes:
- Select the event, event attribute, or user attribute you want to turn off the visibility.
- Click Visibility Off.
- In the following dialog box that appears, click Update.
- After turning it off, the Visibility changes from On to Off.
Perform the following steps to turn on the visibility of your events, events attributes, or user attributes:
- Select the event, event attribute, or user attribute you want to turn on the visibility.
- Click Visibility On.
- In the following dialog box that appears, click Update.
- After turning it on, the Visibility changes from Off to On.
Edit Display Name
Display name will enable your marketers to read your event, event attribute, and user attribute names clearly while creating segments.
At times, when your analytics systems are generating events, they may be encoded and are not easily readable by marketers. In such cases, you can always define a display name for your events and make it easy for your marketers.
Perform the following steps to set the display name for event attribute or user attribute.
- Click the ellipsis icon against event attribute, or user attribute.
- Click Edit attribute.
- In the Edit attribute details side drawer, type the Display name.
- Click Save.
Perform the following steps to set the display name for event.
- Click the ellipsis icon against event.
- Click Edit event.
- In the Edit event side drawer, type the Display name.
- Click Save.
The description will give additional context to your marketers on what an event does. You can set this from the edit event/edit event attribute/edit user attribute pop-up, similar to what is shown in the edit display name action.
Set Allowed Data types
Setting up allowed data type action is supported for user attributes and event attributes and this ensures that any other data type is not recorded for the same attribute.
Perform the following steps to set allowed data types for event attributes or user attributes:
- Click the ellipsis icon against event attribute, or user attribute.
- Click Edit attribute.
- In the Edit attribute details side drawer, select the data type from the Allowed data type list.
- Click Save.
How does this work?
For example, if you set the allowed data types of an attribute called "amount" as Numeric, then after this point, whenever the "amount" attribute is tracked, MoEngage will try to typecast the value to Numeric. For example, after setting allowed data types of amount as Numeric, if you send {"amount": "145"}, which is a string value, we will save it as 145 numeric and enable you to run numeric operators on this value in Segmentation and Analytics. However, if you send {"amount": "sample value"}, we will not be able to typecast this value, and hence it will be dropped. We will not save the amount: sample_value in your database to ensure accurate data is only saved.
The below table lists the data type of incoming attributes on columns and the allowed data type on rows and the value of each cell represents the data ingestion logic.
String | Numeric | Boolean | Date | Location | |
---|---|---|---|---|---|
Any | Accepted as String | Accepted as Numeric | Accepted as Boolean | Accepted as Date | Accepted as Location |
String | Accepted as String | Typecast to String | Typecast to String | Typecast to String | Typecast to String |
Numeric | Typecast to Numeric if possible else drop | Accepted as Numeric | Dropped | Dropped | Dropped |
Boolean | Typecast to boolean if possible else drop | Dropped | Dropped | Dropped | Dropped |
Date | Typecast to Date for accepted formats else drop | Dropped | Dropped | Dropped | Dropped |
Location | Typecast to Location for accepted format else drop | Dropped | Dropped | Dropped | Dropped |
By default, attributes will be set to Any which means that any data type will be accepted for this attribute. If more than one data type is set for an attribute then your segmentation drop-down will show multiple data types during query creation as shown below.
Once you set the allowed data type, only the allowed data type will be ingested going forward. However, we may still see older data types in your database due to past data present in the system. By default, the allowed data type will be pre-selected for your segmentation.
Array Typecasting
All the elements in the array have to be homogenous, which means they must be either integers or strings. If they are not homogenous, MoEngage tries to typecast (transform) the element and then store the data. Following is the example of an array in a CSV field: [1|2|3]
If an array has elements [“1” | 2 | “abc”] of multiple datatypes and the defined datatype is Array Integer, then the final array ingested in MoEngage is [ 1, 2 ]. In this case, “abc” was a string that could not be transformed into an integer and hence not ingested into MoEngage in the final array.