# Импорт и синхронизация семантического ядра Источник: https://docs.dataforce.io/articles/semantics-keywords Вы открыли конкретное семантическое ядро — теперь можно детально работать с его содержимым: импортировать новые запросы, структурировать их по категориям, добавлять теги и готовить ядро к синхронизации с проектом. --- ## Предварительные требования - У вас должен быть доступ к платформе Dataforce ADS. - Для доступа к семантике требуется роль **Специалист**. - Для синхронизации с проектом требуется роль **Администратора**. - Семантика (список запросов) должна быть собрана заранее — например, из Yandex Wordstat, Google Search Console или конкурентного анализа. > **Примечание:** В Редакторе семантики существуют два типа семантических ядер (СЯ): > > - **Проектные СЯ** — привязаны к одному конкретному проекту. Только администратор может синхронизировать их в проект. > - **Черновики (СЯ без проекта)** — не связаны с проектами. Их можно создавать неограниченно, копировать, импортировать между собой, изменения в них не влияют на проекты. --- ## Шаг 1: Импорт семантики Вы можете загрузить запросы из файла или добавлять их вручную через интерфейс. ### Требования к файлу - **Формат**: CSV - **Кодировка**: UTF-8 - **Разделитель ячеек**: `;` (точка с запятой) **или** `,` (запятая) - **Макс. размер**: 1 ГБ - **Обязательные поля**: `category`, `keyword`, `url` ### Структура категорий ( category ) - Путь к категории **должен начинаться с `/`** (например, `/маркетинг`). - Поддерживается **иерархическая структура** через вложенные пути: `/категория1/категория1-1/категория1-1-1` - **Каждый уровень пути** (между `/`) может содержать **до 50 символов**. - **Запрещённые символы** в названиях категорий: `/`, `,`, `;` (символ `/` разрешён **только как разделитель уровней**, но не внутри названия уровня). > **Пример корректного пути**: > `/услуги/международная доставка/из Китая в Россию` > (уровни: `услуги`, `международная доставка`, `из Китая в Россию` — каждый ≤ 50 символов) > **Пример некорректного пути**: > `/услуги,доставка/` — содержит запрещённую запятую > `/услуги/доставка;/` — содержит точку с запятой > `/длинное-название-категории-превышающее-пятьдесят-символов/` — превышает лимит на уровень ### Структура файла Файл может содержать до 5 колонок (порядок не важен): | Колонка | Описание | Ограничения | | --- | --- | --- | | `category` | Путь к папке (начинается с `/`) | До 50 символов на уровень. Нельзя использовать `/`, `,`, `;` | | `keyword` | Поисковый запрос | До 400 символов | | `keyword_tag` | Теги для запроса | До 255 символов на тег. Разделяются `;`. Нельзя использовать `,`, `;` внутри тега | | `url` | Посадочная страница | До 700 символов | | `url_tag` | Теги для URL | До 255 символов на тег. Разделяются `;`. Нельзя использовать `,`, `;` внутри тега | > **Важно:** > > - Один запрос может быть привязан **только к одной странице** и **только к одной категории**. > - Если в файле нарушены эти правила — импорт будет отклонён. ### Пример файла (в текстовом виде) ```csv category;keyword;keyword_tag;url;url_tag /маркетинг;"купить телефон";"смартфон;акция";http://example.com/page2;"реклама;яндекс" /аналитика;;"SEO";http://example.com/page1; ``` ### Как импортировать 1. Нажмите синюю кнопку **`Импорт`** в верхней панели. 2. Загрузите файл (поддерживается **drag-and-drop**). 3. Выберите, нужно ли **полностью заменить** текущие данные: - **Без галки**: новые запросы добавятся, старые останутся. - **С галкой**: всё содержимое СЯ будет заменено на данные из файла. 4. Нажмите **`Загрузить`**. ![2025-12-16_17-30-19.png](https://docs.dataforce.io/wp-media/2026/08/2025-12-16_17-30-19.png) ## Шаг 2: Работа с запросами в интерфейсе После импорта вы можете свободно редактировать структуру. ### Категоризация - Запросы автоматически распределяются по папкам, указанным в колонке `category`. - Вы можете: - **Переместить запрос** в другую папку через **drag-and-drop**, - Использовать **массовое действие**: выделите нужные запросы → правый клик → «Перенести в папку», - Или **повторно импортировать** с обновлённой категорией. ![запись_2025-12-16_173804.gif](https://docs.dataforce.io/wp-media/2026/08/D0B7D0B0D0BFD0B8D181D18C_2025-12-16_173804.gif) > **Внимание:** Если вы **удалите папку**, все запросы внутри **удалятся безвозвратно** (они не попадут в «Без категории»). ### Теги - Теги применяются к запросам (`keyword_tag`) или страницам (`url_tag`). - В таблице теги отображаются цветными метками. Красный крестик — удалить тег. - Пока **нельзя** управлять глобальным списком тегов (функция в разработке). - Вы можете **вручную добавлять или удалять теги** прямо в ячейке, через импорт файла или пакетные действия. ### Массовое редактирование Поддерживается: - Назначение **одной страницы** сразу нескольким запросам. - Добавление **одного тега** ко всем выделенным запросам. - Перенос выделенных запросов в другую категорию. Для этого: 1. Поставьте галочки в начале строк. 2. Используйте контекстное меню которое отображается после отметки одного или нескольких запросов. ![2025-12-16_17-45-19.png](https://docs.dataforce.io/wp-media/2026/08/2025-12-16_17-45-19.png) --- ## Шаг 3: Визуализация и проверка Редактор семантики предлагает несколько режимов просмотра: - **`Запросы`** — таблица с фразами, страницами, тегами. - **`Страницы`** — группировка по URL. - **`Папки`** — отображение только структуры категорий. - **`Древовидный`** — иерархия: папка → запрос → страница. Также доступны встроенные инструменты: - **Проверка спроса (WS)** — по данным Яндекс.Вордстат. - **Просмотр SERP** — как выглядит выдача по запросу в Яндексе. ![2025-12-16_17-47-54.png](https://docs.dataforce.io/wp-media/2026/08/2025-12-16_17-47-54.png) --- ## Шаг 4: Синхронизация с проектом (только для проектных СЯ) Когда структура готова: 1. Убедитесь, что вы работаете с **проектным СЯ** (отображается название проекта). 2. Нажмите кнопку **`Синхронизировать с проектом`** (доступна только администраторам). 3. Весь текущий состав СЯ (запросы, категории, страницы, теги) будет **полностью скопирован** в связанный проект. ![2025-12-16_17-49-14.png](https://docs.dataforce.io/wp-media/2026/08/2025-12-16_17-49-14.png) > **Важно:** > > - Синхронизация **не влияет** на другие проекты. > - После синхронизации данные появятся в аналитических экранах: > - «[Конкуренты](https://docs.dataforce.io/articles/soi-competitors)» > - «[Статистика](https://docs.dataforce.io/articles/statistika)» ⚠️ Если вы загружаете семантическое ядро в проект впервые, после настройки обязательно нажмите кнопку «**Синхронизировать с проектом**». Без этого действия система не начнёт сбор данных, и статистика не появится. **Как проверить, что синхронизация прошла успешно:** 1. Перейдите в раздел [«Запросы»](https://docs.dataforce.io/articles/keywords) проекта. 2. Подождите несколько минут. 3. Если данные из вашего СЯ отобразились в списке — синхронизация прошла успешно, сбор данных запущен. 4. Если раздел пуст — вероятно, кнопка синхронизации не была нажата. Вернитесь к ядру и выполните синхронизацию. --- ### Распространённые ошибки | Ошибка | Причина | Как избежать | | --- | --- | --- | | Импорт отклонён | Один запрос привязан к двум страницам или категориям | Убедитесь, что `keyword` уникален в рамках `url` и `category` | | Символы не распознаны | Использованы запрещённые символы (`/`, `,`, `;`) в категориях или тегах | Удалите символы или замените на допустимые (например, нижнее подчёркивание) | | Некорректное отображение | Неправильная кодировка или разделитель | Сохраните файл в UTF-8 и используйте `;` как разделитель | ## Частые вопросы (FAQ) **Вопрос:** Почему в колонке «Запросы» везде написано «Скоро…»? **Ответ:** Функция подсчёта и отображения точного количества запросов в ядре находится в стадии активной разработки. Она появится в одном из будущих обновлений. --- **Вопрос:** Мне нужно добавить новые запросы в проект. Как правильно это сделать? **Ответ:** 1) Найдите и откройте соответствующее **проектное ядро**. 2) Добавьте в него новые запросы. 3) Попросите **администратора** выполнить операцию **`Синхронизировать с проектом`** из контекстного меню этого ядра. --- **Вопрос:** Я специалист и не вижу кнопку синхронизации. Почему? **Ответ:** Операция синхронизации доступна только пользователям с ролью **Администратор** в данном рабочем пространстве. Это сделано для контроля над изменениями, попадающими в рабочие проекты. --- **Вопрос:** Категорию запроса мы сами задаём при загрузке? И потом можно менять? **Ответ:** Да, категорию задаёт пользователь — система не расставляет категории автоматически. При загрузке категория указывается в обязательной колонке `category` файла CSV (например, `/услуги/доставка`). После загрузки изменить категорию можно тремя способами: - **Drag-and-drop** — перетащите запрос в нужную папку в левом сайдбаре. - **Массовое действие** — отметьте запросы галочками → правый клик → «Перенести в папку». - **Повторный импорт** — загрузите обновлённый CSV с новым значением `category`. > ⚠️ **Важно:** Если вы удалите папку, все запросы внутри **удалятся безвозвратно** — они не попадут в «Без категории». Перед удалением папки обязательно перенесите запросы в другую категорию. --- **Вопрос:** Дублей лучше избегать? Если запрос подходит под два кластера — выбрать один? **Ответ:** Да, дублей нужно избегать — это техническое ограничение системы. Один запрос (`keyword`) может быть привязан **только к одной категории** и **только к одной посадочной странице**. Если в файле один запрос встречается с двумя разными значениями `category` или `url` — **импорт будет отклонён**. Если запрос логически подходит под два кластера, выберите **основной** — наиболее релевантный. Ориентируйтесь на: - главную тему запроса, - посадочную страницу, которая лучше отвечает на этот запрос, - приоритетность кластера для бизнеса.