Alerts FAQ and Troubleshooting

The Alerts page lets you set up automatic alerts when your data is delayed as well as define custom alerts to get notified about interesting and significant changes in your metrics.

See also: How to Set Up a Custom Alert (a step-by-step guide).



Why does it say "An invalid filter value was given"?


If you see this message on the Alerts page:

  1. Click the alert to edit it.
  2. Expand the filter section. 
  3. The invalid filter value will be marked in red. Remove or edit it as necessary.


One possible reason for this error is that the filter includes an app that has since been removed.

Why does a custom alert say "No subscribers"?

Anyone who was subscribed to this alert has unsubscribed or been removed. If the alert is still relevant, click the alert to open the configuration window and enter some email recipients.


System Alerts FAQ

What are data connectors alerts?

Data connector alerts notify you when there are problems getting your data from your partner networks.

Singular pulls your data every day from your partner networks. We aim to make all of yesterday's data available every morning by 8 a.m. local time (see Data Freshness and Update Times). Occasionally, some data is not available by that time, either because of technical issues on the network's side, problems logging into the network, or a number of other reasons.

You can sign up for two types of data connector alerts:

  • Data delays: General notification whenever data for a particular network is not available at the appointed time. Sign up for this alert if you need to know when data is missing.

    This alert is also available via Slack.

  • Login issues: Occasionally, a partner network can't be accessed because of an authentication problem. Sign up for this alert if you're authorized to go into Singular and reauthenticate or reenter your organization's credentials for ad networks.

Note: You can log into Singular and go to Settings > Data Connectors to see the current status of all your data connectors and whether any of them are experiencing delays.

What do I do when there's a data delay?

In some cases, a data delay requires your action (e.g., to provide updated credentials). If so, Singular specifies what you need to do.

But in most cases, if there's a data delay, Singular is already retrying the data pull automatically, and/or the Singular team is investigating the issue. When possible, we give an estimate of when the data will be available by. All you need to do is check back to the Data Connectors page for the status update.


How do I sign up for data delay alerts via Slack?

Singular can send you a daily update on Slack showing if any of your data connectors are experiencing delays, as well as if any of them require action on your part. You can receive the notification as a direct message or to a Slack channel.

To sign up for Slack data delay alerts:

  1. In the Alerts page, hover over "Data Connector Alerts" and click the edit icon.
  2. Click Activate Data Delay alerts on Slack.


To set this up, go to Settings > Data Connectors and click Alert me on Slack:

Where can I check the status of my data?

You can always go to Settings > Data Connectors to see the updated status of your data connectors.


If there was an unknown problem pulling the data, but Singular has since found the source of the issue, the page will be updated with more details and an estimate of when the data should become available.

You can also see when data was last pulled from that network and when the next pull is scheduled.

Learn more in the Data Connectors FAQ.

Custom Alerts FAQ

What are custom alerts?

Custom alerts are automatic notifications you can set up to monitor your data for significant changes or unexpected stats. You can set up alerts with absolute conditions ("Alert me when daily revenue reaches $20,000") or relative conditions ("Alert me if installs decrease by 20%").

Does Singular create any alerts?

When you first visit the Alerts page, you may see an alert called "Default Fraud Alerts".


Singular creates this default alert to get you started. This alert emails all admin users when there is an increase of rejected installs by 10% in the last 7 days. You may safely edit or discard the alert.

What can I use custom alerts for?

Some popular use cases for custom alerts are:

  • Monitoring CPI spikes: Be informed of ad network CPI changes to keep your ad spend in check ("Alert me if the CPI on any network increases by 20% day-over-day")
  • Shifts in ROI: Know when specific networks are under- or overperforming to reallocate your budgets proactively ("Alert me if network A's 7-days-over-7-days ROI decreases by 10%")
  • Overspend warnings: Set weekly thresholds to be alerted when specific dimensions have exceeded the budgeted amount ("Alert me if the past 7-days spend for network B in Germany or US exceeds $5K")
How do I set up a custom alert?

To set up a custom alert, go to Automation > Alerts and click Add new alert. Follow the on-screen instructions. For a detailed step-by-step guide, see How to Set Up a Custom Alert.

What are the different types of data I have to choose from when configuring a custom alert? What is "tracker-only" data?

When you configure an alert, you first have to choose the type of data (the type of report) you want to be alerted on, and then you can select the specific metric you want to monitor from that report. The available options depend on your account configuration.

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.
Fraud Data The data in your Fraud prevention reports. This includes data on rejected installs, installs marked as suspicious, and cases in which you were protected from a fraud attempt by Singular's fraud prevention system.
When setting up an alert with a relative condition (increase/decrease in a metric), what are the time periods I can compare?

There are several time periods you can compare when you set up a relative condition:

Time Comparison Description and Use-Case
Day over day Compare yesterday to the day before. This lets you monitor volatile performance changes.
Day over 7 days Compare yesterday to the average of the prior seven days. This lets you see if yesterday's performance stands out significantly.
3 days over 3 days Compare the last three days to the three days prior. This shows you the impact of the most recent campaign changes.
7 days over 7 days Compare the rolling week to the previous rolling week to align with reporting time frames.
Weekday over Weekday Compare yesterday to the same weekday last week to help control for intra-week cyclicality.
What is a "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.

For more details, see How to Set Up a Custom Alert.

If I set a threshold, what time period does it apply to?

The threshold is calculated based on the same time period as the condition. For more details, see How to Set Up a Custom Alert.

Who receives the alerts?

A custom alert is sent to all users specified in the alert definition, plus users who have opted to subscribe to an alert from the Alerts Summary page (even if they are not Singular users.

When you define an alert, if you include a recipient email that is not in the domain of your account (your organization), you see a warning. 

Recipients can choose to unsubscribe.

At what time does the alert mechanism check the data?

The data is checked daily at 8 a.m. to trigger any alerts that apply. If you need the check to run at a different time of day, contact Singular support.

What happens if there is a data delay?

If the data for any source (network) involved in an alert definition is delayed, the alert is still triggered based on the data that is available at the time. Singular will let you know in the alert email if any sources are missing.

When do the defined recipients receive the alert?

When alerts are triggered, recipients are notified as soon as possible, with the exception of alerts based on mail reports. With mail reports, recipients are notified within 24 hours (i.e., by the following morning).

How can I stop receiving a specific alert?

Every alert email includes an unsubscribe link. You can also log into Singular, go to the Alerts page and unsubscribe.

Who can modify an alert?

Any user with access to the organization's Singular account can modify, enable/disable or delete the account's alerts. Users who are subscribed to the alert receive an email notifying them of the modification or cancellation of the alert.

For more information about managing users and permissions in your Singular account, see Team Management.

How can I remove someone else from an alert?

To remove a recipient from an alert, go to Automation > Alerts, click the Edit icon for the alert, and remove users as desired. If you remove anyone other than yourself, the person will receive an email to let them know they were removed from the alert list.