Требования к товарному фиду

Зачем нужен фид?

Товарный фид необходим для отображения карточек товаров во время стрима. ShopStory парсит ваш фид и синхронизирует информацию о товарах (название, цена, изображение, ссылка).

📋 Обязательные требования

Формат фида

Отправьте вашему менеджеру ссылку на обновляемый товарный фид в формате:

XML (Yandex Market, Google Merchant)
YML (Yandex.Market Legacy)

Фид должен быть публично доступен по HTTPS и обновляться не реже 1 раза в день.

🔑 Обязательные поля

Каждый товар в фиде должен содержать:

Поле	Описание	Пример
Название товара	Полное название	`Фен-стайлер Dyson Airwrap HS01 Complete (фуксия)`
Артикул / ID	Уникальный и неизменный идентификатор	`airwrapcomplete` или `123456`
Ссылка на карточку	URL страницы товара	`https://example.ru/hairdryer/dyson/airwrapcomplete`
Изображение	Ссылка на фото товара	`https://cdn.example.ru/product/123.jpg`
Цена	Текущая цена товара	`29199.00 RUB`

Опциональные поля

Поле	Описание	Когда нужно
Цена со скидкой	Цена с учётом скидки	Если товар участвует в акции
Описание	Краткое описание товара	Для расширенного отображения (опционально)
Бренд	Производитель	Для фильтрации/группировки
Категория	Категория товара	Для навигации
Наличие	Доступность товара	`in_stock`, `out_of_stock`

Отключение цены

По запросу можно отключить отображение цены у товаров в стриме. Свяжитесь с вашим менеджером.

📝 Пример записи в фиде

XML (Google Merchant Feed)

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <title>Пример магазина</title>
    <link>https://example.ru</link>
    <description>Товарный фид для ShopStory</description>

    <item>
      <title>Фен-стайлер Dyson Airwrap HS01 Complete (фуксия)</title>
      <link>https://example.ru/hairdryer/dyson/airwrapcomplete</link>
      <description>1300 Вт, EC (BLDC) мотор, ионизация, термодатчик, независимая регулировка температуры, шнур 2.5 м, розовый/серебристый</description>

      <!-- Обязательные поля -->
      <g:id>airwrapcomplete</g:id>
      <g:image_link>https://cdn.example.ru/catalog/device/main/994dc9bfcbc065ff170e578e45c2a456.jpeg</g:image_link>
      <g:price>29199.00 RUB</g:price>

      <!-- Опциональные поля -->
      <g:sale_price>24999.00 RUB</g:sale_price>
      <g:brand>Dyson</g:brand>
      <g:product_type>Фены</g:product_type>
      <g:google_product_category>490</g:google_product_category>
      <g:condition>new</g:condition>
      <g:availability>in_stock</g:availability>
    </item>

    <!-- Другие товары -->
  </channel>
</rss>

YML (Yandex Market)

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2025-01-21 10:00">
  <shop>
    <name>Пример магазина</name>
    <company>ООО "Пример"</company>
    <url>https://example.ru</url>

    <currencies>
      <currency id="RUB" rate="1"/>
    </currencies>

    <categories>
      <category id="1">Красота и здоровье</category>
      <category id="10" parentId="1">Фены и стайлеры</category>
    </categories>

    <offers>
      <offer id="airwrapcomplete" available="true">
        <name>Фен-стайлер Dyson Airwrap HS01 Complete (фуксия)</name>
        <url>https://example.ru/hairdryer/dyson/airwrapcomplete</url>
        <price>29199</price>
        <oldprice>34999</oldprice>
        <currencyId>RUB</currencyId>
        <categoryId>10</categoryId>
        <picture>https://cdn.example.ru/catalog/device/main/994dc9bfcbc065ff170e578e45c2a456.jpeg</picture>
        <vendor>Dyson</vendor>
        <description>1300 Вт, EC (BLDC) мотор, ионизация, термодатчик</description>
      </offer>
    </offers>
  </shop>
</yml_catalog>

⚠️ Важные ограничения

Размер фида

Большие фиды

Если размер фида больше 250 MB, обязательно сообщите вашему менеджеру. Мы:

Проверим работоспособность парсинга
Оптимизируем процесс загрузки
Возможно, предложим фильтрацию или разбиение на части

Стабильность ID товаров

Критично

ID товара (артикул) должен быть неизменным. Если вы меняете ID товара в фиде, ShopStory потеряет связь между товаром и стримами, где он участвовал.

Плохо: Артикул меняется при каждой загрузке фида Хорошо: Артикул SKU123 всегда соответствует одному и тому же товару

