Overview: Metric Builder for Amplitude (Active/New Users)

HOW TO

How to access the Metric Builder for Amplitude (Active/New Users) 

access-active-users

Navigate to Metrics > Custom Metrics to access the Metric Builder. Click the green + New Custom Metric button and select your connected Amplitude Account from the Data Source drop-down list. Select the Active/New Users radio button 

Metric Builder is available on Professional and higher plans. Request a trial of Metric Builder by following these steps.

How to use the Metric Builder for Active/New Users 

useactiveusers

  • A) Data Source: This is the Amplitude Data Source that the Custom Metric is syncing data from.
  • B) Metric: Select a Metric from your connected Amplitude Data Source, such as New Users or Active Users. 
  • C) Group By (Optional): This field enables you to categorize active or new users based on a chosen grouping criterion. By selecting a specific group, you can organize and analyze user data according to your preferences or segmentation criteria (for example, you can group users by Country). 
  • D) Property (Optional): The Property filters restrict the data that gets included in the Custom Metric. All data that is returned is tested against the Property Filter(s). Multiple Filters can be combined using AND boolean logic.   
    If the data synced from the Metric fields meet the Filter specifications, the data is retained and included in the Custom Metric value. If the data synced from the Metric and Dimension fields don't meet the Filter specifications, the data is excluded from the Custom Metric value
    When you select a Property filter, the following fields will appear progressively as you select an option for each field:
    • Operator: Select the Operator from the drop-down list.  
    • Values: Enter a Value for your Entity filter setup. 
  • E) Preview data: After clicking Preview data, a Data Preview of the Custom Metric will be displayed. Daily Metric values are displayed in this section, along with the total Metric values for the Date Range in bold at the bottom. You can view the Data Preview for different Date Ranges by clicking on the drop-down list at the top of the Data Preview.
  • F) Custom Metric Name: Enter a name for your Custom Metric. This Custom Metric name will be available in the Designer after saving.
  • G) Save: Save your Custom Metric. 

How to create a Custom Amplitude Active/New Users Metric [Example]

In this example, we'll create a Custom Metric to report on Active Users tracked in the Amplitude Account, split up based on City and Country. We only want to view this data for the City and Countries, excluding Australia. 

ACTIVE-EXAMPLE

  1. Navigate to Metrics  > Custom Metrics
  2. Click the green + Custom Metric button
  3. Select the appropriate Amplitude Data Source
  4. Select the Active/ New Users radio button
  5. Select Active Users from the Metric drop-down list  
  6. We'll select City and Country from the Group By (Optional) drop-down list so that the Active Users values returned are split up based on the Cities and Countries.
  7. Next, we'll select Country from the Property drop-down, IS NOT from the Operator drop-down, and we'll select Australia as the Value
  8. We don't need to further filter the data, so we won't apply any more segment filters. 
  9. In order to accurately explain what this Custom Metric is reporting on, we'll name the Custom Metric "Active Users by County and City". 
  10. Click Preview data to generate a Data Preview of the Custom Metric. 
  11. Once we confirm that these are the results we're looking for, we'll click Save to save the Custom Metric. 

How to add a Custom Amplitude Active/New Users Metric to a Databoard

Learn how to add a Custom Metric to a Databoard here.


Additional Information

Metric Considerations

The following considerations are due to API/technical limitations and the availability of data: 

  • The Data Preview is limited to display a maximum of 20 Dimensions per Date Range for Dimensional Metrics. Dimensions will be sorted by descending value, therefore the 20 Dimensions with the highest total values will be displayed in the Data Preview for each Date Range.
  • Last X days on the Amplitude UI corresponds to last X+1 days, including today on Databox UI. For example, If the last 2 days are selected on Amplitude, the last 3 days including today must be selected on Databox.
  • The "Total Users" Metric corresponds to the “Most Recent” values in your Amplitude Account. This is selected as default in your Amplitude Account.
    Screenshot 2023-12-21 at 2.25.26 PM
  • The Cumulative toggle can be enabled for the Custom Metrics, but this can lead to data discrepancies as none of the Metrics support this functionality due to technical limitation. 

Granularity Restrictions

  • For the Basic Metrics "Active Users", "New Users", "Average Session Length" and "Average Sessions Per User" and the Custom Metrics that are created by using the Amplitude Metric Builder (Segmentation, Active / New Users and Funnel), only Daily, Weekly and Monthly granularity is supported.
    • Weekly granulation is supported, but it can cause data discrepancies if you have the first day of the week setting in your Databox Account to a different day in comparison to the first day of the week set in your Amplitude Account.
    • Due to API limitations, Quarterly, Yearly and All Time granularity is not supported for these Metrics. This may affect visualization options for Charts in Databox. Learn more about Granularity here
  • For the Basic Metrics "Total Users by Country", "Total Users by Region", "Sessions by Length in Seconds" and the Custom Metrics that are created by using the Amplitude Metric Builder (User Composition and Sessions by Length), Daily, Weekly, Monthly. Quarterly, Yearly and All time granularity is supported. 
    • For Daily granularity, the maximum data we’re able to fetch is 60 days in the past.
    • For Weekly granularity, the maximum data we're able to fetch is 6 months in the past.