Support Home > Analytics, Reports & API > Analytics Overview > Analytics Retention (Advanced)

Analytics Retention (Advanced)

The Analytics Retention (Advanced) page provides a visualization of the retention of installs, RPU (Revenue per User), revenue, and events for a selected time frame. Retention (Advanced) provides quick access to organize retention intervals by cohorts and custom milestones. Data within retention can also be calculated utilizing the Classic or Range approaches providing data calculations to answer any question that may exist.


BEST PRACTICE: The advanced features within the retention page may take some time to process. If quick results are needed, use the standard retention page.

Analytics Interface

  1. Log in to Kochava.
  2. Select the desired Account and App.
  3. Select Analytics > Retention (Advanced).

Analytics Page Tools

For more information about the tools that can be used on the Analytics page such as date range, filters, sharing the page and exporting device ID, refer to our Analytics Page Tools support documentation.


Filters can be used to further refine, organize and visualize the displayed data in a method that is most beneficial. Multiple filters can be added and saved for later use.

  1. Click Add Filter.
  2. Added filters may be inclusive or exclusive. Select from the following filters categories:

    1. App — Based on the available apps within account.
    2. Campaign — Based on campaign naming conventions.
    3. Device — Based on user agent.
    4. Events — Based on Standard or Custom events.
    5. Location — Based on IP address.
    6. Attribution — Based on attributed installs and campaign attribution settings.
    7. Agency — Based on the available apps within the agency account.
    8. Traffic Verification — Based on Traffic success or failure.


    Once the filter category has been selected, one or more values may be added per filter. Filters can be saved and reapplied within any of the Analytics pages.

  3. Select the Filter drop-down menu, Select desired Filter.
  4. Add desired values.
  5. Click “X” to remove Filter.


A. Filters
B. Click “+” to add metric
C. Click “X” to remove metric
D. Click “X” to remove Filter and associated Metric(s)

Save App Filters —

  1. Click the “X” to remove a value.
  2. Click “+” to add a value.
  3. Click Save View.


Selecting a Saved Filter —

  1. Select the Saved States drop-down box.
  2. Select the desired Filter Set.


A. Select the desired Filter Set

Deleting Filter Sets:

When saved Filter Sets are no longer needed, they can be deleted.

WARNING: Analytics filters are also used to generate dynamic Audience Export reports, if a filter that is used to create an Audience Export report is deleted an error will be generated when the report is pulled. Before deleting a filter, verify that the filter is not used to pull a report.

  1. Select the Saved States drop-down box.
  2. Select the desired Filter Set.
  3. Click “X” to remove.
  4. Click Proceed.


A. Click “X” to remove

Retention (Advanced) Chart Overview

The retention chart is divided into two main sections, the metrics and date interval displayed and the graphic display of retention in either Grid or Heatwave mode.

Clicking on any of the specific days within the retention chart will display the Active Users, Percentage of users Retained, Revenue, Revenue per User, Events, Events per User, Sessions and Sessions per User.

NOTE: When leveraging cross app functionality, the retention data for all apps within the App Name filter will be displayed. Retention data may be displayed for each app by utilizing the split by feature. For more information on viewing retention data by app, refer to the Retention Organization section. For more information about adding apps using the filter feature, refer to our Analytics Page Tools support documentation.

NOTE: Days within the retention chart that do not have any data will be displayed as an empty box within the Grid display or a gap within the Heatwave mode.


A. Cohort Date, refer to Analytics Page Tools support documentation for more details.
B. Metric and Date interval selections
C. Graphic display of Retention data
D. Specific date data

NOTE: Data within the graphic display is color-coordinated. The darker the color represents the higher the retention rate.

Retention Organization

Retention data can be organized in many different ways in order to assist in the optimization of data visualization.

  1. From the Split By drop-down menu, Select one of the following:
    1. App
      1. App Id
      2. App Name
      3. App Version

      NOTE: In order to use the App split by feature, the desired apps must be added utilizing the filter feature. For more information about adding apps using the filter feature, refer to our Analytics Page Tools support documentation.

    2. Campaign
      1. Campaign
      2. Creative
      3. Segment
      4. Tracker
    3. Device
      1. Device Carrier Name
      2. Device Language
      3. Device Network Conn Type
      4. Device Orientation
      5. Device Os
      6. Device Os Version
      7. Device Type
      8. Device Version
    4. Location
      1. City
      2. Country
      3. DMA
      4. Region
      5. Zip
    5. Attribution
    6. (see iOS 14+ restrictions)

      1. Type
      2. Install Campaign
      3. Install Creative
      4. Install Matched By
      5. Install Network Name
      6. Install Site
      7. Install Tracker
      8. Matched To
      9. Matched By
      10. Network Name
      11. Network Id
      12. Network Key
      13. Partner Ad Group ID
      14. Partner Ad Group Name
      15. Partner Campaign Id
      16. Partner Campaign Name
      17. Partner Keyword
      18. Partner Platform
      19. NOTE: For more information about how the Partner fields map to SAN metadata, please refer to our SAN Networks Campaign Data Mapping support documentation.

      20. QR Code
      21. Site
    7. Agency
      1. Agency Name
      2. Agency Id
    8. Traffic Verification
      1. Traffic Verification Fail Reason
      2. Traffic Verified



    A. Primary Metric Selected (Active Users)
    B. Secondary Metric Selected (Revenue)

Retention Interval

  1. Select a Cohort Date Quick-Select. (optional)
  2. NOTE: 1 Day = The initial day selected in Cohort Date, 3 Day = The initial day selected in Cohort Date + 2 previous days, 7 Days = The initial day selected in Cohort Date + 6 previous days.

    NOTE: The Cohort Date Quick-Select option overrides the primary Cohort Date based on the interval and number of segments that are selected.

  3. Select Interval. (optional)
    1. 1 Day
    2. 7 Days
    3. 30 Days
    4. Custom

    NOTE: When Interval > Custom is selected Custom Interval Milestones become available allowing the display of specifically selected days of data to be displayed.


    BEST PRACTICE: When setting custom intervals, it is best to set each interval option to blank “- -” from right to left and then reassign the interval options as desired.


Data Display

The data that is being displayed within the Analytics Retention page can be viewed in different formats and using different models. Data can be shown in two different forms, grid format or heatwave format, and the data can also be shown calculated using the classic data model or the range data model.

  1. Select Model.
    1. Classic


    3. Range


  2. Select Chart Mode.
    1. Grid


    3. Heatwave