The WebEngage Knowledge Base Developer Hub

Welcome to the WebEngage Knowledge Base developer hub. You'll find comprehensive guides and documentation to help you start working with WebEngage Knowledge Base as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Analyzing User Profiles

A detailed explanation of you can analyze the profile of each user by accessing it through various sections of your dashboard

🚧

Must Read

Please ensure that you have a robust understanding of all the concepts related to Users and User Attributes before proceeding. Doing so will help you understand the workings of this section, better.

How to Access

The profile of a user can be accessed by clicking their (hyperlinked) User IDs listed in
the List of Users, as shown below:

Click to enlarge

A List of Users can be found under the following sections in your dashboard:

  • Analyzing Users : List of Users includes details of all the users that have ever interacted with your app and website, over the entire lifetime of your account.

  • Analyzing Segments: List of Users includes details of all the users that are currently included within the segment. Once a user is removed from the segment, their details will no longer be accessible through the List of Users.

  • Uninstalls: List of Users includes details of all the users that have uninstalled your app within the selected time frame.

  • Analyzing Push, In-app, SMS, Web Push, Email Campaigns: List of Users includes an engagement report for all the users that have included within the campaign's target audience.

Now, let's get you acquainted with all the sections of a user profile and how you can analyze it.

First Impression

User Profiles have been designed to gain in-depth insights into a user's behavioral history and preferences. For this purpose, all profiles have been broken down into the following sections:

  • Basic Information
  • Attributes
  • Devices
  • Channels
  • Events

These sections can be accessed through the navigation bar, as shown below.

Click to enlarge

Let’s go over each one in detail, starting with Basic Information.

Basic Information


This section includes all the primary details related to a user like their contact information, the segments they have been included in, the latest campaigns received by them, details of the last time they interacted with your app and/or website and so on.

Click to enlarge

Basic Information has further been broken down into the following subsections:

Contact

Here you will find details like the user’s name, email address and phone number - all of which can be edited by clicking the pencil icon placed next to the card’s header.

Activity

Under Activity, you will find details of when the user first discovered you, their interaction history and so on. The following parameters are included here:

  • First Seen: This shows you the date and timestamp for the first time the user interacted with your app/ website.

  • Last Seen: This includes the date and timestamp for the user’s latest interaction with your business and gets updated in real-time with each subsequent interaction.

  • Identified On: Here you will see a date stamp indicating the date on which the user became a Known Users.

🚧

Why is the metric, 'Identified On' important?

As discussed under Users, all users are considered to be Unknown Users until information which can help us identify them is disclosed. This piece of information is called a Unique Identifier and plays an important role in user analysis and segmentation. Once a user becomes known, their existing Unknown User Profile merges with the newly created Known User Profile to give you a complete picture.

  • Total Sessions: This indicates a sum of all the user’s interactions with your website and is updated in real-time.

👍

Use-case: Understanding how total sessions is calculated

Let’s say that a user spends 10 minutes surfing through the products listed on your website, leaves and comes back the next day to shortlist a product, and finally completes checkout on the third day.

So, all these interactions will be counted as three sessions here.

  • Total Time: This indicates a sum of all the user’s interactions with your mobile app and is also updated in real-time.

  • Last Location: At WebEngage, we automatically glean information to help you identify where your users are located. So each time a user interacts with your app and/or website through a different location, this field gets updated accordingly.

Acquisition

Here you will see historical information on how the user was acquired and includes details like; Channel, Campaign Name, Landing Page, Referrer URL and so on.

👍

Use-case: Understanding acquisition details

Let’s say that a user discovered you through a link to one of your blog posts shared by someone on Twitter. They read the post and decide to signup. So, the user’s acquisition details would look something like this:

  • Channel: Social

  • Campaign Source: Organic

  • Campaign Medium: Social

  • Campaign Name: your_custom_utm_parameter

  • Landing Page: yourwebsite.com/the-blog-post

  • Referrer URL: twitter.com/the-sharer’s-account

  • Referrer Host: twitter.com

