How to Set Up a Custom Alert

Use this step-by-step guide to help you set up custom alerts in the revamped Alerts page. 

If you just have a question or an issue, see the Alerts FAQ.

Guide for Project Managers, UA Managers, Engineering Team
Prerequisites Have all your data connectors set up and active.



Add a New Alert

Log into Singular and go to Automation > Alerts.

Click Add New Alert.


Select the Data Type (Report Type) You're Interested In


In the Configure Custom Alert panel, choose the type of data you want to set an alert for, e.g., regular reporting data, tracker data, or ad monetization data. 

The available options depend on your account configuration. If you're not a customer of Singular's attribution service and you haven't set up a data connector for a third-party MMP, you will not see the option for tracker data, etc.

Data Type Description
Reporting Data The same data you see in the Reports page, the Pivot table, etc. This includes data from your ad networks as well as data from your tracker, if you have one set up.
Tracker-only data Only data from your MMP. Available only if you are using the Singular tracker or have set up a data connector for a third-party MMP.
Ad Monetization Data Aggregate ad revenue data as seen in the Ad Monetization report. Available to Singular Ad Monetization customers.
SKAN Data The data in your SKAdNetwork Reports.

Define the Alert Rule

Choose the metric or event you're interested in and at what circumstances you want to be alerted. Is it when the metric goes above/below a certain number? Or when it increases or decreases too quickly?

Here are a few examples of rules you can set:

  • The amount of Clicks is over 1,000,000 for a single day:


  • Installs rise by at least 500 in the past 3 days compared to the 3 days prior:


  • eCPI increases by at least 20% in the past 7 days compared to the 7 days prior:



Optional: Break Down the Alert by Dimension

The next (optional) step is breaking down your alert. You would rarely set an alert for your entire revenue from all campaigns or all your installs for all your different apps. More often, you'll want to know a metric reaches a certain threshold or changes significantly per app, per source (ad network), per app, per country, etc.


Note: Breakdown by Source (ad network) is required for all types of data except tracker-only data. 


Optional: Add a Filter

You can make your alert more specific by filtering it to a specific App, Source, Country, or even Campaign. You can also combine multiple filters.

In the following example, we filter the alert to apply to two campaigns only.


Note: If you filter by Campaign ID or Campaign Name, make sure to type in the ID or Name exactly as it appears in your reports.


Optional: Refine the Alert Rule with an Additional Threshold

If you set an alert for a relative change in a metric (e.g., "clicks rise by over 20%"), you run the risk of getting useless alerts based on very small numbers (e.g., when clicks rise from 2 to 3).

To prevent this, you can add a threshold in absolute numbers. The threshold can be based on any metric but it always applies to the same period of time you defined in the rule.



Configure the Final Settings

Finally, give the alert a name so you can recognize it in the list, enter the email addresses to be alerted, and click Save.



  • Under "Mail to", you can pick "All Admin Users" to have the alert sent to all your team members who are defined in Singular as Admin. For a refresher on managing your team's accounts in Singular, see the Team Management FAQ.
  • You can also type in email addresses that aren't in your organization or don't have a Singular account.

Run a Test Report to Check Your Configuration

Once you've saved the new alert, it's added to the Alert page. Hover over it and click the test icon to run a test report.