Ads on websites

Site structure

A site is an object in the Adfox system where ad campaigns are placed. There are sections with a set of placements on the site. In Adfox terminology, for example, adfox.yandex.ru is a site.

A site section is part of a site that's logically distinct in terms of topic, method of selling banner placements, subdomain, or any other characteristic. For example, a site may have the following sections: Home, News, and About. You can usually distinguish site sections by the URL mask.

Sections allow you to select different sets of placements on pages of the same site and serve different ad campaigns.

Placements are where you place banners on a site page. A placement is determined by banner type and location.

Add a site, section, and placement

Note

If you plan to place ads on a site under a contract with an advertiser or agency to display them in Russia and transfer data about these ad impressions to the Russian state register (ERIR) through the Yandex advertising data operator, then, before adding the site, enter information about the contractor (site owner) in the Marking tab. For more information, see How to register creative content in Adfox.

Add a site
  1. Go to the Sites tab in the main menu.

  2. Click + Add and specify the settings of the new site.

  3. If necessary, enable the Transfer the site to the ERIR option and fill in the fields under Marking:

    • Placement type: Website, app, or information system.
    • Name: Website name to be added to the ad register.
    • Site URL: Website or video resource domain, blog URL, or URL for downloading an app that starts with http:// or https://.
    • Contractor: Contractor (domain, video resource, blog, or app owner) that you added in the Marking tab earlier.
  4. Save the site.

Add a section

Sections are created based on the ad placement logic:

  • If ads are sold with placement on the entire site, you can create just one section: All pages.
  • If you need to place ads on certain site pages, we recommend that you add multiple sections based on the site structure, for example: Home, News, and Cars.

Note

It's best to add placements after creating all the sections. If you want to use the same placements in different sections, you don't have to create them manually. You can create one, and then use the copy function.

  1. In the Sites tab, find the desired site and click Sections. In the window that opens, click Add.

  2. Specify the new section parameters:

    • Name.

    • Category.

    • Dynamic definition by REFERER.

      Note

      For codes received from the site level, sections with the Dynamic definition by REFERER option disabled are excluded from the search for a suitable URL mask.

    • Template type:

    • Allowed page URLs: Specify the page URL masks according to your selected template type that determine whether the site pages belong to this section.

      Alert

      You can't specify the same page templates for different site sections.

    • Excluded page URLs: Specify the page templates that shouldn't belong to this section.

To check whether you set up the URL templates correctly

1. Copy the URL of the site page that you want to check.

2. In the Adfox interface, go to the Sites tab and select the site where you want to check the section templates.

3. In the Sections tab, insert the site page URL in the URL by template box and click Find.

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

Add a placement

Once the section is created, a tab will open where you can add a placement. If you need to open the tab for a previously created section, click Placements next to the section name.

Specify the placement parameters:

  • Name: Enter the ad placement name.

  • Category: Specify a permanent category for collecting statistics on impressions in certain site content categories.

  • Banner type: Determines the placement type to be added. Only the banners that you add with the same banner type are displayed on this placement.

  • Code type: Use this setting to allow serving particular ad campaign types on this placement. Acceptable values:

    • from request URL (default): The code type is determined by the parameter value obtained from the URL of the banner request. If the value isn't passed in the request, the placement is considered to have the “regular” code type by default.

    • regular: Banners from all ad campaigns can be served, except for session campaigns. If multiple ad tags are installed on a site page for this placement, that page may have duplicate banners and campaigns.

    • unrepeatable banners: Multiple ad tags are added to the site page for this placement. Based on their requests, a corresponding number of banners is selected, except in session campaigns. Banners can be selected from one ad campaign or from different ones.

      What unrepeatable banners look like

      For example, this is what ads served across three ad tags from a single unrepeatable banners placement might look like.

    • Session on page: Banners from session campaigns can be selected for impressions and have priority over regular campaigns. If there are no session campaigns to be served, a regular ad campaign is selected.

    • unrepeatable campaigns: Multiple ad tags are added to the site page for this placement. Based on their requests, a single banner per ad campaign is selected, except for session campaigns. Only one banner from one ad campaign can be displayed per page load.

      Note

      If there are more ad codes than the number of ad campaigns placed on the placement, the system displays as many banners as there are ad campaigns.

      Example

      Four ad campaigns are running on the placement, each containing multiple banners, and five ad tags are installed on the page. In this case, one banner from each campaign is served for the first four ad tags, and a placeholder is shown in response to the fifth tag.

  • Position: Determines the logical location of the placement on the section pages. If you add multiple placements with the same banner type to one section, use a unique position for each placement (this means that you can't add two placements with identical Banner type and Position parameters to one section).

    Alert

    After saving the placement, you can't change the Position parameter.

  • Number of impressions per period: Control the number of impressions across all ad campaigns served on the placement for a unique user.

    • Number of impressions per period: Number of banner impressions on this placement.

    • For period. Acceptable values:

      • from request URL (default): The impression limit settings from the banner request's URL parameters are used. If no values are passed in the request, the placement is considered to have no limits.
      • no limits: Banner impressions on this placement aren't limited even if the request parameters specify otherwise.
      • 1 hour/6 hours/12 hours/24 hours: The limit is valid for 1/6/12/24 hours after the banner is first served to a unique user.
      • others: You can set your own time period for the impression limit in minutes.
    • Other period (minutes): You can set your own time period for the impression limit in minutes.

    How impression limits work

    Let's set a limit of three impressions per hour.

    When the banner is shown to a unique user, the limit period begins. When the number of impressions within the set period (one hour) reaches the limit (three impressions), this placement stops banner impressions for the unique user until the period expires.

    Note

    To enable the Number of impressions per period setting, contact support.

    The impression limit applies for all ad campaigns placed on this platform. If you selected the by event impression count method, banner ad responses are limited.

Click Add.

Add placements for a site with an adaptive layout

A site with an adaptive layout is a site that has a stable HTML layout with CSS styles to help display it in different screen resolutions. An adaptive layout makes the site easy to view on various devices: mobile phones, tablets, and desktops.

Adfox supports three layout options: for mobile phones, tablets, and desktops.

The set of ad placements on each version may differ, for example:

  • For phones: A stretching banner.
  • For tablets: A stretching banner and a 100 x 100 banner.
  • For desktops: A stretching banner and a 240 x 400 banner.

In this case, you need to create custom nondimensional banner types for each layout version in the Adfox interface. Then, create a site and sections and add 5 placements to each section (a stretching banner for phones, a stretching banner for tablets, a stretching banner for desktops, a 100 x 100 banner for tablets, and a 240 x 400 banner for desktops).

Next, get 5 ad tags with the “adaptive” code type.

Each ad tag only requests a banner in the suitable layout version.

Contact support

Send an email

You can use categories to:

  • Group sites, sections, or placements by topic and get statistics on impressions and clicks for the entire category.
  • Mark up the audience for targeting by behavior.