JSON-LD

JSON-LD — это формат структурированных данных, который помогает поисковым системам понимать информацию на странице. Он основан на Schema.org и используется для описания товаров: их названия, цены, наличия и рейтинга.

Пример JSON-LD для страницы товара “Смартфон X” в категории “Электроника”:

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Главная",
      "item": "https://myshop.ru"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Электроника",
      "item": "https://myshop.ru/electronics"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Смартфон X"
    }
  ]
}

Такая разметка не влияет на внешний вид сайта, но помогает поисковым системам, например Google Search, формировать расширенные сниппеты — улучшенные блоки в результатах поиска, где могут отображаться цена, рейтинг, наличие и другие данные прямо в выдаче.

CS-Cart уже формирует весь необходимый базовый JSON-LD для товарных страниц. В частности, автоматически формируются сущности Product и Offer:

  • в Product передаются ключевые данные для расширенного сниппета;
  • в Offer передаются коммерческие параметры товара.

Дополнительно, в зависимости от подключенных модулей, формируются следующие поля:

  • отзывы и рейтинг товара (при подключении модулей Отзывы о товарах и Отзывы и комментарии);
  • вариации и общие товары (например, при подключении модуля Вариации товаров).

CS-Cart поддерживает несколько сущностей JSON-LD. Ниже описаны сущности, настройка и использование которых доступны в текущей версии документации.

Product (Товар) и Offer (Товарное предложение)

CS-Cart автоматически формирует JSON-LD-сущность Product. Она используется для передачи поисковым системам информации о товаре. В Product могут передаваться следующие данные:

  • название товара;
  • описание товара;
  • изображения товара;
  • артикул (SKU);
  • бренд;
  • идентификаторы GTIN, MPN и ISBN (при наличии).

Поисковые системы используют данные из Product для определения характеристик товара и формирования расширенных сниппетов в результатах поиска.

Сущность Offer является частью сущности Product и описывает условия приобретения конкретного товара. В Offer передаются следующие данные:

  • цена товара;
  • валюта;
  • наличие товара;
  • состояние товара;
  • URL товарной страницы.

Поисковые системы могут использовать данные из Offer для отображения сведений о стоимости и доступности товара непосредственно в результатах поиска.

Примечание

Сущности Product и Offer формируются автоматически и не требуют дополнительной настройки.

Organization (Организация)

В версии 4.21 появилась возможность расширить блок Organization (Организация) вручную для главной страницы витрины, чтобы она могла отображаться в поисковой системе.

Чтобы начать редактирование блока, в Панели администратора на вкладке Веб-сайт перейдите в раздел SEO и в правом верхнем углу нажмите JSON-LD:

Откроется окно, в котором можно начать заполнение блока. Следующие данные уже подтягиваются автоматически:

  • name — название витрины (берется из настроек витрины);
  • url — URL витрины (берется из URL витрины);
  • logo — логотип витрины (берется из логотипа витрины).

В открывшемся окне нужно заполнить следующие данные вручную:

  • description — описание витрины;
  • telephone — номер телефона;
  • email — адрес электронной почты;
  • sameAs — массив ссылок на соцсети.

Важные замечания:

  • принимаются только абсолютные URL (http:// или https://);
  • некорректные ссылки игнорируются и не попадают в JSON-LD;
  • массив sameAs выводится только при наличии хотя бы одной корректной ссылки.