Override Lists allow you to modify specific parameters in outgoing ad requests based on predefined conditions.
Each Override List consists of two main components:
- Match by fields - the request parameters used to determine when an override rule should apply (e.g., Source ID, Country, Domain).
- Override fields - the outgoing request parameters that should be replaced, inserted, or cleared when the conditions are met.
When an incoming request matches the configured conditions, the system automatically applies the specified override values to the outbound request.
This allows you to customize request parameters without modifying your original integration setup.
Step-by-Step Guide
1. Creating a New List
Navigate to Global Lists → Override List → Create.
- Give your list a name
- Select Match by fields such as
Source ID - Choose the corresponding Override Fields, e.g., an
AdTag ID - Click Create
2. Populating the List
After creation, open your list by clicking its name. You can populate it in one of the following ways:
Download a CSV Template and fill in the values
Upload an existing Override List using the Upload button
Or manually add a single entry using the Add new item button
3. Configuring an Override Rule
Click Add override rule to configure a new entry.
The rule settings are divided into two sections:
Conditions
Define the values that must match in the incoming request for the rule to apply.
For example:
Source ID = 111111
Override values
Specify the values that should be applied to the outbound request when the conditions are met.
For example:
AdTag ID = xxxx
Click Save to create the rule.
How it works:
If an incoming request matches Source ID = 111111, the system will insert or replace the outgoing AdTag ID with xxxx.
The configured rule will appear in the list with a Rule Summary, allowing you to quickly review its conditions and resulting overrides.
For example:
If Source ID = 111111 → override AdTag ID = xxxx
You can edit or delete existing rules using the corresponding actions.
4. Availability and Targeting
Once at least one entry is added to the list, it becomes available for selection at the Source and Campaign level.
On the Campaign level, targeting by Override List is hidden by default. You can find it under Add Targeting → Advanced Settings.
5. Mass Action
To apply in bulk:
Open the desired list.
Go to the Mass Actions tab.
Click Add.
4. Select the relevant sources or campaigns from the drop-down menu.
5. Click Save.
The list has now been successfully attached to the two selected sources.
Empty Values
In some cases, you may want to override a parameter by removing its value completely.
To do this, simply leave the Value field empty when creating or uploading the Override List entry.
This allows you to override parameters (such as genre, or other fields) with no value, effectively preventing any value from being sent in the outbound request.
Override for All Requests
If you want to apply an override to all ad requests, you can do this without setting any Key (condition).
Simply:
- Create an Override List without a Match by field
- Add override rule
- Attach it to a Source or Campaign
In this case, the system will apply these 2 parameters to every outgoing request, regardless of any parameters.
This is useful when you want to enforce a fixed parameter (e.g., Video placement) across all traffic.
________________________________________________________________________________________________________________
Supported Keys
| Match by field | Override fields |
|---|---|
| Domain / Bundle | Website domain or app bundle |
| Source ID | Unique identifier for the source |
| Geo | Country code (ISO 3166-1 alpha-2, e.g., US) |
| Width | Player/ad slot width |
| Height | Player/ad slot height |
| Channel ID | Unique ID on your account (Channels tab) |
| Device Type | Device type (dropdown available) |
For the Geo match, use standard ISO 2-letter country codes (e.g.,
US).
For the Device match, a dropdown menu is available when adding an item. You can also select Any, which applies the override to all device types.