Adfox placement on Turbo pages

A Turbo page is a special web page format that loads faster. Turbo pages include essential elements, such as text, images, and videos, but almost nothing else, which enables them to load quickly. With Turbo pages, your site users save on their online traffic and load your site content faster.

Turbo page content is cached on Yandex servers and is loaded along with search results. The browser automatically builds Turbo pages using a universal template: it fetches the site logo, an illustration, the full text of the page, an ad unit, and additional materials. Learn more about Turbo pages

Publishers who own Turbo pages can use Adfox to monetize their Turbo page content by placing direct ads, ads from third-party monetizers, and ad units from the Yandex Advertising Network.

The initial setup includes several steps:

  • Add a site, sections, and placements.
  • Get ad tags and install them in Yandex Webmaster.

Now you can add campaigns with banners and enable monetization.

For setup details, see the sections below.

Step 1. Connect to Adfox

  1. If you have a Yandex ID, use it. If you don't have a Yandex ID, register.
  2. Go to the Yandex Advertising Network interface, click the Join button, and fill out the form. Learn more about filling out the form

After you submit the form, you get access to the Yandex Advertising Network and Adfox interfaces.

When you sign up for an Adfox account, you get administrator access. The administrator has a full set of rights to manage account settings. They can also create users and manage their access rights.

Step 2. Add the site structure

Note. If you plan to place ads on a site under a contract with an advertiser or agency to display ads in Russia and transfer data about these ad impressions to the Russian state register 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 Transferring data to the Yandex advertising data operator and getting a token.
Add a site
  1. Go to the Sites tab in the main menu, click Add, and specify the site name.
  2. Click Add.
  3. If necessary, fill in the fields under Marking:
    • Name: Name of the site to be added to the ad register.
    • URL: Site or video resource domain, blog URL, or URL for downloading an app.
    • Placement type: Site, app, or information system.
    • Contractor: Select a contractor (site owner) from those you added earlier in the Marking tab.
Add a section

Site sections usually reflect the structure of the site menu, and you can use a URL mask to combine pages under the same menu item.

We recommend that you add one section for Turbo pages.

  1. Click the Sites → Your site → Sections tab, then click Add (after you add a site, you are automatically redirected to adding a section).
  2. Specify the settings:
    • Section name.
    • Page templates: Enter * (asterisk).
  3. Click Add.

If you need to add multiple sections, see the instructions for referer templates.

Add placements

The standard sizes of the ad unit for the mobile version of the site: 300 × 250 and 300 × 300. If you select banner types that have fixed sizes, the placement is cropped.

To place larger banners or adaptive banners, use the 100% × 100% Turbo banner type with flexible sizes.

For each unit in the Adfox interface, inside the site section, add a placement characterized by the banner type and position.

Banner type: Determines the ad unit size. By default, the following types of banners supported by Turbo pages (their names include Turbo) are enabled in the account:
  • 300 × 250 Turbo
  • 300 × 300 Turbo
  • 100% × 100% Turbo
  • 100% × 250 Turbo
  • 100% × 300 Turbo
  • Interscroller Turbo
Note. You can't add your custom banner types for placements on Turbo pages.

Position: Ensures a unique look-and-feel for the placement. For example, you can add several placements with one banner type and give each one a different position.

Three positions have already been added to the account, so you can create three placements with the same banner type and different positions. If you need more positions, add new positions.

  1. To add a placement, go to the Sections tab of your site and click , then Add.
  2. Specify the placement settings:
    • Name: Enter a name for your ad unit.
    • Banner type: Select a banner type with Turbo in its name. Only the banners that you add with the same banner type are displayed on this placement.
    • Position: Specify the position of the placement.
    • Code type: Asynchronous.
  3. Click Add. Add as many placements as you have on your Turbo page.

Step 3. Get the ad tag

  1. Go to the Sites → Your site → Ad tag tab.
  2. Enter the Banner type and Position settings from the placement created in the previous step, then click Show.
  3. Copy the code (ad tag), beginning from the div element.
Attention. Make sure that you use the placement's ad tag with the Turbo banner type only on mobile Turbo pages. For the regular version of the site, add a placement with a regular banner type, without a Turbo label.

