Filters

How do filters work?

Each visitor is checked by all filters whether it satisfies the criteria of all the filters at once. In other words, condition OR between values of a filter and AND between filters.

Filters are terms complying with which a visitor can get into the stream.

Read the full article in our blog.

AND/OR

If you choose «AND», a user can get to this stream only in case all filters are met. E.g. there are filters Operational System: iOS, country: the Czech Republic, language: English, and all these filters are connected with «AND», only users with ALL these conditions complied can get to the stream. That means, if the visitor uses the iOS device, from Czech but with a Russian language browser, he won’t get into this stream. Language filter won’t allow this visitor to a stream.

If you choose «OR», a visitor will get to a stream if at least one of the filters is compiled, e.g. an iOS device, or a click from the Czech Republic, or English as a language.

IS/IS NOT

Filters also have «IS» and «IS NOT» attributes.

IS (allow) means that click should have this feature, e.g. if we set up iOS filter, that means only clicks from iOS devices will get to this stream.

IS NOT (except) means only a click without this feature will get to a stream, e.g. we set up iOS filter IS NOT, that means a click with any operational system EXCEPT iOS will get to a stream.

Filters Description

Date between

Allows to set up dates and time zones when the stream will be enabled or disabled («IS» – the stream is enabled on these dates, «IS NOT» – the stream is disabled).

Timetable

Allows creating a timetable of streams work on days of the week, time and time zones. («IS» – the stream works on this time, «IS NOT» – the stream doesn’t work).

Limit clicks

This filter limits stream’s job with a certain number of clicks. The number of clicks can be limited per hour, per last 24 hours, or total. When the limit of clicks is reached, the stream is switching off.

Parameter

Parameter filters clicks based on a received parameter. Masks, regular expressions and @empty meta-word for empty parameters are supported. The filter works as a strict coincidence. If you need partial coincidence use masks or regular expressions («IS» accepts clicks WITH parameters to the stream, “IS NOT” accepts clicks WITHOUT parameters).

Referrer

Referrer restricts clicks based on their referrer. Masks and regular expressions are supported. The filter works as a strict coincidence. If you need partial coincidence use masks or regular expressions. Example of a masks' usage: *google.com* for http://google.com/search?q=123 referrer («IS» accepts clicks WITH referrers to the stream, “IS NOT” accepts clicks WITHOUT, EXCEPT referrers).

Site

Site filters clicks based on a site from referrer or from source, utm_source parameters. Masks and regular expressions are supported («IS» accepts clicks FROM mentioned sites to the stream, “IS NOT” accepts clicks NOT FROM mentioned sites).

X-Requested-With

X-Requested-With restricts clicks based on their x-requested-with header. Regular expressions are available. Example: /value (a|b|c)/. («IS» accepts clicks WITH headers to the stream, “IS NOT” accepts clicks WITHOUT, EXCEPT mentioned headers).

Keyword

Keyword filters clicks based on their keywords. Masks, regular expressions and @empty meta-word for empty keywords are supported. Filter works as a strict coincidence. If you need partial coincidence use masks or regular expressions. («IS» accepts clicks WITH mentioned keywords to the stream, “IS NOT” accepts clicks WITHOUT, EXCEPT mentioned keywords).

Search Engines

Search Engines filters clicks based on search engines. Masks and regular expressions are supported («IS» accepts clicks FROM mentioned search engines to the stream, “IS NOT” accepts clicks NOT FROM mentioned search engines).

Ad Campaign ID

Ad Campaign ID filters campaigns based on their advertising campaigns IDs. Masks and regular expressions are supported («IS» accepts clicks FROM mentioned advertising campaigns to the stream, “IS NOT” accepts clicks NOT FROM mentioned advertising campaigns).

Creative ID

Creative ID filter. Masks and regular expressions are supported («IS» accepts clicks FROM mentioned creative IDs to the stream, “IS NOT” accepts clicks NOT FROM mentioned creative IDs).

Empty referrer

Empty referrer filter. («IS» accepts clicks WITH empty referrer to the stream, “IS NOT” accepts clicks WITHOUT, EXCEPT empty referrers).

Proxy detected

Proxy detected filter. Proxy servers usually add their headers which allow to define the usage of proxy. («IS» accepts clicks WITH proxy headers to the stream, “IS NOT” accepts clicks WITHOUT, EXCEPT proxy headers).

City

Cities are written in English. You can either choose a city from a list or enter the city’s name manually. There are only cities with more than 500k people on the list. («IS» accepts clicks FROM mentioned cities to the stream, “IS NOT” accepts clicks NOT FROM mentioned cities).

States/Regions

Selection from the listing is available. State/regional codes differ in every Geo database. So if you change a database, you need to set up regional filters once again. («IS» accepts clicks FROM mentioned regions to the stream, “IS NOT” accepts clicks NOT FROM, EXCEPT mentioned regions).

Country

Selection from the listing is available. For a quick input make a list of countries’ codes with a space, e.g. «RU US KZ». («IS» accepts clicks FROM mentioned countries to the stream, “IS NOT” accepts clicks NOT FROM, EXCEPT mentioned countries).

IP

IP — ip-addresses filter. Masks, intervals and CIDR are supported, e.g. 22.33.1-44.*, 22.33.44.10-22.33.44.20, 22.33.1.0/24 («IS» accepts clicks WITH mentioned IPs to the stream, “IS NOT” accepts clicks WITHOUT, EXCEPT mentioned IPs).

IPv6

IPv6 — next generation ip-addresses filter. («IS» accepts clicks WITH IPv6 to the stream, “IS NOT” accepts clicks WITHOUT, EXCEPT IPv6).

