Run endlessly customizable, cross-platform user queries right out of the box

“How often do my app users add an item to their shopping cart but never make a purchase?”

“How many users tried out my new feature, quit the app and never came back?”

“How many users visited the login screen in the last 30 days and experienced a crash?”

Meet Appsee 2.0’s new, highly advanced User Analytics tool. This tool enables you to run sophisticated user queries to answer the above questions and more. It then shows you a complete picture of each user journey, even across platforms and devices. You can also view relevant session replays of unique users.

The tool is both highly customizable and ready to use out of the box. Unlike other user analytics tools, Appsee’s already comes with a huge collection of pre-built user properties. This means you can use the tool right out of the box. It also allows you to import and assign custom user properties to users that are relevant to your business.

Read on to find out how Appsee’s User Analytics tool can help you understand your users, improve your app, and exceed your business goals.

What is User Analytics?

Up until now, Appsee allowed you to filter specific screens or events and get a list of relevant user sessions. This is what we call “session based” queries. For example, a session based query finds all the sessions that had a Purchase Complete event.

In Appsee 2.0, we’ve made it simpler to find users and obtain a complete picture of their user experience by running highly sophisticated user queries. We created User Analytics so that you can ask highly complex questions about your app’s users, and get answers within seconds.

An example of a query on the User Analytics screen, showing the query properties, total user count, and list of individual users.

You can now see different groups of users in one location on the Appsee dashboard: the “Users” tab. In the Users dropdown menu, you can quickly find pre-defined groups of users such as new users, returning users, users who didn’t return, and more. Or, you can run custom user queries within the query builder.

With the query builder, you can filter users who performed or experienced certain actions or events. You can then click a user that interests you and view their device and session history.

All user attributes are shown in one convenient location: the User window. Each User window shows all of the user journey history: devices, sessions, app versions, OS versions, access locations, time spent in the app, and more. In addition, it provides you with session replays as well as timelines of unrecorded sessions.

An example of a user window, where you can see details such as first and last session, time in app, devices and app versions, and recordings and timelines of sessions.

How is a user defined?

A user is identified by an internal user ID. This ID connects the same user across device, platform, and installation. A single user can have multiple sessions, multiple mobile devices, and multiple installs. Every user is automatically given an Appsee User Index. Without an internal User ID, the user will remain Anonymous and will be determined per device installation. Once a user is assigned a User ID, all anonymous data is merged with the user’s ID. You can add custom tags to each user. You can also star users to continue monitoring them.

To attach custom IDs to each user, you’ll need to initially set up your internal user ID in your app’s code. We’ve made it easy to set up the user ID implementation – simply copy and paste the lines according to the instructions here.

A session is a single visit to the app. It begins when the app is launched or resumed from the background. The session ends when the app is either closed, sent to the background, interrupted, or crashes.

Why is Appsee’s user analytics tool different from other user analytics tools?

Most user analytics tools will require that you first define events and user properties manually. As a result, you can’t really start using the tool until you first set up those properties on your own. Appsee autotags a huge number of events and user properties that are unique to mobile app users. Interactions like button taps, text fills, item selections, and checkout or login flows are all automatically tagged. This means you can start using Appsee’s user analytics right out of the box.

Out of the Box User Queries

You can add as many dimensions as you like to create highly complex queries. Appsee’s user queries can include either AND or OR conditions. Queries can be based on user properties and session properties.

For example, you can filter users by:

  • Time – for instance, users that had a session in the last thirty days
  • Platforms – iOS, Android, or both/either
  • Device types – phone/tablet
  • Devices – iPhone X, iPad Air 2, Xiaomi Mi 4, etc.
  • OS versions and app versions
  • Session count – first session, 4th session
  • Time in app – under 30 seconds, over 60 seconds
  • Actions users performed in the app
  • Screens users visited in the app
  • Crashed sessions or sessions that ended in App Not Responding

How do you create a user query?

  1. Select the Users icon on the Appsee dashboard menu. Click on “All” or select one of the predefined user groups (new users, loyal users, multi platform users, etc.).
  2. Start adding as many dimensions as you like to your query. Click on the “+” sign to add another line.
  3. Click on the “search” button to search for your query.
  4. You’ll now see a list of users who match your search query, plus a total user count.
Here you can see the process of running a user query, then selecting a single user from the search results and viewing their user window and session replay.

From your search results, it’s easy to drill down to an individual session from a user. When you find a user you want to investigate, you can click that user and see their full user journey: devices, app versions, first and last sessions, time in app, and more. You can then also view their session replay.

5 User Queries to Run Now

Let’s take a look at several metrics that matter to your app, and the questions they often generate. Here’s how you can turn those questions into queries, and get actionable insights in seconds.


“How many iOS phone users visited the Create an Account screen in the last 30 days and experienced a crash?”

Run a user query where a session exists in which the session time was in the last 30 days, the user was on an iOS phone and visited the Register screen, and the session crashed.


“How many users on all iOS devices launched the app and logged in, but only used the app once?”

Run a user query for users on iOS phones and tablets with only one session, and where a session exists in which there was a button tap on the ‘Login’ button on the ‘Login’ screen, either on phones or on tablets.


“How many users on iOS phones logged into the app and navigated to the Menu and Product screen?”

Run a user query for users who had a session in which they tapped the ‘Login’ button on the ‘Login’ page on iOS phones and also visited the ‘Menu’ and ‘Product’ screens.


“How many users in the United States and Canada who used an iOS tablet to add an item to their cart in the last 30 days?”

Run a user query where a session exists in the last 30 days in the United States or Canada and where the user navigated to the ‘Product’ screen on an iOS tablet and tapped the ‘Add to Cart’ button.


“How many users on all platforms and devices had over 5 sessions in the app and spent over 5 minutes on the app, but haven’t used it since the beginning of the year?”

Run a user query for users whose last session was before the first of January, and where on both platforms their session count was higher than five and the total time they spent in the app was higher than 5 minutes.

User analytics pro tip: After you run the search, open a user window and view the session replay for that user’s sessions to gain a deeper understanding of user behavior.

Custom User Properties

In addition to Appsee’s predefined user properties, you can add your own custom user properties to the platform. This way, you can create user queries that reflect your business’s goals and your unique userbase.

There are 3 methods you can use to define user properties:

  • setUserProperty groups users according to specific characteristics/types. For example: paying/subscribed/onboarded/referred users; users that did not accept location access permission or did not approve push notifications.
  • incUserProperty is a number-based parameter that is used for properties that increase over time. For example: amount paid; number of favorited items; number of points earned/level reached, number of purchases; number of searches the user ran.
  • appendToUserProperty is a text-based parameter that is used to layer additional dimensions to the user property. For example: subscription type; login method; people who have searched for a specific item/category; payment method.

How to Get Started with Appsee 2.0 User Analytics

  1. If you’re not an Appsee user, you can get started with a free 14-day trial here. The trial provides full access to all Appsee features, including our User Analytics tool and custom properties.
  2. If you are already using Appsee, make sure you’re using SDK Version 2.6.0 or later.
  3. Assign a User ID (optional. Assigning a custom ID enables you to track individual users.)
  4. Assign custom User Properties (optional. Preset user properties are already included.)
  5. Start building user queries and get a full understanding of user behavior!

Leave a Reply

Your email address will not be published. Required fields are marked *