Leanplum's user guides and developer documentation.

Leanplum Documentation

Leanplum's user guides, SDK setup, API docs, and more resources are here to help you get the most out of A/B testing, Campaigns, Messaging, and Analytics.

Metric glossary

Available metrics and how Leanplum calculates them

Leanplum Metric Glossary

See definitions for all the metrics in Leanplum. You can review metrics and reports in the Analytics dashboard as well as reports integrated into each campaign you send out to your users. This glossary is organized by section, so select the type of metrics you want to learn more about to get started.

Campaign-level metrics (Results)

You can see campaign-level metrics in the Results tab of the Composer, where you can analyze your campaign's performance. See below for definitions of the different metrics available in Campaign Results

Users per campaign

ūüďė

Users vs Unique users

"Users" refers to total campaign entries, meaning a single user will be counted multiple times if they re-enter the same campaign. When this isn't the case, the metric will specify it's counting "unique users."

Metric

Definition

Users
(Total number of campaign entries)

The total number of users who entered the campaign. An entry is counted after a user receives the first action. One user can enter the same campaign multiple times.

Unique users

The total number of unique users who entered the campaign.

Unique users rate
(Unique users / Total users)

The percentage of campaign entries that were unique users.

Engaged

Metric

Definition

Engaged
(Number of unique clicks on emails + number of opened push notifications + number of clicks on Accept button on in-app messages)

The total number of users that engaged with any of the actions in the campaign.

Engagement rate
(Number of users engaged / (Total emails delivered + total in-app views + total push notifications sent))

The percentage of users who engaged.

Conversions

Metric

Definition

Conversions

The total number of conversions. Note: one user can convert multiple times if the user completes and re-enters the campaign, or if "multiple conversion" is selected.

Conversion rate
(Number of conversions / Number of users)

The percentage of users who converted.

Aggregate Campaign Metrics

The following metrics are calculated based on all of a campaign's Actions for a specific channel. This allows you to compare how all the emails in a re-engagement campaign perform compared to all the push notifications in that same campaign, for example.

Total Emails (Campaign)

Metric

Definition

Sent

The total number of emails sent in the campaign (from all email actions, if multiple).

Delivered

The total number of emails delivered in the campaign.

Delivered per sent
(Delivered / Sent)

The percentage of sent emails that were successfullly delivered.

Unique opened

The total number of unique users who opened at least one email during the campaign.

Unique open rate
(Unique opened / Delivered)

The percentage of users who opened the email after it was delivered.

Unique clicks

The total number of unique users who clicked an email in the campaign.

Unique click rate
(Unique clicks / Delivered)

The percentage of uniqueusers who opened and clicked the email after it was delivered.

Total Push Notifications (Campaign)

Metric

Definition

Sent

The total number of push notifications sent in the campaign (from all push actions, if multiple).

Opened

The total number of push notifications opened during the campaign.

Open per sent
(Opened / Sent)

The percentage of users who opened their push notification after receiving it.

Total In-App Messages (Campaign)

Metric

Definition

Views

The total number of in-app message views in the campaign (from all in-app actions, if multiple).

Accept Clicks

The total number of users who tapped "Accept" on their in-app message.

Accept Clicks Rate
(Accept Clicks / Views)

The percentage of users who tapped "Accept" after viewing their in-app message.

Actions

You can view metrics for each action in a campaign in the Analytics dashboard or in the Results tab of the Composer. Select one of the actions on the right side of the Results tab to view detailed metrics for that specific action.

Individual email

Metric

Definition

Sent

The total number of send attempts (the number of users the email was sent to) for this specific email in the campaign.

Bounce

The total number of bounces for this email. Combines both hard bounces (i.e., the user had an invalid email address) and soft bounces (i.e., the server was offline, the email was too large, etc.).

Bounce per sent
(Bounce / Sent)

The percentage of email send attempts that bounced.

Clicked

The total number of links clicked within an email. Note: an email can contain multiple clickable links, and one user can click a link multiple times.

Click rate
(Percentage of clicks / Delivered)

The percentage of users who clicked a link in the email after successfully receiving it.

