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

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

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 Placements, 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.

Step 4. Install the ad tag

Select a position type for your page:

<turbo:content>
   <![CDATA[
     <header>
      <figure><img src="#" /><figure>    
      <h1>Page header</h1>    
      <menu><!--Menu items-->
      <a href="#">Link text</a>
      <a href="#">Link text</a>
      </menu>
   </header>
      <h2>Page header</h2>
   <p>The first paragraph of the text with <b>highlighting</b> and a list:</p>
   <ul>
      <li>point 1;</li>
      <li>point 2.</li>
   </ul>
   <figure data-turbo-ad-id="first_ad_place"></figure>
   <table>
      <tr><!--Table header-->
      <th>First column</th>
      <th>Secong column</th>
      </tr>
      <tr><!--Table string-->
      <td>First column</td>
      <td>Secong column</td>
      </tr>
      </table>
   ]]>
</turbo:content>

<rss
xmlns:yandex="http://news.yandex.ru"
xmlns:media="http://search.yahoo.com/mrss/"
xmlns:turbo="http://turbo.yandex.ru"
version="2.0"
>
<channel>
<turbo:adNetwork
 type="Adfox"
 turbo-ad-id="first_ad_place">
     <![CDATA[
         <div id="container 1 ID"></div>
         <script>
             Ya.adfoxCode.create({
                 ownerId: 123456,
                 containerId: 'container 1 ID',
                 params: {
                         pp: 'g',
                         ps: 'cmic',
                         p2: 'fqem'
                 }
             });
         </script>
      ]]>
  </turbo:adNetwork>
  <turbo:adNetwork
   type="Adfox"
   turbo-ad-id="second_ad_place">
       <![CDATA[
           <div id="container 2 ID"></div>
           <script>
               Ya.adfoxCode.create({
                   ownerId: 123456,
                   containerId: 'container 2 ID',
                   params: {
                       pp: 'g',
                       ps: 'cmic',
                       p2: 'fqem'
                   }
               });
           </script>
       ]]>
  </turbo:adNetwork>
  <item turbo="true">
      ...
      <turbo:content>
          ...
          <figure data-turbo-ad-id="first_ad_place"></figure> 
          ...
          <figure data-turbo-ad-id="second_ad_place"></figure> 
          ...
      </turbo:content> 
  </item>
</channel>
</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.

Add a campaign

1. Go to the Campaigns tab and click Create.
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. Select the site, section, or placement where you want to place the campaign and click Save.

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 Create.
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.

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.

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

Send an email