Segments

Here you will find a list of all the segments the user is currently included in. Each segment title has been hyperlinked to the segment’s overview section to help you get a quick idea of how the user has been categorized.

All segments created in WebEngage are rolling and dynamic; which means that they are continually updated to include/exclude users whose actions and/or attributes do/don’t match the rules of segmentation, at any given point in time.

🚧

Understanding How the Segments of a User's Profiles are Updated

For example, if a user’s category changes from Silver to Gold (owing to the high value of their latest purchase), then they will be expelled from the Segment of Silver Shoppers and will automatically get included in the Segment of Gold Shoppers.

All these changes are reflected in real-time here. (detailed read)

Most Recent Campaigns

Here you will find a list of the last 10 campaigns sent to the user over the previous 6 months. To give you a broad idea of how the user has been interacting with your campaigns, the following parameters have been included here;

  • Campaign Name: Each campaign title here has been hyperlinked to the Campaign’s Overview section to help you analyze its impact on user engagement, conversions, and revenue with great ease.

🚧

Related Read

Analyzing Push, In-app, SMS, Web Push, Email campaigns

  • Channel: With WebEngage, you can engage with your users via Push, In-app, SMS, On-site, Web Push, Email - and either of these channels will be listed under this column.

  • Type: This column indicates the type of campaign that has been sent to the user. At WebEngage, you can create four kinds of campaigns; One-time, Triggered, Recurring and Journey Campaigns.

🚧

Understanding Various Campaign Types

Please refer to Campaigns and Its Types for a detailed understanding of all how One-time, Triggered, Recurring and Journey campaigns work.

  • Latest Message Status: Depending on the channel, a campaign can broadly have any of the following statuses in its lifecycle; Sent, Queued, Delivered, Failed, Opened, Clicked and so on. A date-time stamp is also included here, providing more context for each status.

🚧

Understanding the Lifecycle of a Campaign Sent Through Each Channel

Please refer here for a quick read on the typical lifecycle of a Push, In-app, SMS, Web Push and Email campaign sent through the channel or a journey.

Attributes

As discussed under Users Attributes, data points which give us more information about a user are called Attributes in WebEngage. Depending on their nature, attributes are categorized as; System Attributes or Custom Attributes.

Click to enlarge

So under this section, you will find a complete list of all the user attributes being tracked for your WebEngage account, with data pertaining to the user shown against each field.

🚧

Please Note

In cases where no information is available yet, you will see a ‘--’ against the attribute field. This is likely to happen if the user is Unknown or hasn’t interacted well enough with your app/ website yet.

While the details shown under Custom Attributes will solely depend on the data points you choose to custom define and pass to your WebEngage account; the following details can be found under System Attributes in each profile;

  • Gender
  • Date of Birth
  • Company

Devices

Here you will find a complete breakdown of all the devices which have been used to interact with your app and website over the entire lifetime of a user. Such details come in handy especially when debugging, fixing crash reports and so on.

Depending on the platform(s) accessed by the user, this section will be contextually divided into the following subsections; Web (Website), Android and iOS.

  • A maximum of 10 devices with extensive technical details can be found under each subsection.

For example, in the visual below, we can see that the user has used at least one Android device and at least one iOS device to interact with the mobile app.

Click to enlarge

On further examination, we can see that the user used an Android device until mid-2017, and later switched to an iOS device.

Click to enlarge

Here’s a list of all the technical details shown under each subsection:

📘

3.1. Web (Website)

  • OS (Mac OS version, Windows, Linux etc.)
  • Browser (Chrome version, Safari version, Firefox version etc.)
  • Date Registered (The first time this device was used to access the website)
  • Total Sessions
  • Last Used (Last date of interaction)
  • Web Push Subscribe - Source URL (The page through which the user opted-in)

📘