Delivered

The total number of successfully delivered emails.

Delivered per sent
(Delivered / Sent)

The percentage of email send attempts that were successfully delivered to the user's inbox.

Dropped

The total number of sends that were not delivered because:

  • the user previously bounced
  • the user unsubscribed
  • the user reported your app as spam
  • the user has an invalid email address

Dropped per sent
(Dropped / Sent)

The percentage of emails that attempted to send but were dropped.

Marked as spam

The total number of unique users who marked the email as spam.

Marked as spam rate
(Marked as spam / Delivered)

The percentage of users who marked the email as spam after successfully receiving it.

Opened

Total number of email open occurrences. Note: one user can open the email multiple times.

Open rate
(Opened / Delivered)

The percentage of successfully delivered emails that were opened.

Unsubscribed

The total number of unique users who unsubscribed.

Unsubscribe rate
(Unsubscribed / Delivered)

The percentage of users who unsubscribed after successfully receiving the email.

Unique clicks (Engaged)

The total number of unique users who clicked any link in the email. Note: multiple clicks by the same user count as 1 unique click.

Unique click rate
(Unique clicks / Delivered)

The percentage of users who clicked any link in their email after it was successfully delivered.

Unique opened

The total number of unique users who opened the email.

Unique open rate
Uunique opens / Delivered)

The percentage of users who opened the email after it was successfully delivered.

Blocked per sent
(Blocked / Sent)

The percentage of attempted email sends that were blocked.

Conversions

The total number of conversions that resulted from this email action or occurred at this stage in the campaign.

Conversion rate
(Conversions for this email / Total campaign conversion)

The percentage of campaign conversions that occurred when this email was sent.

Individual push notification

Metric

Definition

Sent

The total number of sends for this particular push notification.

Open

The total number of times this push notification was opened.

Open per sent
(Opened / Sent)

The percentage of users who opened the push notification after receiving it.

Conversions

The total number of conversions that resulted from this push notification.

Conversion rate
(Conversions for this push / Total campaign conversion)

The percentage of campaign conversions that occurred when this push was sent.

Individual in-app message

Metric

Definition

Viewed

The total number of times this in-app message was viewed.

Accept clicks

The total number of users who tapped "Accept" on this in-app message.

Accept click rate
(Engaged / Viewed)

The percentage of users who tapped "Accept" on the in-app message after viewing it.

Select Button 1

The total number of users who tapped button 1 on this in-app message (only if supported by the in-app template).

Select Button 1 rate
(Select Button 1 / Viewed)

The percentage of users who tapped button 1 on the in-app message after viewing it (only if supported by the in-app template).

Select Button 2

The total number of users who tapped button 2 on this in-app message (only if supported by the in-app template).

Select Button 2 rate
(Select Button 2 / Viewed)

The percentage of users who tapped button 2 on the in-app message after viewing it (only if supported by the in-app template).

Select Banner

The total number of users who tapped the banner on this in-app message (only if supported by the in-app template).

Select Banner rate
(Select Banner / Viewed)

The percentage of users who tapped the banner on the in-app message after viewing it (only if supported by the in-app template).

Submit

The total number of users who tapped the submit button on this in-app message (only supported in the Star Rating in-app template).

Conversions

The total number of conversions that resulted from this in-app message.

Conversion rate
(Conversions for the in-app message / Total campaign conversion)

The percentage of campaign conversions that occurred when the in-app message was sent.

Individual app inbox message

Metric

Definition

Sent

The total number of sends for this particular app inbox message.

Opens

The total number of times this app inbox message was opened.

Open rate
(Opened / Sent)

The percentage of users who opened the app inbox message after receiving it.

Conversions

The total number of conversions that resulted from this app inbox message.

Conversion rate
(Conversions for the app inbox message / Total campaign conversion)

The percentage of campaign conversions that occurred when the app inbox message was sent.

Individual webhook action

Sent

The total number of sends for this particular webhook action.

Conversions

The total number of conversions that resulted from this webhook action.

Conversion rate
(Conversions for the webhook action / Total campaign conversion)

The percentage of campaign conversions that occurred when the webhook action was sent.

