Rules and notifications

Configure notifications and rules to stay informed about important events and automate responses within your ad campaigns.

Read time 7 minutes

A rule is a setting within Notifications that enables you to be informed by using email (once daily) about any ads that you deem problematic showing in your app. They're made up of triggers that you choose (such as content rating, title, or category). 

For example, if you've developed a family-friendly game, you can create rules with triggers that will flag ads based on content rating (Adults only 18+, Mature 17+, Teen). When an ad violates this rule, it'll be flagged and you'll be notified by email.

A list of all the creatives that have violated your rules can be found on the Notifications page. Click through to view the creative and essential details so you can report them to the relevant networks. 

Prerequisites
Prerequisites

Ensure that you've integrated the Ad Quality SDK into your app.

Follow these guides on how to set up the SDK:

Create a rule
Create a rule

To create a rule, complete the following steps:

  1. In the left navigation menu, select Rules.
  2. In the upper-right corner of the page, select Create rule.
  3. On the Manage rules page, select Create rule.
  4. In the General section:
    1. Input what you want to call the rule 
    2. Select which apps the rule will apply to. By default, all apps are selected
    3. Select the the countries you want the rule to apply to. By default, all countries are selected
    4. Choose the severity of the rule. By default medium is selected by default (mandatory) 
    5. Add the email addresses that will be notified once an ad has violated your rul
  5. In the Notifications section:
    1. Choose if you want to be notified on the advertiser level or on the creative level.  If you choose Advertiser, you will receive an email with all the advertisers that violated the rule, or you can choose to get a list of all the creatives that violated the rules.
    2. Input the email address that you want to receive the violated rule notification 
    3. Select the the fields that you want included in the email. The options include:
      • Title
      • Developer
      • Android package name/iOS App Store ID (CSV upload available)
      • Bad UX patterns
      • Ad Quality creative ID 
      • Ad source creative ID
      • Ad source campaign ID
      • Platform
      • Ad Source
      • DSP
      • Ad unit
      • Impressions 
      • Last seen
      • Notification trigger 
  6. In the Trigger section, select Add trigger. The list of available trigger types will be based on whether you selected Advertiser or Creative in the Notifications section.
    • If you selected Advertiser, the following trigger types are available:
      • Title
      • Developer 
      • Android package name
      • iOS App Store ID
      • Website
      • US content rating (App Store)
      • US content rating (Google Play)
      • UX patterns
      • Ad Quality Creative ID
    • If you selected Creatives, the following trigger types are available:
      • UX patterns
      • Ad Quality Creative ID
  7. Select the networks that you want this trigger to apply to and then set the impression threshold. By default, all networks are selected and the impressions threshold per network is set at 10. 
  8. Optional: You can add more triggers for the same rule by selecting Add Trigger again. You can choose whether the notification should be triggered if it violates both trigger types by selecting AND, or if it violates either trigger by selecting OR.

Rules
Rules

On the Manage rules page, you can review any of the rules on the system.

There are three types of rules:

  • Custom: Rules you have set according to the process detailed in the preceding section.
  • Default: Rules that are pre-created by the system.
  • Reported: Rules that were auto generated by the system when you have reported a creative on other pages on the platform.

You can edit or disable any of the rules. By default you will see only the active rules and you can use the filters on the top to change the selection.

The table displays information on who created each rule, when the rule was created, and the main configuration of the rule.

Notifications
Notifications

On the Notifications page, you'll see a graph that enables you to visualize rule violation trends according to the metric and breakdown you choose. 

The following metrics are available:

  • Notifications
  • Impressions

You can breakdown the data by using the following information: 

  • Rule name (default)
  • App
  • Advertiser 
  • Developer
  • Country
  • Ad network
  • Ad format
  • Rule type
  • Platform
  • Category
  • Content rating
  • Severity

You can also filter the list by using the following information: 

  • Notification info
  • Rule name
  • Read / Unread
  • Severity
  • Rule type
  • Rule level
  • General 
  • Platform
  • App
  • Ad format
  • Ad network
  • DSP
  • Country
  • Advertiser info
  • Title
  • Developer

To export your notifications list as a CSV file, select Export at the top of the page. The CSV file will contain all the information available on the Notifications page according to the filters and date range you selected.

For an overview of a notification, select an app name or select the edit button at the end of the row and then select Notification overview to get more information about the ad that violated a rule. 

To review all of the creatives that are in-use by an advertiser, select Review all creatives. All creatives will be displayed as a list with in-depth metrics. If you see a problematic creative, you can report the creative to the ad source.