3.2. Android

  • Device Manufacturer
  • Device Model
  • Carrier
  • OS (version)
  • App Version
  • SDK version (Refers to the WebEngage Mobile SDK version added by you to the platform. All user data is collected through it)
  • Advertising ID
  • Android ID
  • Date Registered (The first time this device was used to access the app)
  • Total Sessions
  • Total Time (Time spent on your mobile app throughout their entire lifetime)
  • Last Used (Last date of interaction)

📘

3.3. iOS

  • All data points listed under Android (excluding Android ID)
  • Vendor ID

Channels

With WebEngage, you can engage with your users via six channels in real-time, which include; Push, In-app, SMS, On-site, Web Push and Email. Hence, under this subsection, you will find a comprehensive overview of the user’s channel reachability and interactions over the last two months.

Click to enlarge

The following parameters have been included here to give you a comprehensive overview;

  • Reachability: At WebEngage, channel reachability is automatically gleaned for all your users. Here, you can read the ‘green tick’ as ‘is reachable’ and the ‘red cross’ as ‘not reachable’. These indicators are updated in real-time to reflect any changes in a user’s channel preferences.

For example, in the visual above, if the user decides to opt-in for web push notifications later, then the icon under the column; Web Push, will be replaced with the 'green tick’.

🚧

Understanding Channel Reachability

Please refer to Channels and Channel Reachability for a detailed understanding of what reachability means for each channel and how it's calculated.

  • Total Messages Sent: Here you will see a total of all the messages which have been sent to the user through a particular channel.

Conceptually, one campaign can result in several messages being sent to a user. For example, in the visual above, under In-app we can see that the user has received four messages from two campaigns. This means that either or both the in-app campaigns are recurring/ journey campaigns.

  • Total Campaigns: This represents the total number of campaigns that have been sent to the user via a particular channel, including all campaign types (recurring, triggered, one-time, journey).

🚧

Understanding Campaign Types

Please refer to Campaigns and Its Types for a detailed understanding of how One-time, Triggered, Recurring and Journey campaigns work.

  • Total Conversions: At WebEngage, pre-defined conversion metrics are tracked by default for all types of campaigns and vary per channel. Here you will see a total of all the campaigns which have pushed the user to perform the desired action.

For example, in the visual above, under Push we can see that out of the two campaigns sent to the user, one resulted in a conversion.

Events

🚧

Must Read

Please refer to Events and Event Attributes for a detailed understanding of these concepts and related terms. Doing so will help you understand the workings of this section, better.

You can think of Events as behavioral data which help you trace what a user was doing, when, through which device and on which platform. Such insights come in handy when looking into customer grievances. For this reason, a comprehensive set of data points called Event Attributes have been attached to each event, along with a date-time stamp, as shown below.

Click to enlarge

Hence, this section shows you a timeline of the most recent interactions of the user with your app/website and campaigns over the last 7 days. Let’s run you through its features:

Step 1: Select Custom Date Range

Using the drop-down placed on the extreme right on the top panel, you can select a custom period for your analysis. (Maximum Time Period: 30 Days)

Click to enlarge

Step 2: Analyze Event Attributes

As discussed previously, a contextual set of Event Attributes can be found attached to all the Events listed here. These can be accessed via the drop-down arrow placed towards the extreme right of each Event.

Click to enlarge

The indefinite scroll on this page makes it easier for you to track a timeline of all the actions performed by the user, in descending order.

📘

The following event attributes can found under the Events listed here:

  • Technology (Device, Browser, OS)
  • UTM Parameters
  • Location (Country, City)
  • Page URL (only for website)
  • Screen Name (only for mobile apps)
  • Custom (Attributes) - Only for custom events

We hope this gives you a good idea of how you can leverage all the data stored under each user's profile. Please feel free to reach out via [email protected] in case you have any further queries. We’re always happy to help!

Updated 12 days ago

Analyzing User Profiles


A detailed explanation of you can analyze the profile of each user by accessing it through various sections of your dashboard

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.