Filtering Offers by Country
Who is this for: Partners who review their offers by market and want to see which offers can run in a given country, state, city or zip code.
Outcome: Use the Country filter on the Offers page to list offers by their country targeting, narrow the United States by region, and share the filtered view with your team.
Overview
Every offer in MomentScience targets countries in one of two ways. A whitelist lists the countries where the offer can run. A blacklist lists the countries where it can't. For the United States, an offer can also be narrowed to states (with optional cities) or to zip codes.
The Country filter on the Offers page reads that targeting. You choose which kind of list to search, pick one or more countries, and, for the United States, narrow by region. The list then shows only the offers that match.
Opening the Country Filter
- Log in to the MomentScience dashboard.
- From the sidebar, click Offers.
- In the filter bar above the offers table, find the Country control. It sits at the end of the second row of filters.
The Country control has two parts: a match mode on the left and a country picker on the right.
Choosing a Match Mode
The match mode decides which list the filter checks. Only one mode can be active at a time.
Match mode | Returns offers that |
|---|---|
Whitelisted in (default) | have any of the selected countries on their whitelist |
Blacklisted in | have any of the selected countries on their blacklist |
Either list | have any of the selected countries on whichever list the offer uses |
When you select more than one country, an offer only needs to match one of them. For example, Whitelisted in with United States and Canada returns offers that whitelist either country.
Selecting Countries
- Click the country picker and start typing a country name.
- Select the country from the list. It appears as a chip in the control.
- Repeat for any other countries.
- Click Apply.
You can only pick countries from the list. Text that doesn't match a supported country can't be added.
Narrowing the United States by Region
When United States is one of your selected countries, region options appear right after the Country control. They don't appear for any other country, because offers can only be targeted below country level in the United States.
Choose one region type:
- States & Cities: enter two-letter state codes, such as CA or NY. After you add a state, a city box for that state appears. Type a city name and press Enter or type a comma to add it as a chip. Click × on a chip, or press Backspace in an empty box, to remove it.
- Zip Codes: enter 5-digit zip codes, separated by commas.
Only one region type can be active at a time. If you switch types after entering values, you're asked to confirm, and the values for the other type are cleared.
The region narrows the match mode you picked. For example, Whitelisted in United States with state CA returns offers whose whitelist includes the United States narrowed to California. If you leave the region empty, the filter matches at country level only.
Invalid entries are rejected as you type, with a message naming the value. For example, "9021" is not a valid 5-digit zip code and is not added. A rejected value never affects your results.
Removing United States from the country picker also removes its region values.
Offers With No Whitelisted Country
If an offer's whitelist doesn't name any country, the Offers list, the offer details page and the offers export show it as Whitelist: United States, along with any blacklist the offer has.
These offers appear when you filter Whitelisted in United States. They don't appear for Whitelisted in any other country.
Applying, Resetting and Sharing Filters
- The list updates only when you click Apply. If you change the filter without applying it, a "Filters changed, not applied" note appears next to Apply.
- Apply stays disabled until at least one filter is set.
- Reset clears the country, match mode and region together and returns the full list. You stay on the same tab.
- Your applied filter stays in place when you switch tabs or reload the page.
- Copy the page URL to share the exact filtered view. Anyone with access who opens the link sees the same filters applied.
- If no offers match, the list shows "No offers match the selected country filters" with a Reset Filters link.
- Exporting while a filter is applied exports exactly the offers in the filtered list.
[Screenshot: Offers page filter bar with Whitelisted in selected, United States chosen, States & Cities active with CA and NY entered, and city chips under CA]
If you have questions about country targeting on your offers, contact us at [email protected].