Step 4. Install the ad tag

Select a position type for your page:

Managing ad codes in the Yandex Webmaster interface. You don't have to make any changes in the RSS file. Ads on Turbo pages are placed automatically.
  1. Go to the Yandex Webmaster → Turbo pages → Settings → Advertising interface.

  2. Select Automatic ad placement.

  3. Under Ad blocks in content, click Add.

  4. Select the Adfox ad unit type and enter the ad tag.

  5. If you selected multiple ad units, arrange them by their impression priority using the  icon. The order will be taken into account when placing ads.

  6. Save your changes.

The service will place ads on the page using a special algorithm. For example, the ad unit is not placed on the first viewable screen, next to videos or images. Some ad units might not be used. The number of ad units used depends on the page length.

You don't have to make any changes to the RSS file in this case (the turbo:adNetwork element with the contents and the figure element with the data-turbo-ad-id attribute aren't needed in RSS).

Step 5. Add campaigns and banners

Before adding your first campaign, create an advertiser.

The advertiser will get credentials (login and password) to access statistics of campaigns where they are specified as an advertiser.
Note. If you're creating a campaign under a contract with an advertiser or agent to place ads for display in Russia and plan to report these ad impressions to the Russian state register through the Yandex advertising data operator, then before creating a campaign, specify data about the contractors and the contract with the end advertiser in the Marking tab. For more information, see Transferring data to the Yandex advertising data operator and getting a token.

5.1 Add a campaign

  1. Go to the Campaigns tab and click Add.
  2. Set the campaign settings. The minimum required set of features is enabled in the account by default. If you need advanced settings, please contact support.
  3. After the campaign is added, the Placement tab opens. Select the site, section, or placement where you want to place the campaign and click Save.

5.2 Add a banner

Before adding a banner, prepare your advertising materials.

Not all banner formats can be used on mobile Turbo pages, only those listed below. The format name contains a link to the technical requirements for ads and describes the rules for adding them to the Adfox interface.

Choose your campaign format and prepare your ads by following the requirements.

  • Banner HTML5: Use it to load banners with HTML5 code (those might be ad tags created in specialty editors or third-party ad tags).
  • Banner Image: A banner that displays an image with a link.
  • Banner Slider: A banner that displays an image slider.
  • Adfox code forwarding: Lets you add the Adfox ad tag to the banner.
  1. Go to the Banners tab and click Add.
  2. Select the banner type that is labeled Turbo and meets the size of the placement where you are going to place the banner.
  3. Select the ad format.
  4. Specify the banner settings, upload the advertising materials that you prepared, and click Add.
  5. If necessary, add the automatic “Ad” label and indicate the advertiser.
  6. If you chose to Submit data to state register at the campaign level, add the creative data in the Settings for Russian ad register section. For more information, see Transferring data to the Yandex advertising data operator and getting a token.
  7. Click Add.

You can set up targeting for your campaign or banner if you want.

This completes the basic settings, so you can check your banner on your Turbo page.

After that, add advertising campaigns and banners, and set up monetization.

Step 6. Enable monetization

You can use Monetization for placements with Turbo pages.

6.1 Enable Yandex Advertising Network monetization

  1. In the Adfox account, go to the Monetization → Settings tab and link your Yandex Advertising Network login.
  2. Go to the Display advertising tab. Select the placement that you want to link your Yandex Advertising Network ad unit to.

    By default, the ad unit is linked to the placement identified by the banner type and position in all sections of the site. However, if you need to link different ad units to the placement in different site sections, click Show sections and link the ad units directly to the placement in the desired section.

  3. Click and select a site in the Yandex Advertising Network to create an ad unit on.

    Set up a new Banner unit. As a result, a new ad unit will be created, and the unit ID will appear in the YAN block ID column.

On placements with Turbo pages, Yandex Advertising Network monetization gets activated when you install the ad tag on the Turbo page. When the code is called from a regular site page, Yandex Advertising Network won't get involved in monetization.

6.2 Enable external monetization

External monetization on Turbo pages can only be enabled with the Google monetizer at the moment. To learn how to set up external monetization for Google, see this article.

Contact support