# Массовое изменение категорий запросов

Источник: https://docs.dataforce.io/articles/changing-categories

## О чём эта статья

В этой статье описан способ **массового изменения категорий** у поисковых запросов в Редакторе семантики через импорт отредактированного CSV-файла.

Этот метод рекомендуется использовать, когда необходимо:

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

> **Важно:** После синхронизации СЯ с проектом **вся история сборов в проекте сохранится**. Изменение категорий не влияет на накопленные данные.

---

## Подготовка к работе

### Требования к доступу

| Роль | Доступ к операции |
| --- | --- |
| **Специалист** | Может экспортировать и импортировать СЯ |
| **Администратор** | Может выполнять импорт и синхронизацию с проектом |

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

Перед редактированием убедитесь, что файл соответствует требованиям:

| Параметр | Значение |
| --- | --- |
| **Формат** | CSV |
| **Кодировка** | UTF-8 |
| **Разделитель ячеек** | `;` (точка с запятой) или `,` (запятая) |
| **Обязательные поля** | `category`, `keyword`, `url` |

### Требования к структуре категорий

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

---

## Пошаговая инструкция

### Шаг 1: Откройте семантическое ядро

Перейдите к нужному семантическому ядру в Редакторе семантики.

**Пример URL:**

```
https://direct.dataforce.io/spaces/{ID_пространства}/mus/{ID_ядра}
```

> **Совет:** Если вы работаете с проектным СЯ, убедитесь, что у вас есть права на синхронизацию (роль «Администратор»).

---

### Шаг 2: Экспортируйте текущее СЯ в CSV

1. В верхней панели интерфейса найдите кнопку **`⋮`** (три точки) или меню действий.
2. Выберите опцию **`Скачать CSV`**.
3. Файл будет загружен на ваше устройство.

![2025-12-11_00-28-55.png](https://docs.dataforce.io/wp-media/2026/08/2025-12-11_00-28-55.png)

---

### Шаг 3: Отредактируйте файл

1. Откройте скачанный CSV-файл в текстовом редакторе или таблице (Excel, Google Sheets, LibreOffice Calc).
2. Найдите колонку **`category`**.
3. Измените пути категорий у нужных запросов.

#### Пример изменения

**До:**

```csv
category;keyword;url
/услуги/доставка;запрос 1;https://example.com/page1
/услуги/доставка;запрос 2;https://example.com/page2
/товары/электроника;запрос 3;https://example.com/page3
```

**После (изменена вложенность):**

```csv
category;keyword;url
/услуги/логистика/доставка по России;запрос 1;https://example.com/page1
/услуги/логистика/доставка по России;запрос 2;https://example.com/page2
/товары/бытовая техника;запрос 3;https://example.com/page3
```

#### Пример корректного пути категории

```
/услуги/международная доставка/из Китая в Россию
```

Уровни: `услуги` → `международная доставка` → `из Китая в Россию` (каждый ≤ 50 символов)

#### Примеры некорректных путей

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

---

### Шаг 4: Сохраните файл

1. Сохраните изменения в файле.
2. Убедитесь, что кодировка осталась **UTF-8**.
3. Проверьте, что разделитель ячеек не изменился (должен быть `;` или `,`).

> **Внимание:** Если вы используете Excel, при сохранении убедитесь, что файл не был конвертирован в неверную кодировку. Рекомендуется использовать текстовые редакторы (Notepad++, VS Code) или Google Sheets.

---

### Шаг 5: Импортируйте изменённый файл

1. Вернитесь в интерфейс семантического ядра.
2. Нажмите синюю кнопку **`Импорт`** в верхней панели.
3. Загрузите изменённый CSV-файл (поддерживается **drag-and-drop**).
4. **Установите галочку** «Полностью заменить текущие данные» (или «Полная замена»).
   > **Без галочки:** новые запросы добавятся, старые останутся (дубли могут вызвать ошибки).
   >
   > **С галочкой:** всё содержимое СЯ будет заменено на данные из файла (**рекомендуется для этого сценария**).
5. Нажмите кнопку **`Загрузить`**.

![2025-12-16_17-30-19.png](https://docs.dataforce.io/wp-media/2026/08/2025-12-16_17-30-19.png)

---

### Шаг 6: Синхронизируйте СЯ с проектом (если нужно)

Если вы работаете с **проектным СЯ**, выполните синхронизацию:

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)

> **Готово!** После синхронизации вся история сборов в проекте сохранится. Изменения в категориях не повлияют на накопленные данные.

---

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

| Ошибка | Причина | Как избежать |
| --- | --- | --- |
| **Импорт отклонён** | Один запрос привязан к двум страницам или категориям | Убедитесь, что `keyword` уникален в рамках `url` и `category` |
| **Символы не распознаны** | Использованы запрещённые символы (`/`, `,`, `;`) в категориях | Удалите символы или замените на допустимые (например, нижнее подчёркивание) |
| **Некорректное отображение** | Неправильная кодировка или разделитель | Сохраните файл в UTF-8 и используйте `;` как разделитель |
| **Дубли запросов** | Один `keyword` встречается с разными `category` или `url` | Убедитесь, что каждый запрос уникален в рамках файла |

---

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

**Вопрос:** Сохранится ли история сбора данных после изменения категорий? **Да, сохранится.** История сборов привязана к проекту, а не к структуре категорий. После синхронизации СЯ с проектом все накопленные данные останутся доступными в отчётах. **Вопрос:** Что будет, если не поставить галочку «Полная замена»? **Без галочки** система добавит новые запросы к существующим. Если в файле есть запросы, которые уже присутствуют в СЯ, но с другими категориями, возникнет конфликт (один запрос не может принадлежать двум категориям), и импорт будет отклонён. **С галочкой** текущее содержимое СЯ будет полностью заменено на данные из файла. Это рекомендуемый вариант для массового изменения категорий. **Вопрос:** Можно ли восстановить предыдущую структуру категорий? Да, для этого: Перед редактированием **сделайте резервную копию** экспортированного CSV-файла. Если потребуется откат — импортируйте резервный файл с галочкой «Полная замена». **Вопрос:** Почему импорт отклонён с ошибкой «Один запрос привязан к двум категориям»?

2026 Dataforce ADS. Все права защищены. | Powered by [Wiki.js](https://wiki.js.org/)
