Импорт объявлений

Импорт подходит компаниям с большим числом предложений — товаров, объектов недвижимости или услуг. Вы размещаете на своём сайте файл со всем каталогом, а наш сайт сам скачивает его примерно раз в час и по нему создаёт, обновляет и снимает ваши объявления. Подавать и править каждое объявление вручную не нужно. Подключение и загрузки бесплатны.

Такой файл называется фидом. Его формат — YML: это XML-файл, который умеют выгружать многие интернет-магазины и CMS.

Фид будет делать программист или ИИ-агент? Передайте ему инструкцию для ИИ-агента и программиста. В ней все требования к файлу, вопросы, которые исполнитель должен вам задать, и чек-лист проверки. ИИ-агенту (например, ChatGPT, Claude или Cursor) достаточно приложить этот файл к задаче. Если сделать фид некому, напишите нам через форму обратной связи.

Как подключить импорт

Подготовьте фид по требованиям из этой статьи и разместите его по постоянному адресу, например https://ваш-сайт.ru/export/catalog.xml. Адрес должен открываться в браузере без пароля.
Сохраните ссылку. Войдите на сайт и откройте раздел «Импорт объявлений» в личном кабинете. Вставьте адрес фида и нажмите «Сохранить ссылку».
Подтвердите сайт. В блоке «Подтверждение сайта» появится файл с именем вида partner-verification-….txt. Скачайте его кнопкой «Скачать файл» и разместите в корне сайта, адрес которого указан в фиде в элементе shop/url. Файл должен открываться по адресу https://ваш-сайт.ru/partner-verification-….txt. Так мы убеждаемся, что фид публикует владелец сайта.
Проверьте фид. Нажмите «Проверить фид». Обычно через несколько минут в блоке «Последняя проверка фида» появится отчёт. Проверка ничего не публикует: она ищет ошибки в файле, проверяет файл подтверждения и загружает список ваших категорий. Исправьте ошибки и проверьте фид снова — повторная проверка доступна через 2 минуты.
Выберите разделы и территорию. В блоке «Категории и территория» для каждой категории из фида выберите раздел нашего сайта или «Не импортировать». Укажите страну, регион и город: они будут у всех объявлений. Нажмите «Сохранить настройки».
Выберите контакты. В блоке «Контакты в объявлениях» отметьте, что показывать в объявлениях: имя, email, телефон, Telegram, дополнительные контакты. Сами сведения берутся из профиля и меняются в разделе «Моя личная информация». Отметьте согласие на распространение и нажмите «Сохранить контакты».
Примите условия. В блоке «Условия импорта объявлений» прочитайте условия и нажмите «Принимаю условия импорта объявлений».
Отправьте заявку. В блоке «Заявка на автоматический импорт» нажмите «Отправить заявку». Если что-то не готово, кабинет покажет, что именно. После одобрения заявки администратором первая загрузка пройдёт в течение часа, дальше сайт будет загружать фид сам.

Требования к файлу

В файле всегда весь актуальный каталог, а не только изменения. Предложение, которого нет в новой версии файла, снимается с показа.
Формат — YML (XML) в кодировке UTF-8 или Windows-1251. Архив ZIP или GZ вместо XML не подойдёт.
Адрес начинается с http:// или https://, работает на стандартном порту, без логина и пароля и открывается из интернета.
Сайт скачивает фид программой, а не браузером. Защита от ботов — капча, проверка браузера, блокировка по IP-адресу — не должна закрывать фид, файл подтверждения и фотографии. Запросы приходят с заголовком User-Agent, в котором есть PartnerImport, — его можно добавить в исключения защиты.
Сервер отдаёт файл целиком не дольше чем за 60 секунд. Размер — до 50 МБ.
Предложений — до 1000, считая снятые с продажи. Если нужно больше, напишите нам. Файл сверх лимита не принимается целиком.
Категорий — до 150, считая родительские и пустые.

Пример фида:

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog>
  <shop>
    <url>http://partner.example/</url>
    <categories>
      <category id="10">Переноски и сумки</category>
    </categories>
    <offers>
      <offer id="SKU-0042" available="true">
        <name>Переноска для кошки</name>
        <url>http://partner.example/products/SKU-0042</url>
        <price>1500</price>
        <currencyId>RUB</currencyId>
        <categoryId>10</categoryId>
        <picture>http://partner.example/images/SKU-0042-main.jpg</picture>
        <picture>http://partner.example/images/SKU-0042-side.jpg</picture>
        <picture>http://partner.example/images/SKU-0042-detail.jpg</picture>
        <description>Новая переноска. Размер 48 × 32 × 30 см. Самовывоз.</description>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Скачать: этот пример, пример со всеми поддерживаемыми полями.

Что сайт берёт из файла

shop/url — обязателен: Адрес вашего сайта. В его корне размещается файл подтверждения, и на этот же сайт должны вести ссылки на страницы предложений.
category — обязателен: Ваши категории. Атрибут id — целое положительное число, уникальное в файле; parentId — id родительской категории. В кабинете каждой категории сопоставляется раздел нашего сайта.
offer, атрибут id — обязателен: Постоянный идентификатор предложения, до 80 символов. По нему сайт узнаёт предложение при следующих загрузках.
offer, атрибут available — необязателен: true — показывать, false — снять с показа. Без атрибута предложение считается доступным.
name — обязателен: Название объявления. Вместо него можно указать у предложения type="vendor.model" и элементы typePrefix, vendor и model.
categoryId — обязателен: id категории предложения.
description — обязателен: Текст объявления. HTML допустим: сайт уберёт разметку и сохранит абзацы.
price — необязателен: Цена. Без цены объявление публикуется с договорной ценой.
currencyId — необязателен: Валюта цены. Без неё — рубли.
url — необязателен: Страница предложения на вашем сайте. В объявлении — строка «Веб-сайт».
picture — необязателен: Фотографии, до 5 штук. Первая — главная.

