Turning on Turbo pages for online stores

Turbo pages for online stores are formed from the YML file for individual product pages. The YML file must be formed according to the Yandex.Market requirements.

Generated Turbo pages are displayed in Yandex mobile search results.
Attention. If you use subdomains for regional site versions, Yandex search results will show Turbo pages with region-specific information (passed in the YML file). If you have one website address and information about products or delivery differs for each region, the search results will show the same product description, regardless of the user's region.
  1. Step 1. Export products in the YML format.
  2. Step 2. Upload the YML file in Yandex.Webmaster.
  3. Step 3. Install the tracking tag.
  4. Step 4. Set up order placement.
  5. Step 5. (Optional) Add extra information
  6. Step 6. Check the examples and start the display
  7. What should I do next?

Step 1. Export products in the YML format.

Attention. Turbo pages don't support special description type, such as books.
For Turbo pages, use the simplified and user-defined types of descriptions (offer). If your site was created with CMS, use plugins to generate the YML file.
CMS Note
1C-Bitrix The YML export plugin is installed by default: Shop → Settings → Data export → Yandex.
OpenCart Use the instructions for installing the extension.
Another View the list of plugins. If your site doesn't have a plugin, create the YML file yourself.
Review the YML file restrictions for Turbo pages and main components.
Place the generated YML file on your server. It must be available via a link (for example https://example.com/price). In addition, allow the Yandex.Webmaster robot to index it using the Allow directive in the robots.txt file.
Note. Turbo pages are created for products that are in stock. They are set with the available="true" attribute of the offer element in the simplified or user-defined description types.

Step 2. Upload the YML file in Yandex.Webmaster.

To upload the YML file:

  1. Go to Turbo pages → Data sources in Yandex.Webmaster.
  2. In the Attribution block, choose the YML option.
  3. In the field, specify the link to the YML file and click Add. You can add up to 100 YML files.
    Note. The upload and validation take several minutes.
  4. If you use authorization to access the YML file, on the Turbo pages → Settings → Access page, enter your username and password.

The list of all uploaded files and their statuses are displayed on the Sources page.

The processing statuses
Status Description and recommendations
“Checking” The service is checking the file for errors. The validation takes several minutes.
“No errors” The file is loaded and it doesn't contain errors.
“Download failed”
  • The file is prohibited in the robots.txt file or the server response is not 200 OK. Use the allow directives to allow the file indexing.
  • The file contains errors (for example, duplicate elements).
“Validation error” The elements in the file aren't supported by Yandex or are specified incorrectly.

Learn more about the YML file requirements in the Yandex.Market documentation.

“Update Error” Errors were found during the last update.
If the service found errors:
  1. See the error example. To do this, click the  → Learn more icon next to the desired source.
  2. Fix any errors that were found.
  3. Run a recheck. To do this, click the  → Revalidate the source icon next to the desired source.
    Note. The robot tracks changes and updates the status within an hour.

Step 3. Install the tracking tag.

To install the web analytics tag, do the following:
  1. Go to the Turbo pages → Settings page in Yandex.Webmaster.
  2. In the Tags section add the web analytics system and specify the tag ID.

    Supported web analytics systems:

    Yandex.Metrica

    Specify the tag number. For example, 123456.

    To make it easier to work with reports, use the same counter on the main site and on its Turbo pages. Learn more about viewing Turbo page reports in Yandex.Metrica Help.

    LiveInternet

    If the tag is only installed on one site, leave this field blank.

    If the tag is installed on multiple sites, specify the name of the tag. For example, example-host.

    Google Analytics
    Specify the tracking ID. For example, UA-12340005-6.
    Mail.Ru
    Specify the tag ID. For example, 123456.
    Rambler Top 100
    Specify the tag ID. For example, 123456.
    Mediascope (TNS)
    Project ID tmsec with the “- turbo” ending. For example, if the example_total tag is installed for regular site pages, then specify example_total-turbo for the Turbo pages.
    Other

    If your web analytics system supports installations as a one-pixel image, you can add it to the Turbo page.

    You can also include additional parameters in the URL to send them to the web analytics system:
    • {referrer} — Referer.
    • {referrerStarsEscaped} — Referer for Mediascope (with escaped character *), to connect this system without specifying the ID.
    • {pageTitle} — Page title.
    • {originalURL} — The original page URL.
    • {screenWidth} — The screen width.
    • {screenHeight} — The screen height.
    • {random} — Pseudorandom number (a new value is generated for each occurrence in the string).
    • {requestId} — Request ID (one per page).
    • {clientId} — Client ID (one per user's browser).

    Example:

    http://some.doma.in/{screenWidth}*{clientId}/{random}/{originalURL}?title={pageTitle} 
  3. Click Save to apply the changes.

Step 4. Set up order placement.

  1. In Yandex.Webmaster, go to the Turbo pages → Settings → Checkout page.
  2. Add one or more order placement options:
    • Shopping cart on Turbo. The user can put the product in the shopping cart, continue shopping or place the order right away on the Turbo page.
    • 1-click buying. The user fills out the order form on the Turbo page. The order is sent to the email address you specify.
    • Add to cart. The user goes to your site's shopping cart with the added product.
To track conversions, use Yandex.Metrics goals and e-Commerce reports.
Note. Data for e-commerce reports on Turbo pages is passed automatically. To collect information from the main site, you need additional settings.

Step 5. (Optional) Add extra information

For online stores, you can add information that is visible on all store pages. For example, you can add payment and delivery information, size table. For this:

  1. In Yandex.Webmaster, go to the Turbo pages → Settings → Information sections page.
  2. Click the Add button. The maximum number of sections is 10.
  3. Enter the section name to display on the page.
  4. Click the Change text button and add information. The text field supports standard HTML markup. The text length is unlimited.
    Example of a table with dimensions
    <table>
        <tbody>
            <tr>
               <th>Russian size</th>
    	    <th>42</th>
                <th>44</th>
    	    <th>46</th>
    	    <th>48</th>
    	    <th>50</th>
    	    <th>52</th>
    	    <th>54</th>
    	</tr>
    	<tr>
    	    <td>Chest size, cm</td>
                <td>84</td>
    	    <td>88</td>
    	    <td>92</td>
    	    <td>96</td>
    	    <td>100</td>
    	    <td>104</td>
    	    <td>108</td>
    	</tr>
    	<tr>
    	    <td>Waist circumference,cm</td>
    	    <td>64</td>
    	    <td>68</td>
    	    <td>72</td>
    	    <td>76</td>
    	    <td>80</td>
    	    <td>84</td>
    	    <td>88</td>
    	</tr>
    	<tr>
    	    <td>Hip circumference , cm</td>
    	    <td>92</td>
    	    <td>96</td>
    	    <td>100</td>
    	    <td>104</td>
    	    <td>108</td>
    	    <td>112</td>
    	    <td>116</td>
    	</tr>
        </tbody>
    </table>

    To change the order in which sections are displayed on the page, use the icon.

  5. Click the Save button.

The settings will be shown on the sample Turbo page on the Turbo pages → Settings page in Yandex.Webmaster. To view the example, set the radio button to Products.

Step 6. Check the examples and start the display

To view examples of Turbo pages:

  1. Go to Turbo pages → Data sources in Yandex.Webmaster.
  2. To do this, click the  → Learn more icon next to the desired source.
  3. On the Source information page, click the Preview link.
  4. View some of the pages and make sure that they display all necessary characteristics. If some characteristics are missing, generate the YML file again.

To turn on the source check and start the Turbo page display:

  1. Go to Turbo pages → Data sources in Yandex.Webmaster.
  2. Turn on the source.

What should I do next?

Update the YML file

To update product information, make changes to the YML file on your server. The Yandex robot downloads a file every hour. If a robot could not download it within 10 seconds, the file is considered unavailable. In this case, the Turbo pages → Diagnostics page in Yandex.Webmaster displays an “Upload error”.

To remove Turbo pages with certain products from the search results, delete these products from the price list and update the YML file on your server.

Track how Turbo pages work
Yandex.Webmaster monitors the performance of Turbo pages and informs you about errors. You can view them on the Turbo pages → Diagnostics page in Yandex.Webmaster. To receive messages by email, configure Turbo page notifications.