# Настроить маппинг источника: дата, метрики и разрезы

> **Коротко.** Отметьте колонку даты, метрики и разрезы, выключите лишнее и нажмите «Применить маппинг». Пять минут, без этого не работают обзор, прогноз и модель.

Адрес: https://marfor.pro/docs/data/mapping/roles · Раздел: Данные: от таблицы до проверенного источника › Маппинг: дата, метрики и разрезы › Настроить маппинг источника: дата, метрики и разрезы · Вид: Инструкция · Уровень: для начинающих · Обновлено: 2026-10-14

Маппинг говорит MARFOR, что лежит в каждой колонке источника. После «Применить маппинг» таблица пересобирается по вашей разметке, и с ней начинают работать «Обзор данных», прогноз и модель. На небольшой файл уходит пять минут.

## Что нужно заранее {#before}

- Источник уже загружен: файл, ссылка или коннектор. Как загрузить — в разделе [Источники данных](https://marfor.pro/docs/data/sources).
- Право менять проект: владелец или участник с правом редактирования.
- В таблице есть дата или пара колонок «год» и «месяц».

## Шаги {#steps}

1. Откройте «Источники данных» и на карточке источника нажмите «Настроить маппинг». Если источников несколько, на экране «Настройки маппинга» вверху есть переключатель «Источник:».
2. Посмотрите «Предпросмотр данных». Колонки должны разделиться верно. Слиплись в одну — поменяйте «Разделитель:». Вместо букв непонятные знаки — выберите «Кодировка:» → «Windows-1251». Таблица начинается не с первой строки — поправьте «Строка заголовков:» и «Данные с строки:».
3. В блоке «Маппинг колонок» найдите колонку даты и выберите ей «Временной ряд» → «Дата». Роль сама станет Dimension. Даты нет, но есть год и номер месяца — отметьте этим колонкам «Год» и «Месяц».
4. Остальным колонкам дайте «Роль»: числа, которые складываются, — Metric (расходы, клики, заказы, выручка); разрезы — Dimension (канал, регион, категория). Как решить спорные случаи — [Роль колонки](https://marfor.pro/docs/data/mapping/column-roles).
5. Снимите галочку слева у всего, что не нужно: доли и проценты, средние, ID с тысячами значений, служебные колонки.
6. «Настройки обработки данных» оставьте как есть. Галочка «Числа с пробелами → числа» должна быть включена — так и стоит по умолчанию.
7. Нажмите «Применить маппинг». Если маппинг уже применяли, кнопка называется «Обновить маппинг». Пока таблица пересобирается, кнопка занята; большой источник собирается несколько минут.


> [!Совет]
> Помощник есть прямо на экране: круглая кнопка справа внизу открывает «Машинист: маппинг данных». «🔬 Автоанализ» предложит роли, «✅ Применить рекомендации» заполнит таблицу. Проверьте его выбор глазами и только потом нажмите «Применить маппинг».

## Как понять, что получилось {#result}

- Вверху появилось «Маппинг применен успешно!», а через пару секунд открылся «Обзор данных».
- В «Обзоре данных» в списке «Метрики» есть все колонки с ролью Metric, а в фильтрах — годы и месяцы из ваших дат.
- В «Метриках и правилах» у источника стоит отметка «Маппинг применён».

Из даты MARFOR сам строит год, полугодие, квартал и месяц, у дневных данных — ещё неделю. Обновления источника по расписанию дальше применяют этот маппинг сами.

## Что дальше {#next}

1. [Проверьте данные в «Обзоре данных»](https://marfor.pro/docs/data/mapping/check): итоги по месяцам должны совпасть с вашим отчётом.
2. Заведите ДРР, CAC и средний чек [вычисляемыми полями](https://marfor.pro/docs/data/metrics/derived).
3. Если данные лежат в нескольких источниках — соберите их [Блендером](https://marfor.pro/docs/data/blender/basics).

## Если не получилось {#if-failed}

- **«Маппинг применен, но есть предупреждения.»** Под кнопкой — список «Внимание:». Строка «В данных не указан временной период (дата, год, месяц)…» значит, что ни одной колонке не выбран «Временной ряд». Вернитесь к шагу 3.
- **«Удалено N строк с невалидными датами в колонке '…'»** — в этих строках дата не разобрана. Причины и решение — [Даты перепутались или строки пропали](https://marfor.pro/docs/data/mapping/dates-wrong).
- **«Маппинг применён к превью (N строк). Выберите файл для полного импорта.»** — источник — большой файл, загружено только начало. Выберите тот же файл и нажмите «Начать полный импорт».
- **«Маппинг уже применяется — идёт пересборка таблицы»** — маппинг этого источника уже пересобирается, например из другой вкладки. Дождитесь окончания.
- **«Статус применения маппинга потерян. Обновите страницу и повторите.»** — обновите страницу; если таблица успела собраться, повторять не нужно.
- **«Blended источники нельзя изменять…»** — это бленд: его колонки задаются в Блендере, а роли он получает сам. Подробно — [Бленд](https://marfor.pro/docs/data/blender/overview).
- **«Не найдены данные источника…»** — у источника нет ни файла, ни таблицы. Загрузите файл заново.
- Колонку переименовали в поле «Колонка» и она пропала из обзора — верните прежнее имя. Нужное имя лучше задать заголовком в файле до загрузки: на имена колонок потом ссылаются формулы и модели.

Не помогло — нажмите «Сообщить о проблеме» и приложите название источника, текст сообщения и снимок экрана «Маппинг колонок».

## Связанные

- [Роль колонки: Metric или Dimension](https://marfor.pro/docs/data/mapping/column-roles)
- [Даты в источнике: какие записи понимает MARFOR](https://marfor.pro/docs/data/mapping/dates)
- [Поля экрана «Настройки маппинга»: справочник](https://marfor.pro/docs/data/mapping/fields)
- [Проверить данные в «Обзоре данных»](https://marfor.pro/docs/data/mapping/check)
- [Создать вычисляемое поле: CRR, ДРР, CAC, средний чек](https://marfor.pro/docs/data/metrics/derived)