Остальные элементы YML — характеристики, скидки, доставку и другие — сайт пропускает и перечисляет в отчёте как предупреждение. Это не ошибка. Все объявления импорта получают тип «Предложение», а раздел, территорию и контакты задают настройки кабинета, а не файл.

Название и описание

Название и описание проверяются по тем же правилам, что и объявления, поданные вручную. Предложение с нарушением пропускается, причина видна в отчёте. Автоматически тексты не исправляются и не обрезаются.

Название — до 150 символов, описание — до 5000 символов. Описание обязательно.
Без ссылок, адресов email и номеров телефонов: контакты сайт добавит в объявление сам. Ряд из 11 цифр, который начинается с 7 или 8, считается телефоном, даже если это артикул.
Без слов из 30 и более символов без пробелов: длинные артикулы и склеенные слова разделяйте пробелами.
В названии нет названия города, выбранного для объявлений в кабинете.
Без нецензурной лексики и запрещённых тем: алкоголь, табак, оружие, рецептурные препараты, азартные игры, кредиты и займы и другие.

Кнопка «Проверить фид» эти правила не проверяет — это делают загрузки после одобрения заявки. Пустое описание и отсутствующий categoryId она находит: такие предложения попадают в отчёт с ошибкой. Чтобы не узнавать о нарушениях правил текстов из первого отчёта, проверьте тексты заранее: в инструкции для ИИ-агента и программиста правила описаны подробно.

Цена, валюта и фотографии

Цена — число с точкой: 1500 или 1499.90, без пробелов, запятых и знака валюты. Сумма округляется до целой: 1499.50 станет 1500. Цена отсутствует, пуста или равна 0 — в объявлении будет «договорная».
Валюта — RUB (или RUR), USD, EUR, AMD, KZT, GEL, BYN, UAH, AZN, KGS, RSD. Цена не пересчитывается по курсу.
Фотографии — JPEG, PNG или WebP, до 15 МБ каждая. Сайт берёт первые 5 ссылок из picture.
Сайт запоминает фотографию по ссылке. Чтобы заменить фотографию, измените ссылку — например, имя файла. Новый файл по старой ссылке сайт не заметит.
Фотография не скачалась — объявление всё равно публикуется, а сайт повторит попытку примерно через сутки.

Как обновлять и снимать предложения

Изменились цена, текст или фотографии — оставьте прежний id. Сайт обновит то же объявление, его адрес и дата публикации сохранятся.
Не меняйте id у существующих предложений и не отдавайте id снятого товара другому товару. Новый id — это новое объявление, а старое будет снято. Регистр важен: SKU-42 и sku-42 — разные предложения.
Чтобы снять предложение, укажите available="false" или уберите его из файла. Объявление скроется и будет храниться 180 дней: если предложение вернётся с тем же id, вернётся и прежнее объявление. Через 180 дней объявление удаляется.
Выбор «Не импортировать» для категории в кабинете скрывает все её объявления сразу после сохранения настроек.
Пустой список предложений <offers/> снимает с показа все объявления. Если элемента offers в файле нет совсем, файл считается повреждённым, и объявления не меняются.
Объявление, удалённое администратором сайта, по тому же id заново не создаётся.

Ошибки и отчёты

Отчёт проверки виден в блоке «Последняя проверка фида», отчёт регулярной загрузки — в блоке «Последняя загрузка». Сообщения бывают трёх видов.

Ошибка файла — файл не принят, объявления не меняются. Например: повреждённый XML, нет shop/url, превышен лимит, сайт не подтверждён.
Ошибка предложения — пропущено только это предложение: новое объявление не создаётся, существующее остаётся с прежними данными. Остальные предложения обрабатываются, результат загрузки — «Частично».
Предупреждение — на публикацию не влияет. Например: лишние элементы в файле, нет атрибута available, не скачалась фотография.

Если исправить ошибку не получается, передайте текст отчёта вашему программисту или ИИ-агенту вместе с инструкцией — в ней для каждого сообщения указано, что исправить.

Если файл перестал загружаться

Пока файл не принимается — сервер недоступен, в файле ошибка, пропал файл подтверждения, — объявления остаются в последней принятой версии. Если это продолжается:

через 24 часа вы получите письмо с причиной;
через 7 дней все объявления подключения скроются, а загрузки станут реже — раз в сутки;
через 180 дней импорт прекратится, а объявления будут удалены.

Как только файл снова принят, объявления возвращаются на сайт.

Управление объявлениями

Импортированные объявления нельзя редактировать и удалять на сайте: вместо «Редактировать» у них стоит «Управляется фидом». Меняйте данные в фиде.
В списке ваших объявлений доступны «Приостановить показ» и «Закрыть объявление» (перенос в архив). Возвращение предложения в фид эти действия не отменяет.
В разделе «Импорт объявлений» можно поставить импорт на паузу, скрыть все объявления, сменить адрес фида или прекратить импорт с удалением всех объявлений.

Условия работы импорта — в документе Условия импорта объявлений. Вопросы задавайте через форму обратной связи.

Сегодня в 16:05