Помощь

Практическая инструкция по работе с DocFeed: что и куда вносить, как проверить фид, опубликовать его и передать в Яндекс.

Быстрый старт

Два основных пути в зависимости от того, есть ли у вас уже фид.

Если фида ещё нет:

• Заполните данные площадки — вкладка «Настройки площадки → Площадка».
• Добавьте клиники и услуги.
• Добавьте врачей и их офферы (связку врач + клиника + специальность + услуга).
• Откройте вкладку «Фид» и запустите проверку.
• Исправьте ошибки, которые покажет проверка.
• Скачайте XML (YML) для размещения на домене клиники или настройте CNAME и опубликуйте фид через DocFeed.

Если фид уже есть:

• Откройте вкладку «Фид» и загрузите файл в разделе «Загрузить данные из Excel».
• Проверьте, что DocFeed правильно распознал данные.
• Исправьте то, что проверка сочтёт ошибкой.
• Дальше обновляйте данные уже в DocFeed и выгружайте их в актуальном формате по мере необходимости.

Как устроены данные

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

Клиника — конкретный филиал: адрес, город, телефон, сайт.

Врач — карточка врача: ФИО, фото, стаж, степень, звание, описание.

Услуга — то, что предлагается пациенту (приём, консультация, процедура).

Оффер — конкретная комбинация: врач + клиника + специальность + услуга + условия записи и цена. Один врач в разных клиниках или по разным специальностям — это разные офферы.

Отзыв — отзыв пациента о враче. В публичном фиде имя автора не передаётся — только обезличенная метка «Пациент».

Заполнение и примеры

Технический идентификатор врача и клиники (поле «Идентификатор врача»/«Идентификатор клиники») обычно не нужно придумывать самому — DocFeed предлагает его автоматически по мере ввода ФИО или названия клиники, и подставляет свободный вариант, если предложенный уже занят (например IvanovII-2, если IvanovII уже используется другим врачом). Предложение можно принять как есть или изменить вручную.

Примеры формата для полей, где формат не очевиден:

Проверка ошибок

В DocFeed два независимых уровня проверки:

• Проверка поля. Часть полей проверяется прямо в форме: адрес и email должны быть в правильном формате, у ID врача или клиники не может быть дубликата — DocFeed сразу покажет, какая другая карточка уже использует этот идентификатор, и не даст сохранить запись, пока это не исправлено.
• Проверка всего фида. На вкладке «Фид» — общая проверка: все ли обязательные поля заполнены, есть ли у каждого врача хотя бы одна базовая услуга, нет ли ссылок на удалённые записи и так далее. Список ошибок и предупреждений показывается отдельно; экспорт и публикация недоступны, пока остаются критические ошибки.

Импорт

Если фид уже существует в виде Excel-файла (в том числе выгруженного из другого сервиса), не переносите врачей вручную — загрузите файл на вкладке «Фид», и DocFeed распознает данные.

Поддерживается только файл в формате .xlsx, по структуре совпадающий с XLSX-шаблоном Яндекса (те же названия листов и столбцов). Старый бинарный .xls нужно предварительно пересохранить как .xlsx. Импорт из XML/YML пока не поддерживается — если у вас только XML-фид, данные придётся внести вручную или подготовить XLSX по шаблону.

XLSX и XML

XLSX — Excel-файл. Удобен для разового переноса данных или проверки в табличном виде.

XML (YML) — формат фида, который регулярно читает Яндекс. Именно ссылку на XML нужно указать в Яндекс Вебмастере (см. ниже).

Публикация

Редактирование данных в DocFeed не означает автоматическое изменение уже опубликованного фида. Порядок такой:

• вы редактируете данные — это черновик;
• запускаете проверку и исправляете ошибки;
• нажимаете «Опубликовать XML»;
• новая версия становится публичной по постоянной ссылке.

До нажатия «Опубликовать» прежняя опубликованная версия остаётся активной и доступной по той же ссылке — черновик её не затрагивает. Если нужно откатиться, можно вернуть предыдущую опубликованную версию из истории на вкладке «Фид».

