Импорт и синхронизация семантического ядра

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

Предварительные требования

• У вас должен быть доступ к платформе Dataforce AI.
• Для доступа к семантике требуется роль Специалист.
• Для синхронизации с проектом требуется роль Администратора.
• Семантика (список запросов) должна быть собрана заранее — например, из Yandex Wordstat, Google Search Console или конкурентного анализа.

Примечание: В Редакторе семантики существуют два типа семантических ядер (СЯ):

• Проектные СЯ — привязаны к одному конкретному проекту. Только администратор может синхронизировать их в проект.
• Черновики (СЯ без проекта) — не связаны с проектами. Их можно создавать неограниченно, копировать, импортировать между собой, изменения в них не влияют на проекты.

Шаг 1: Импорт семантики

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

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

• Формат: CSV
• Кодировка: UTF-8
• Разделитель ячеек: ; (точка с запятой) или , (запятая)
• Макс. размер: 1 ГБ
• Обязательные поля: category, keyword, url

Структура категорий ( category )

• Путь к категории должен начинаться с / (например, /маркетинг).
• Поддерживается иерархическая структура через вложенные пути:
  /категория1/категория1-1/категория1-1-1
• Каждый уровень пути (между /) может содержать до 50 символов.
• Запрещённые символы в названиях категорий: /, ,, ;
  (символ / разрешён только как разделитель уровней, но не внутри названия уровня).

Пример корректного пути:
/услуги/международная доставка/из Китая в Россию
(уровни: услуги, международная доставка, из Китая в Россию — каждый ≤ 50 символов)

Пример некорректного пути:
/услуги,доставка/ — содержит запрещённую запятую
/услуги/доставка;/ — содержит точку с запятой
/длинное-название-категории-превышающее-пятьдесят-символов/ — превышает лимит на уровень

Структура файла

Файл может содержать до 5 колонок (порядок не важен):

Важно:

• Один запрос может быть привязан только к одной странице и только к одной категории.
• Если в файле нарушены эти правила — импорт будет отклонён.

Пример файла (в текстовом виде)

category;keyword;keyword_tag;url;url_tag
/маркетинг;"купить телефон";"смартфон;акция";http://example.com/page2;"реклама;яндекс"
/аналитика;;"SEO";http://example.com/page1;

Как импортировать

1. Нажмите синюю кнопку Импорт в верхней панели.
2. Загрузите файл (поддерживается drag-and-drop).
3. Выберите, нужно ли полностью заменить текущие данные:
   • Без галки: новые запросы добавятся, старые останутся.
   • С галкой: всё содержимое СЯ будет заменено на данные из файла.
4. Нажмите Загрузить.

Шаг 2: Работа с запросами в интерфейсе

После импорта вы можете свободно редактировать структуру.

Категоризация

• Запросы автоматически распределяются по папкам, указанным в колонке category.
• Вы можете:
  • Переместить запрос в другую папку через drag-and-drop,
  • Использовать массовое действие: выделите нужные запросы → правый клик → «Перенести в папку»,
  • Или повторно импортировать с обновлённой категорией.

Внимание: Если вы удалите папку, все запросы внутри удалятся безвозвратно (они не попадут в «Без категории»).

Теги

• Теги применяются к запросам (keyword_tag) или страницам (url_tag).
• В таблице теги отображаются цветными метками. Красный крестик — удалить тег.
• Пока нельзя управлять глобальным списком тегов (функция в разработке).
• Вы можете вручную добавлять или удалять теги прямо в ячейке, через импорт файла или пакетные действия.

Массовое редактирование

Поддерживается:

• Назначение одной страницы сразу нескольким запросам.
• Добавление одного тега ко всем выделенным запросам.
• Перенос выделенных запросов в другую категорию.

Для этого:

1. Поставьте галочки в начале строк.
2. Используйте контекстное меню которое отображается после отметки одного или нескольких запросов.

Шаг 3: Визуализация и проверка

Редактор семантики предлагает несколько режимов просмотра:

• Запросы — таблица с фразами, страницами, тегами.
• Страницы — группировка по URL.
• Папки — отображение только структуры категорий.
• Древовидный — иерархия: папка → запрос → страница.

Также доступны встроенные инструменты:

• Проверка спроса (WS) — по данным Яндекс.Вордстат.
• Просмотр SERP — как выглядит выдача по запросу в Яндексе.

Шаг 4: Синхронизация с проектом (только для проектных СЯ)

Когда структура готова:

1. Убедитесь, что вы работаете с проектным СЯ (отображается название проекта).
2. Нажмите кнопку Синхронизировать с проектом (доступна только администраторам).
3. Весь текущий состав СЯ (запросы, категории, страницы, теги) будет полностью скопирован в связанный проект.

Важно:

• Синхронизация не влияет на другие проекты.
• После синхронизации данные появятся в аналитических экранах:
  • «Цитируемые сайты»
  • «Запросы»
  • «Нейроответы» и другие отчёты

⚠️ Если вы загружаете семантическое ядро в проект впервые, после настройки обязательно нажмите кнопку «Синхронизировать с проектом». Без этого действия система не начнёт сбор данных, и отчёты не появятся.
Как проверить, что синхронизация прошла успешно:

1. Перейдите в раздел «Запросы» проекта.
2. Подождите несколько минут.
3. Если данные из вашего СЯ отобразились в списке — синхронизация прошла успешно, сбор данных запущен.
4. Если раздел пуст — вероятно, кнопка синхронизации не была нажата. Вернитесь к ядру и выполните синхронизацию.

Распространённые ошибки

Частые вопросы (FAQ)

Вопрос: Почему в колонке «Запросы» везде написано «Скоро…»?
Ответ: Функция подсчёта и отображения точного количества запросов в ядре находится в стадии активной разработки. Она появится в одном из будущих обновлений.

Вопрос: Мне нужно добавить новые запросы в проект. Как правильно это сделать?
Ответ: 1) Найдите и откройте соответствующее проектное ядро. 2) Добавьте в него новые запросы. 3) Попросите администратора выполнить операцию Синхронизировать с проектом из контекстного меню этого ядра.

Вопрос: Я специалист и не вижу кнопку синхронизации. Почему?
Ответ: Операция синхронизации доступна только пользователям с ролью Администратор в данном рабочем пространстве. Это сделано для контроля над изменениями, попадающими в рабочие проекты.

Вопрос: Категорию запроса мы сами задаём при загрузке? И потом можно менять?
Ответ: Да, категорию задаёт пользователь — система не расставляет категории автоматически. При загрузке категория указывается в обязательной колонке category файла CSV (например, /услуги/доставка). После загрузки изменить категорию можно тремя способами:

• Drag-and-drop — перетащите запрос в нужную папку в левом сайдбаре.
• Массовое действие — отметьте запросы галочками → правый клик → «Перенести в папку».
• Повторный импорт — загрузите обновлённый CSV с новым значением category.

⚠️ Важно: Если вы удалите папку, все запросы внутри удалятся безвозвратно — они не попадут в «Без категории». Перед удалением папки обязательно перенесите запросы в другую категорию.

Вопрос: Дублей лучше избегать? Если запрос подходит под два кластера — выбрать один?
Ответ: Да, дублей нужно избегать — это техническое ограничение системы. Один запрос (keyword) может быть привязан только к одной категории и только к одной посадочной странице. Если в файле один запрос встречается с двумя разными значениями category или url — импорт будет отклонён.

Если запрос логически подходит под два кластера, выберите основной — наиболее релевантный. Ориентируйтесь на:

• главную тему запроса,
• посадочную страницу, которая лучше отвечает на этот запрос,
• приоритетность кластера для бизнеса.