Individual app function action

Sent

The total number of sends for this particular app function action.

Conversions

The total number of conversions that resulted from this app function action.

Conversion rate
(Conversions for the app function action / Total campaign conversion)

The percentage of campaign conversions that occurred when the app function action was sent.

Analytics metrics

These metrics are calculated across all of your app's campaigns, and can be found in the Analytics dashboard. To view all metric options, click + as if you're adding a metric tile.

Users

These metrics track a variety of counts and averages related to your first time and returning users.

Click the + Metric tile in Analytics to reveal the Choose a Metric window.

Metric

Definition

First-time users

Total first-time users

The total number of users new to your application.

First-time users
100x(Total first-time users)/(Total daily users)

Tile: The average percentage of users new to your application.
Chart: The percentage of users new to your application.

Returning users

Total returning users
(Total daily users) - (Total first-time users)

The total number of users returning to your application.

Returning users
100x[(Total daily users) - (Total first-time users)] / (Total daily users)

Tile: The average percentage of users returning to your application.
Chart: The percentage of users returning to your application.

Active users

Total daily users

The total number of users using your application.

Daily active users
(Total daily users) / (Days in Time Period)

Tile: The average number of users using your application each day.
Chart: The total number of users using your application.

Weekly active users
(Total weekly users) / (Days in Time Period)

Tile: The average number of users using your application each week.
Chart: The total sum of users using your application during the past week (uses a backward-looking 7-day window to calculate the value for each day).

Monthly active users
(Total monthly users) / (Days in Time Period)

Tile: The average number of users using your application each month.
Chart: The total sum of users using your application during the past month (uses a backward-looking 30-day window to calcualte the value for each day).

Engagement

Engagement metrics track the quality of your relationship with your users. Some engagement-related metrics include session length, number of sessions, and addictiveness.

Metric

Definition

Total sessions

The total number of user sessions.

Sessions per daily user
(Total Sessions) / (Total Daily Users)

Tile: The average number of sessions per user per day.
Chart: The average number of sessions a user has each day.

Total session length

The total length of all sessions.

Average session length
(Total Session Length) / (Total Timed Sessions)

Tile: The average length of a user session.
Chart: The average session length of users.

Time in app per daily user
(Total Session Length) / (Total Daily Users)

Tile: The average length of time a user spends in your app per day.
Chart: The average length of time a user spends in your app.

Addictiveness (DAU/MAU)
(Total Daily Users) / (Total Monthly Users)

The ratio of daily active users to monthly active users.

Retention

Leanplum comes with out-of-the-box retention metrics for Days 1, 3, 7, 14, and 30.

Metric

Definition

1-day retention

The percentage of users who return to your app after 1 day.

3-day retention

The percentage of users who return to your app after 3 days.

7-day retention

The percentage of users who return to your app after 7 days.

14-day retention

The percentage of users who return to your app after 14 days.

30-day retention

The percentage of users who return to your app after 30 days.

Monetization

Track purchase events and lifetime value for your users. If you track an event called "Purchase," the passed values will be used to calculate all other monetization metrics.

Or, you can choose to track a different monetization event by clicking "Select purchase event" (as shown below). The value will then apply to all monetization metrics.

Metric

Definition

Total purchases

The total number of purchases users have made.

Percent of daily users who purchased
100x(Total users who triggered purchase event / Total daily users)

The average percentage of daily users who make a purchase. 

Lifetime value per daily user
(Total LTV) / (Total Daily Users)

The all-time total value of purchases per daily user.

Lifetime value per daily paying user
(Total LTV) / (Total Users Who Triggered purchase event)

The all-time total value of purchases per paying user. 

Daily paying users
(Total Users Who Triggered purchase event) / (Days)

Tile: The average number of users who made a purchase per day during the time period specified.
Chart: The total number of users who made a purchase each day.

Total revenue

The total revenue your app has generated during the time period specified.

Purchases per daily paying user
(Total purchase event Occurences) / (Total Users Who Triggered purchase event)

The average number of purchases a paying user makes per day.