Публикация XML и постоянная ссылка доступны на тарифе Clinic (990 ₽ / 30 дней). На тарифе Free можно скачивать YML и XLSX для первых 10 врачей без постоянной публичной ссылки.

Свой домен

Ссылка на фид для Яндекс Вебмастера должна находиться на домене клиники. Сделать это можно одним из двух способов:

• Размещать файл вручную. Скачайте XML (YML) из DocFeed, загрузите его на сайт клиники и передайте Яндекс Вебмастеру получившийся адрес, например https://clinic.ru/doctors.xml. После каждого обновления нужно заново скачать файл и заменить его на сайте. Сам адрес файла менять нельзя.
• Подключить CNAME. Настройте поддомен клиники, например feed.clinic.ru, на DocFeed. Тогда загружать XML на свой сервер не нужно: после нажатия «Опубликовать XML» DocFeed обновит фид по тому же адресу на домене клиники.

Настройка CNAME

Точный целевой адрес для CNAME-записи показан в приложении на вкладке «Фид» в разделе «Домен фида» — ниже используется пример.

Изменения DNS могут применяться не сразу — обычно они появляются достаточно быстро, но иногда обновление DNS может занять больше времени. Инструкция не привязана к конкретному регистратору: шаги 1–2 одинаковы у REG.RU, Cloudflare, Selectel и большинства других провайдеров, отличаются только названия разделов в их интерфейсе.

Яндекс Вебмастер

Ниже — практические шаги на основе официальной инструкции Яндекса. Названия разделов в интерфейсе Яндекс Вебмастера могут со временем измениться — если что-то не совпадает, ориентируйтесь на актуальную версию по ссылке выше.

1. Авторизуйтесь в Яндекс Вебмастере и добавьте/выберите свой сайт (нужны права администратора или доступ на управление фидами).
2. Перейдите в раздел «Услуги и предложения в поиске → Фиды и ошибки».
3. Выберите категорию бизнеса «Врачи», регион и формат «YML».
4. В поле «Ссылка на файл с предложениями» вставьте постоянный URL на домене клиники: адрес загруженного вручную файла или адрес фида на поддомене, подключённом через CNAME.
5. Нажмите «Готово».

После добавления Яндекс сам загружает и проверяет файл: структура и содержимое валидируются автоматически, а полное соответствие требованиям служба качества проверяет ещё несколько дней. DocFeed не управляет сроками этой проверки и не гарантирует принятие фида — если Яндекс Вебмастер сообщает об ошибке в разделе «Фиды и ошибки», сначала проверьте те же данные на вкладке «Фид» в DocFeed, затем сверьте текст ошибки Яндекса.

Обновление опубликованного фида

Адрес, который вы указали в Яндекс Вебмастере, должен оставаться постоянным. Дальнейшие действия зависят от способа размещения:

• без CNAME — измените данные в DocFeed, проверьте их, скачайте новый XML и вручную замените прежний файл на сайте, сохранив тот же URL;
• с CNAME — измените данные, проверьте их и нажмите «Опубликовать XML»; DocFeed обновит содержимое по прежнему URL, а Яндекс заберёт новую опубликованную версию при следующем обращении.

Частые ошибки

Я изменил врача, но XML не изменился. Изменения в DocFeed — это черновик. При подключённом CNAME нажмите «Опубликовать XML» на вкладке «Фид». При ручном размещении скачайте новый XML и замените прежний файл на сайте клиники, не меняя его адрес.

Я добавил CNAME, но DocFeed не видит домен. Скорее всего DNS ещё не обновился, либо запись настроена не так, как показано в разделе «Домен фида». Подождите и проверьте запись ещё раз.

Яндекс сообщает об ошибке фида. Сначала проверьте фид на вкладке «Фид» в DocFeed — большинство ошибок будет видно уже там. Если ошибок нет, сверьте текст сообщения Яндекса в разделе «Фиды и ошибки» Вебмастера.

У врача изменилось ФИО. Нужно менять идентификатор? Обычно нет — идентификатор создаётся один раз при добавлении врача и остаётся постоянным, чтобы не сломать связи в фиде.

У меня уже есть Excel с врачами. Не переносите данные вручную — загрузите файл через «Загрузить данные из Excel» на вкладке «Фид».

Поддержка