Mobile operator

Mobile operator can be chosen only from the list of available operators. («IS» accepts clicks FROM mentioned operators to the stream, “IS NOT” accepts clicks NOT FROM, EXCEPT mentioned operators).

ISP

Works if IP2Location ISP Database is available.

Uniqueness

Uniqueness checks the visitor’s uniqueness. A visitor can be unique: a) for a stream – a visitor is unique in the current stream; b) for a campaign – a visitor is unique for a whole campaign; c) for all the campaigns in a tracker. A click becomes unique again after a period set in a campaign’s settings. The period is calculated since the very first visit («IS» accepts unique clicks, «IS NOT» accepts NOT unique clicks).

Bot

Bot is a filter based on our database of bots. («IS» accepts bots to the stream, «IS NOT» accepts NOT bot to the stream).

Connection Type

Connection Type filter is available if there’s a database integrated. Supported types – Dialup, cable/DSL, corporate and mobile network. If there’s no database, only Cellular and WiFi are available. If Maxmind Connection Type Database is available, there are the following options: Dialup, cable/DSL, corporate and cellular network. If there is no database, the available ones are “Cellular” and “Wifi”.(«IS» accepts clicks WITH mentioned connection type to the stream, “IS NOT” accepts clicks WITHOUT, EXCEPT mentioned connection type).

Browsers

Browsers. You can either choose a browser from a list or enter the browser’s name manually. Masks and regular expressions are supported. («IS» accepts clicks FROM mentioned browsers to the stream, “IS NOT” accepts clicks NOT FROM mentioned browsers).

Browser Version

You can add a browser version here. («IS» accepts clicks FROM mentioned browser versions to the stream, “IS NOT” accepts clicks NOT FROM mentioned browser versions).

Device Model

Device Model filter. You can either choose a device model from a list, or enter the device model manually. Masks and regular expressions are supported. Filter is not strict, which means you can enter «iPhone» for iPhone 5, 6, 6 Plus and others («IS» accepts clicks FROM mentioned devices to the stream, “IS NOT” accepts clicks NOT FROM mentioned devices).

Device Type

Supported types – desktop computer, mobile phone, tablet, gaming console, TV, car browser, smart display, camera, portable media player, and unknown. («IS» accepts clicks FROM mentioned devices to the stream, “IS NOT” accepts clicks NOT FROM mentioned devices).

Operational System

You can either choose a device model from a list, or enter the device model manually. Masks and regular expressions are supported («IS» accepts clicks made WITH devices with mentioned OS to the stream, “IS NOT” accepts clicks made NOT WITH devices with mentioned OS).

OS Version

OS Version filter. («IS» accepts clicks made WITH devices with mentioned OS version to the stream, “IS NOT” accepts clicks made NOT WITH devices with mentioned OS version).

UserAgent

Masks and regular expressions are supported. Filter works as a strict coincidence. If you need partial coincidence use masks or regular expressions. («IS» accepts clicks WITH mentioned user agents to the stream, “IS NOT” accepts clicks WITHOUT, EXCEPT mentioned user agents).

Languages

Languages filter on browser languages. («IS» accepts clicks WITH mentioned languages to the stream, “IS NOT” accepts clicks WITHOUT, EXCEPT mentioned languages).

Sub ID 1…15

Sub ID 1…15 are filters on received parameters sub_id_1..15. If there’s a Source in a campaign, the name of the source parameter will be added to a filter’s name. («IS» accepts clicks WITH mentioned sub_ids to the stream, “IS NOT” accepts clicks WITHOUT, EXCEPT mentioned sub_ids).

Mask Usage

Examples:

  • 168.102.233.* — addresses from 168.102.233.0 to 168.102.233.255;
  • 168.102.233.22? — addresses from 168.102.233.220 to 168.102.233.229;
  • 168.102.233.100-150 — addresses from 168.102.233.100 to 168.102.233.150;

Symbols:

  • * — any numbers;
  • ? — any single number;
  • - — interval.

Interval Usage

Example:

  • 168.102.233.100 - 168.102.233.150 — addresses from 168.102.233.100 to 168.102.233.150.

CIDR Usage

Example:

  • 192.168.2.0/24 — addresses from 192.168.2.0 to 192.168.2.255.

To convert intervals into CIDR or vice versa, use the online service http://www.ipaddressguide.com/cidr

How to import list of IPs?

Split list with symbol “;” and paste to filter. Example of list: 1.2.3.0;2.2.2.0;5.2.3.0

How to add a list of keywords?

Switch filter to 'textarea' and paste the list:

keyword1
keyword2
...

How are masks used in filters?

Add the * (asterisk) symbol to the phrase you are searching to turn on any content at this part of the phrase.

Examples:

  • *keyword — any content before “keyword”;
  • keyword* — any content after “keyword”;
  • *keyword* — any content both before and after “keyword”;
  • keyw*d —any content between the words;

How are empty values searched for?

Use the meta-word “@empty” (without quotation marks)

How are regular expressions used in filters?

Regular expressions should be wrapped in slashes. Example: /pattern[0-9]+/. Only PCRE regular expressions are supported Compatible Regular Expressions).

The filter X doesn’t work. Why?

First of all, make sure you know exactly what filter rejects users.

  1. Go to the page “Campaign> Additional> Traffic Simulation”
  2. Fill in user’s IP, UserAgent and other parameters if needed.
  3. Put “1” as a number of Requests.
  4. Launch simulation and see the log output. There you’ll find the exact filter, that blocked the request.