Audiences

Audiences let you segment your users in the ways that are important to your business. You can segment by event (e.g., session_start or level_up) and by user property (e.g., Age, Gender, Language), and combine events, parameters, and properties to include practically any subset of users.

Use audiences to:

As Firebase gets new data about users, their audience memberships are reevaluated to ensure they still meet the audience criteria. If the latest data indicate they no longer meet the criteria, they are removed from those audiences.

If you link your project to Google Ads (Project Settings > Integrations), then your audiences are available in your shared library in Google Ads, and you can use them in your ad campaigns. You can remarket to existing or previous users, and you can create similar audiences to prospect for new users.

Analytics prepopulates audiences with up to 30 days of data when that data is available. Before targeting an audience in Cloud Messaging or Remote Config, be sure to check the number of users in your audience to see if it meets expectations.

Note that audience size will typically be different from remarketing-list size. This is usually because tracking IDs can't be sent to Google Ads remarketing lists until Google Ads accounts are linked.

In this article:

Management table

The table lists your audiences: both predefined and ones you have customized. The following audiences are predefined:

  • All users: Users who have ever launched your app.
  • Purchasers: Users who have completed an in-app purchase or ecommerce purchase.

Click an audience in the table to see a detailed report for that audience. Click action menu at the far right to duplicate, edit, delete, or apply the audience to your dashboard.

The user metrics in this report count users who were active during the date range you're using for the report.

Create an audience

If you opted in to use the new audience builder, follow these instructions

You create an audience by selecting criteria that reference the platform and property, and any of the user properties and events (along with any of their parameters) collected from the app. After you create an audience, it accumulates users who meet the specified criteria from that point onward.

When you create an audience that is exported to Google Ads, Analytics adds any users who have met the audience criteria during the last 30 days (assuming you have at least 30 days of data).

You can create up to 50 audiences per project.

As you define your audience, the Summary card updates with the number of users who have met your criteria during the last 30 days so you have an idea of potential audience size.

To create an audience:

  1. In Analytics, navigate to your app.
  2. Click Audiences.
  3. You have three options for creating an audience:

Create a new audience

  1. Click NEW AUDIENCE.
  2. Enter a name and description for the audience. This name and description let you identify the audience in the management table.
  3. Click Add condition group to add users who meet conditions based on dimensions, metrics, and events. For example: Age is one of 18-24, 25-34.
    • Set the scope of the condition. Use the menu at the top right to choose an option:
      • within the same event: all conditions must be met in a single event
      • within the same session: all conditions must be met within the same session (Learn more about how sessions are calculated)
      • across all sessions: all conditions must be met during the lifetime of the user
    • Conditions support static and dynamic evaluation of dimensions. Select At any point to include users if they ever met the condition (static evaluation). If you don't select this option, then user evaluation for an audience is dynamic: users are added to an audience when they meet the conditions and then removed when they no longer meet them.
    • Conditions support time-windowed metrics. For example: in_app_purchase event_count > 5 in any 7 day period
    • Select the in any N day period option to use a time-windowed count vs. a lifetime count.
    • Add OR or AND conditions as necessary.
  4. Click Add sequence to add users who meet conditions that occur in a specific order, and optionally within a specific time period. For example: Step 1: first_open, Step 2: in_app_purchase.
    • Set Time Constraint to ON, and define the time period in which the whole sequence must occur (e.g., 30 Minutes).
    • Configure the condition for Step 1.
    • Click Add step for each additional step you want to include in the sequence.
      • Select is indirectly followed by if the additional step can occur any time after the previous step.
      • Select is directly followed by if the additional step has to occur immediately after the previous step.
      • Select Within to define the maximum amount of time between steps.
  5. Click ADD EXCLUDE GROUP to create a condition that excludes specific users.

    Select Temporarily exclude users when to exclude users from the audience during periods when they meet the condition.

    Select Permanently exclude users when to exclude users from the audience if they've ever met the condition.

    Users are first evaluated by INCLUDE conditions, and then any EXCLUDE conditions. If they meet the EXCLUDE conditions, they are not added to the audience.
  6. Membership duration: Enter the number of days that users remain in the audience (1 - 540).

    Select Set to maximum limit to use the maximum duration in systems that allow for more than 540 days (e.g., Google Analytics, Firebase Cloud Messaging).

    Each time a user engages in behavior that meets the criteria for being included in the audience, then that user's membership duration is reset to the full value of this option.
  7. Click Save to save your conditions and create the audience.

Use a template

Audience templates are partially configured audiences that already identify a set of dimensions and/or metrics that form the basis of widely applicable audiences for app- and web-based businesses.

For example, the Demographics template includes the Age, Gender, Language, Interest IDs, and Location dimensions that you can use to define a particular audience in which you're interested. Using this template, you supply the operators and dimension values that define the audience you want, e.g.:

  • Age exactly matches 18-24
  • Gender exactly matches female
  • etc.

After you complete the audience definition, enter a name, and click Save.

Select a suggested audience

Analytics also provides a number of fully configured audiences that you can use as is or modify if necessary.

For example, the Users who completed a transaction audience is defined as follows:

  • Include Users when transactions > 0

You can use the audience as is, or you can add conditions or sequences, or change the membership duration as necessary.

Use the default name or enter a new name, then click Save.

Instructions for the older audience builder
Version 5.2.0 of the Firebase Analytics framework is required to use the full set of audience capabilities on iOS.

To create a new audience:

  1. In Analytics, navigate to your app.
  2. Click Audiences.
  3. Click NEW AUDIENCE.
  4. Enter a name and description for the audience. This name and description will allow you to identify the audience in the management table.
  5. Click Select Stream, Event, or User Property to choose the data on which the audience is based. The available choices are:
    • Platform: Web, Android, or iOS
    • Stream: the specific app from which you're collecting data (e.g., myAndroidApp)
    • Event: the events triggered in your app
    • User Property: any of the user properties you've set
    • Source: the origin of traffic to your app
    • Medium: the means by which traffic arrived from the source (e.g., organic search, cpc)
    • Campaign: the campaign responsible for traffic
  6. Create one or more conditions that define who should be included in this audience.

    Conditions support time-windowed metrics. For example: in_app_purchase Count greater than 5 in any 7 day period

    Select the in any N day period option to use a time-windowed count vs. a cumulative count.

    If your audience is based on user properties, you can select At any point to have a user included if the condition was ever true for that user. Otherwise, the user is only included if the condition is currently true.

    Combine multiple conditions with OR or AND.
  7. Click ADD EXCLUDE GROUP to create a condition that excludes specific users.
     
    Users are first evaluated by INCLUDE conditions, and then any EXCLUDE conditions. If they meet the EXCLUDE conditions, they are not added to the audience.
  8. Membership duration: Enter the number of days that users remain in the audience (1 - 540).

    Select Set to maximum limit to use the maximum duration in systems that allow for more than 540 days (e.g., Google Analytics, Firebase Cloud Messaging).

    Each time a user engages in behavior that meets the criteria for being included in the audience, then that user's membership duration is reset to the full value of this option.
  9. Click Create to save your conditions and create the audience.
Was this helpful?
How can we improve it?