Override Lists allow you to modify specific parameters in outgoing ad requests based on defined conditions.
Each rule consists of two parts:
- Key - the condition that must be met (e.g., Source ID, Country, Domain)
- Value - the new value that will be applied when the condition is met
When a request matches the Key, the system will replace or insert the specified Value in the outbound request.
This helps you control and customize request parameters without changing the 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 a Key such as
Source ID - Choose the corresponding Value, 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. Example
Suppose you create a rule where:
Key =
Source ID→11111Value =
AdTag ID→xxx
Every time a campaign with this Override List receives a request from Source ID11111, the system will insert or overwrite theAdTag IDwithxxxin the outbound request.
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 Key (condition)
- Add new item
- Attach it to a Source or Campaign
In this case, the system will apply the specified Value 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
| Key | Description |
|---|---|
| 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 key, use standard ISO 2-letter country codes (e.g.,
US).
For the Device key, a dropdown menu is available when adding an item. You can also select Any, which applies the override to all device types.