Кодировка и валидность

Фид должен быть в кодировке UTF-8
XML/YML должен быть валидным (без синтаксических ошибок)
Ссылки на изображения должны быть публично доступны (без авторизации)

🔗 Совместимость с популярными платформами

ShopStory поддерживает фиды из следующих систем:

Платформа	Формат	Примечание
Yandex Market	YML	✅ Полная поддержка
Google Merchant Center	XML (RSS 2.0)	✅ Полная поддержка
Facebook/Instagram Catalog	XML/CSV	✅ Поддержка XML
1C-Битрикс	YML	✅ Экспорт в Yandex Market
MODX	YML/XML	✅ Через плагины
Shopify	XML	✅ Google Shopping Feed
WooCommerce	XML	✅ Через Product Feed плагины
Magento	XML	✅ Google Merchant Feed

Не нашли свою платформу?

Практически любая e-commerce платформа может экспортировать фид в формате XML/YML. Обратитесь к документации вашей CMS или к вашему менеджеру ShopStory.

🚀 Процесс подключения фида

Шаг 1: Подготовьте фид

Убедитесь, что фид доступен по HTTPS
Проверьте наличие всех обязательных полей
Проверьте валидность XML/YML (используйте валидаторы)

Шаг 2: Отправьте ссылку

Отправьте вашему менеджеру ShopStory:

URL фида (например, https://example.ru/export/yandex-market.xml)
Частоту обновления (например, "обновляется каждые 6 часов")
Примерное количество товаров в фиде

Шаг 3: Ожидайте настройку

После получения ссылки мы:

Проверим доступность и валидность фида
Настроим автоматическую синхронизацию
Проведём первичный импорт товаров
Уведомим вас о готовности

Время настройки

Первичная настройка фида занимает от 30 минут до 2 часов в зависимости от размера фида.

❓ Часто задаваемые вопросы

Как часто обновляется фид?

ShopStory автоматически загружает обновления фида каждые 6-12 часов. Точная частота настраивается индивидуально.

Что будет, если цена товара изменится в фиде?

Новая цена будет отображаться в карточке товара в стриме после следующей синхронизации фида.

Можно ли использовать несколько фидов?

Да, можно подключить несколько фидов (например, для разных категорий товаров). Свяжитесь с вашим менеджером.

Нужно ли добавлять в фид все товары?

Рекомендуется добавлять все товары, чтобы иметь возможность выбирать любые товары для стримов. Но можно ограничиться только теми категориями, которые будут участвовать в трансляциях.

Фид защищён паролем. Что делать?

Фид должен быть публично доступен без авторизации. Создайте отдельный URL для ShopStory или настройте авторизацию по IP (мы предоставим список IP-адресов).

🔧 Отладка и проверка

Валидация XML/YML

Используйте онлайн-валидаторы:

XML: XML Validator
YML (Yandex Market): Яндекс.Маркет Проверка фида

Проверка доступности

# Проверьте, что фид доступен по HTTPS
curl -I https://example.ru/export/yandex-market.xml

# Должен вернуть HTTP 200 OK

Проверка кодировки

Убедитесь, что в первой строке XML указана кодировка UTF-8:

<?xml version="1.0" encoding="UTF-8"?>

📚 Связанные разделы

Web SDK Integration — Быстрая интеграция без программирования
API Quickstart — Кастомная интеграция через API
Deep Links — Прямые ссылки на стримы с товарами

💬 Поддержка

Если у вас возникли вопросы по подготовке фида:

Email: support@shopstory.live
Telegram: Партнёрская группа (добавление по приглашению от менеджера)
FAQ: Частые вопросы

📋 Обязательные требования​

Формат фида​

🔑 Обязательные поля​

Опциональные поля​

📝 Пример записи в фиде​

XML (Google Merchant Feed)​

YML (Yandex Market)​

⚠️ Важные ограничения​

Размер фида​

Стабильность ID товаров​

Кодировка и валидность​

🔗 Совместимость с популярными платформами​

🚀 Процесс подключения фида​

Шаг 1: Подготовьте фид​

Шаг 2: Отправьте ссылку​

Шаг 3: Ожидайте настройку​

❓ Часто задаваемые вопросы​

Как часто обновляется фид?​

Что будет, если цена товара изменится в фиде?​

Можно ли использовать несколько фидов?​

Нужно ли добавлять в фид все товары?​

Фид защищён паролем. Что делать?​

🔧 Отладка и проверка​

Валидация XML/YML​

Проверка доступности​

Проверка кодировки​

📚 Связанные разделы​

💬 Поддержка​