Audiences FAQ

Learn how to create high-value audience segments based on your user data from Singular's attribution service and how to distribute the segments to your ad networks and other partners.

General Questions

What are Singular Audiences?

Singular Audiences is a tool that enables you to tap into your user data from Singular attribution in order to create high-value audience segments.

After you create your audience segments, distribute them to your media sources for activation in campaigns, or distribute them to your internal dashboards for audience analysis.

What can I use Singular Audiences for?

Common uses for Audiences include:

  • Re-engaging inactive users
  • Cross-promotion
  • Targeting new users by using lookalike capabilities of audience partners
  • Encouraging incremental revenue from loyal customers
  • Suppressing active users from your campaigns


What are segments?

audiences_segments_overview.pngAudience segments are groups of users that you create based on app event data. You can view your segments and create new ones by going to Audiences > Segments

Once you create a segment, Singular generates an hourly-updated list of advertising IDs belonging to that segment. You can download the list and/or distribute it to partners.

How much data is available for creating segments?

Any mobile app events sent to Singular (through the Singular SDK/S2S integration) are automatically available for segments. By default, Singular stores 3 months of app event data. You can further filter segment definitions by day, week, and month.

How often are segments updated?

Singular refreshes your segments every hour. The refresh rate at the network varies from partner to partner, but most support at least a daily update.

What is the "reach" of a segment?

The reach, as displayed for each segment in the Segments page, is an estimated figure of how many users the segment includes.

Why does Singular show a different reach than my network?

Your network partner may display a smaller number of targeted users than your Singular Audiences page. This is because your partner can only target the portion of your audience that is part of their user base.

For example, you set up a segment that targets 1000 users and distribute it to Vungle. Of those 1000 users, 900 are part of Vungle’s user base. Therefore, Vungle might show you 900 targeted users.

What is the "Dist. History" of a segment?

Click the Distribution History button for a segment to view a historic log of distribution attempts for configured partners.

How do I create a segment?

You can create segments from one of the templates or from scratch.

To create a segment, first specify details for the base definition from collect user data:

  • Application(s) (Required)
  • Location (Optional) - By country of app install
  • Device Model (Optional)
  • OS Version (Optional)

Important: Do not create a segment that targets more than one OS type (e.g: Android and iOS)

Then further define the base audience by applying filters. At least one filter is required to create a segment. Note that between filters of the same segment the logic is "AND" and not "OR".

  • Installs - By the time of install
  • Sessions - By number of sessions within a timeframe
  • Events - Number of occurrences within a timeframe
  • Revenue - Amount of revenue within a timeframe
How do I edit/modify an existing segment?

To edit an existing segment, click the Actions button in the segment row and select Edit from the menu. You can edit base definitions and filters. Note that if a definition or filter is changed, the segment will be reinitialized, just like new segments.

Why is my segment paused?

By default, a segment that is not in use (not being distributed and not used for downloading reports) is paused and eventually becomes inactive. Inactive segments do not get refreshed with the latest user data.

To change this behavior, edit your segment and change Settings > Unused Segments Behavior to “Never pause segment”.


What are distributions?

audiences_distributions_overview.pngA distribution is a connection between Singular and a partner, such as an ad network, where Singular automatically sends the partner selected audience segments and updates them hourly or daily (depending on what the partner supports).

You can configure your distributions by going to Audiences > Distributions.

How do I configure a distribution?

You can configure your distributions by going to Audiences > Distributions. The page displays a list of Singular's supported audience partners, and you can click the desired partner to create a distribution.

To define the distribution, you will need to enter:

  • Top Level Configuration: Details that Singular needs in order to connect to the partner, such as account IDs and API keys.
  • Segment Configuration: Details needed to send specific segments to the partner, such as the segment IDs and selected account IDs.
How long does it take a segment to generate and be ready for distribution after I create it?
The first time you create a segment it takes 24 hours for the segment to generate and then you are able to distribute it to your selected partners.