Referer templates

In each banner request, Adfox receives a page address called a referer.

This referer is then matched to the page templates configured for site sections with the Dynamic definition by REFERER option enabled, or to templates specified in URL-based targeting.

You cannot simultaneously specify different template types for the same object.

Organization <standard>

• The * symbol stands for a sequence of any characters of any length.
• You can only specify one template per line, a total of 30 lines are available.

The standard template type works well for sites with a simple structure. For example, there is a website like www.website.com with a logical structure of three sections specified in Adfox: Home page, News, and Everything else. The user can open the home page by typing one of the following in the browser's address bar:

website.com 
www.website.com 
http://www.website.com 
http://www.website.com/index.html

You can either list all possible options line by line or use templates:

*website.com
*website.com/index.html

The News section template looks like this:

*website.com/news/*

The Other section template is as follows:

*

The sections thus represent different pages of the site.

Organization <POSIX.2>

In this type of templates, you can use characters from POSIX regular expressions.

The template type is used for highly branched site structures, for example, with multiple home pages (a common case: separate home pages for specific cities) or when it's impossible to describe the structure using a standard template type.

Here's a POSIX.2 template for home pages of www.website.com:

.*(((website.com|www.website.com)/{0,1})|((website.com)/(index.html)/{0,1}))$

• .* Any set of characters. If you don’t specify start or end characters, the string by default begins and ends with .*, so you don’t have to add .* at the beginning or end of the template.
• ^ The beginning of the string (if the beginning of the string is not specified, the URL may contain any characters at the beginning, that is, by default, the string starts with .*).
• $ The end of the string (if the string is not finished, the URL may contain any characters at the end, that is, by default, the string ends with .*).
• | The OR condition.
• () We wrap each option in brackets.
• \ Escaping special characters with a backslash (characters that are used when writing a POSIX expression, for example, ? or .).
• /{0,1} the {0,1} construct means that the character preceding it may occur 0 or 1 time.

Example POSIX.2

homer-simpson-tv\.blog4ever\.com|forum\.rojadirecta\.org|^hidan\.eklablog\.com.*|^aniworld\.spb\.com\/.*\/adfox\/.*s$

Let's analyze a template in parts and see why these examples are suitable:

• homer-simpson-tv\.blog4ever\.com

  http://homer-simpson-tv.blog4ever.com/?a=1212: There is no start or end character at the beginning or end of the template, and, by default, a string may have any set of characters at the beginning and at the end.

• forum\.rojadirecta\.org

  https://www.forum.rojadirecta.org/?b=123: There is no start or end character at the beginning or end of the template, and, by default a string may have any set of characters at the beginning and at the end.

• ^hidan\.eklablog\.com.*

  hidan.eklablog.com/?b=123: The string starts with a start-of-string character, so the URL can't begin with any other characters. However, any construct may be used at the end of the string, after .com.

• ^aniworld\.spb\.com\/.*\/adfox\/.*s$

  aniworld.spb.ru/123/adfox/s: There are limiting characters at the beginning and at the end of the string. However, after .ru, there may be any construct that is allowed by .*.

How to check whether the page templates for the site sections are set up correctly

You can determine which section a site page belongs to, if Adfox site-level ad codes are installed on it:

1. Copy the URL of the site page that you want to check.
2. In the Adfox interface, go to the Inventory tab. Select the site where you want to check the section settings.
3. In the Sections tab, paste the site page URL in the Template URL box and press Enter.

The system shows the section that the site page URL currently belongs to according to the available page templates.

Contact support

Send an email