The Retention report allows you to see how often new users are returning to your app. Use the Retention report to gauge user loyalty and see which behaviors drive repeat engagement. You can also compare retention among subsets of users.
The Retention report summarizes the percentage of users who return to your app after a certain amount of time. The table displays the number of users who first used the app on a given day. It then shows the percentage of those users who returned one, two, three, or more days later. The table can also be adjusted to display retention dates Weekly or Monthly.
Data from this report can be exported as a CSV or PDF, sent as a scheduled email, or saved in a custom Dashboard.
Selecting this option will allow you to see the percentage of users who first used your app, and then returned to use it a second time on a later date.
Selecting this option will allow you to track user retention based on the completion of two Events. The % of Users Returning will be based on the time it took a user to complete both Events. This means the user completed the first event, then left the app, then returned at a later date to complete the second event.
When setting your Events, it’s also possible to include up to four conditions for each Event to further refine your results.
If you're hitting an issue where you're not seeing the correct results for your date range, you could be running into a limitation of the Query API. The max number of results returned for Retention data is 30,000.
If you're running a query for a 1-year long range, you could end up having a result set size of 365x365, or 133,225 results—which is well above the results limit.
As a workaround, you can run the query with a reduced date range (ie, 3 months at a time) and then concatenate those results into the full year's results.