FAQ по YML
Для того чтобы наш робот мог корректно обработать данные, микроразметку следует использовать на всех целевых страницах товарных предложений. На целевых страницах следует размещать только один элемент Product, соответствующий товарному предложению для данного URL.
При отсутствии микроданных, Mysitemapgenerator пытается автоматически определять данные о товарных предложениях, используя специальный алгоритм анализа веб-страниц. Тем не менее это не всегда может гарантировать получение корректных данных. Для достижения лучшего результата, мы рекомендуем использовать микроразметку содержимого при помощи Schema.org.
Если на Вашем сайте не применяется микроразметка товарных предложений и не совместим с расширенными алгоритмами извлечения - Вы можете формировать фид с помощью подготовленного CSV-файла.
Как робот может найти товары на вашем сайте?
Пример указания в фиде возможности заказа только парами:
<min-quantity>2</min-quantity>
Вы можете переопределить это значение в настройках обработчика, поддерживаемые варианты значений:
- 1 единица - продажа поштучно
- 2 единицы - продажа парами
- 4 единицы - продажа комплектами
Отсутсвие элемента min-quantity означает, что товар можно приобрести поштучно. Данный элемент не применим к другим категориям товаров.
Используйте опцию "Определять характеристики товаров", чтобы в товарный фид были добавлены параметры "Цвет" и "Размер" - это рекомендовано для совместимости с отдельными требованиями некоторых сервисов.
Для определения характеристик товаров применяются унифицированные и полностью автоматизированные методы, поэтому в отдельных случаях данные могут определяться некорректно. В такой ситуации, или когда Вам просто не требуется указание характеристик, отлючите опцию их определения в настройках обработчика.
Параметр размерности определяется только для товаров, которые соотнесены к категориям одежды или обуви. В случае, если необходимые для товарного предложения параметры не указаны или не могут быть определены - товарам будут назначены обобщенные характеристики (размер - универсальный, цвет - разноцветный).
Пример указания параметров в товарном фиде:
<param name="Size" unit="INT">L</param> <param name="Color">Разноцветный</param>
Универсальные международные обозначения размеров одежды: XXS, XS, S, M, L, XL, XXL, 3XL
Международные обозначения размеров детской одежды: 0-3m, 3-6m, 6-9m, 9-12m, 12-18m, 18-24m, 24-36m
Международные размеры бюстгальтеров: A, AA, B, C, D, DD, DDD, DDDD, E, F, FF, G, GG, H, HH, J, JJ, K, KK, LL
Числовые обозначения размера элементов одежды и обуви, распространенные в странах Европы, России и СНГ.
Пример указания размера в товарном фиде:
<param name="Size" unit="INT">XL</param>
Для джинсов - также могут быть определены распространенные маркировки в дюймах (например: 31/32)
Пример указания размера джинсов в товарном фиде:
<param name="Size" unit="INCH">30/32</param>
Для детской одежды - также могут быть определены числовые обозначения размера относительно роста.
Пример указания размера детской одежды в товарном фиде:
<param name="Size" unit="Height">104</param>
Не соответствующие перечисленным значениям определения цвета будут проигнорированы.
Пример указания цвета в товарном фиде:
<param name="Color">Зеленый</param>
- name — название товара. Указывается как свойство Product.
- description — описание товара. Указывается как свойство Product.
- image — ссылка на изображение товара. Указывается как свойство Product.
- price — цена. Указывается как свойство Offer.
- lowPrice - минимальная цена. Указывается как свойство AggregateOffer.
- priceCurrency — валюта. Указывается как свойство Offer. Для указания валюты необходимо использовать коды валют в соответствии с ISO 4217.
- priceSpecification — Указывается как свойство Offer.
- availability — флаг наличия товара. Указывается как свойство Offer.
- category - наименование категории. Указывается как свойство Product.
- brand - наименование бренда/производителя товара. Указывается как свойство Product.
<div itemscope itemtype="http://schema.org/Product"> <h1 itemprop="name">Товар</h1> <a itemprop="image" href="http://youwebsiteurl/pictures/thumbnail.jpg"> <img src="/pictures/thumbnail.jpg" /> </a> <div itemprop="offers" itemscope itemtype="http://schema.org/Offer"> <div>$1000</div> <meta itemprop="price" content="1000.00" /> <meta itemprop="priceCurrency" content="USD" /> <div>В наличии</div> <meta itemprop="availability" href="http://schema.org/InStock" /> </div> <div itemprop="description">Отличный товар</div> </div>
Структурированные данные Schema.org для автоматической обработки также доступны в объекте JSON-LD. Пример размещения данных в объекте JSON-LD:
<script type="application/ld+json"> { "@context": "http://schema.org/", "@type": "Product", "name": "Товар", "image": "http://youwebsiteurl/pictures/thumbnail.jpg", "description": "Отличный товар", "offers": { "@type": "Offer", "priceCurrency": "USD", "price": "1000.00", "availability": "http://schema.org/InStock" } } </script>
Генератор обрабатывает данные Open Graph для товаров:
- og:title — название товара.
- og:description — описание товара.
- og:image — ссылка на изображение товара.
- product:price:amount — цена.
- product:price:currency — валюта. Коды валют должны соответствовать ISO 4217.
- product:sale_price:amount — текущая цена товара с учетом скидкой.
- product:availability — наличие товара.
Пример применения разметки Open Graph для товарного предложения:
<meta property="og:type" content="product" /> <meta property="og:title" content="Товар" /> <meta property="og:description" content="Отличный товар" /> <meta property="og:image" content="http://youwebsiteurl/pictures/thumbnail.jpg" /> <meta property="product:price:amount" content="1000.00" /> <meta property="product:price:currency" content="USD" /> <meta property="product:availability" content="in stock" />
Пример разметки Schema.org с использованием элемента priceSpecification:
<div itemscope itemtype="http://schema.org/Product"> <h1 itemprop="name">Товар</h1> <div itemprop="offers" itemscope itemtype="http://schema.org/Offer"> <strike itemprop="price">1000.00</strike>USD <meta itemprop="priceCurrency" content="USD" /> <span itemprop="priceSpecification" itemscope itemtype="http://schema.org/PriceSpecification"> <strong itemprop="price">900.00</strong>USD <meta itemprop="priceCurrency" content="USD"/> (Акция действует до 2029-01-12) <meta itemprop="validThrough" content="2029-01-12T00:00:00"/> </span> </div> </div>
Пример разметки Open Graph с использованием элеманта sale_price:
<meta property="og:type" content="product" /> <meta property="og:title" content="Товар" /> <meta property="product:price:amount" content="1000.00" /> <meta property="product:price:currency" content="USD" /> <meta property="product:sale_price:amount" content="900.00" /> <meta property="product:sale_price:currency" content="USD" />
Пример указания категории в качестве свойства Schema.org Product на странице товарного предложения:
<div itemscope itemtype="http://schema.org/Product"> ... <meta itemprop="category" content="Лучшие товары" /> ... </div>
Пример указания категории с помощью Schema.org Breadcrumb:
<div itemscope itemtype="http://data-vocabulary.org/Breadcrumb"> <a href="http://website.tld/catalog" itemprop="url"> <span itemprop="title">Каталог</span> </a> › </div> <div itemscope itemtype="http://data-vocabulary.org/Breadcrumb"> <a href="http://website.tld/catalog/group_1" itemprop="url"> <span itemprop="title">Группа 1</span> </a> › </div> <div itemscope itemtype="http://data-vocabulary.org/Breadcrumb"> <a href="http://website.tld/catalog/group_1/best" itemprop="url"> <span itemprop="title">Лучшие товары</span> </a> </div>
Пример указания категории с помощью Schema.org BreadcrumbList:
<ul itemscope itemtype="http://schema.org/BreadcrumbList"> <li itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"> <a itemprop="item" href="https://website.tld/catalog"> <span itemprop="name">Каталог</span> </a> <meta itemprop="position" content="1" /> </li> <li itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"> <a itemprop="item" href="https://website.tld/catalog/best"> <span itemprop="name">Лучшие товары</span> </a> <meta itemprop="position" content="2" /> </li> </ul>
- https://schema.org/Product
- https://developers.google.com/structured-data/rich-snippets/products
- https://yandex.ru/support/webmaster/supported-schemas/goods-prices.xml
С дополнительной информацией по использованию Open Graph:
Если страницы товарных предложений используют одновременно разметку Schema.org и Open Graph - приоритетным значением считаются данные, содержащиеся в микроразметке Schema.org. В случае отсутствия или наличия пустых свойств в Schema.org, но при их наличии в Open Graph - они будут использованы.
Обязательные элементы:
- Свойство name (название товара) - товарная позиция будет проигнорирована.
- Свойство price (стоимость товара) - товарная позиция будет проигнорирована.
- Свойство description (описание товара) - заменен на значение элемента name (название товара).
- Свойство picture (изображение товара) - проигнорирован при формировании файла.