Average revenue per purchase
(Total Sum of purchase event Values) / (Total purchase event Occurrences)

The average amount a user spends with each purchase.

Average revenue per daily user
(Total Sum of purchase event Values) / (Total Daily Users)

The average revenue a user generates per day.

Average revenue per daily paying user
(Total Sum of purchase event Values) / (Total Users Who Triggered purchase event)

The average revenue a paying user generates per day.

Purchase per daily user
(Total purchase event Occurences) / (Total Daily Users)

The average number of purchases a user makes per day. This metric is inclusive of both paying and non-paying users.

Events

Metric

Definition

Occurrences

Total occurrences

The total number of times this event was triggered.

Occurrences per session
(Total # of X Event Occurrences) / (Total Sessions)

The average number of times this event is triggered per session.

Occurrences per daily user
(Total # of X Event Occurrences) / (Total Daily Users)

The average number of times a user triggers this event.

Total first-time occurrences

The total number of times this event was triggered for the first time.

Value

Total sum of event values

Total sum of all values associated with this event.

Average event value per occurrence
(Total Sum of X Event Values) / (Total X Event Occurrences)

The average value of each occurence of this event.

Value per session
(Total Sum of X Event Values) / (Total Sessions)

The average value of this event per session

Value per daily user
(Total Sum of X Event Values) / (Total Daily Users)

The average value of this event per user.

Uniques

Total sessions that triggered event

Total sessions where this event occurs.

Total users who triggered event

Total number of users who triggered this event.

Percent of sessions that triggered event
100x(Total Sessions That Triggered X Event) / (Total Sessions)

The percentage of sessions where this event occurs.

Percent of users who triggered event
(100x(Total Users Who Triggered X Event) / (Total Daily Users)

The percentage of daily users who trigger this event.

Time until first occurrence

Time until session first triggered event
(Total Time Until Session First Triggered X Event) / (Total Sessions That Triggered X Event)

The average time within a session until this event is triggered by a session action.

Time until user first triggered event
(Total Time Until User First Triggered X Event) / (Total First-Time Occurrences of X Event)

The average time spent in the app (across multiple sessions) until this event is triggered by a user action.

Parameters

Total sum of

The total sum of this event parameter.

Average per occurrence
(Total Sum of X Event ) / (Total X Event Occurences)

The average count of this parameter per event occurrence.

Total per session
(Total Sum of X Event ) / (Total Sessions)

The total count of this parameter per session.

Total per daily user
(Total Sum of X Event ) / (Total Daily Users)

The total count of this parameter per user.

States

Metric

Definition

Occurrences

Total occurrences

The total number of times this state was reached.

Occurrences per session
(Total # of Occurrences) / (Total Sessions)

The average number of times this state is reached per session.

Occurrences per daily user
(Total # of Occurrences) / (Total Daily Users)

The average number of times a user reaches this state.

Total first-time occurrences

The total number of times this state was reached for the first time.

Duration

Total time in state

The total time all users spent in this state.

Average duration
(Total Time In State) / (Total State Occurrences with Time)

The average duration of time spent in this state each time it is reached.

Duration per session
(Total Time In State) / (Total Timed Sessions)

The average amount of time spent in this state per session.

Duration per daily user
(Total Time In State) / (Total Daily Users)

The average amount of time spent in this state per user.

Uniques

Total sessions in state

Total sessions where this state is reached.

Total users in state

Total number of users who reached this state.

Percent of sessions in state
100x(Total Sessions That Entered State) / (Total Sessions)

The percentage of sessions where this state is reached.

Percent of users in state
100x(Total Users Who Entered State) / (Total Daily Users)

The percentage of daily users who reach this state.

Time until first occurrence

Time until session first entered state
(Total Time Until Session First Triggered X Event) / (Total Sessions That Triggered X Event)

The average time it takes before this state is first reached during a session.

Time until user first entered state
(Total Time Until User First Triggered X Event) / (Total First-Time Occurrences of X Event)

The average time it takes before this state is first reached by a user.

Updated 4 months ago


Metric glossary


Available metrics and how Leanplum calculates them

Suggested Edits are limited on API Reference Pages

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