Создание и проверка карты спроса

Эта инструкция ведёт от пустой формы до опубликованного файла и объясняет, как читать статистику после обучения.

Перед началом

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

1. Какой результат считать спросом: конверсию, выручку или чистую прибыль?
2. Какие плюс-цели и моделируемые конверсии представляют хороший результат?
3. Какие минус-сигналы представляют спам, отмену или плохое качество?
4. Какая внешняя система получит файл и какие аудиторные признаки она умеет различать?

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

Шаг 1. Создайте карту

Откройте Реклама → Карта спроса и нажмите Создать карту.

Задайте понятное назначение в названии, например:

• «РКО для малого бизнеса»;
• «Ипотека — чистая прибыль»;
• «Медийный коммерческий интерес».

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

Шаг 2. Выберите метрику

Метрика	Когда выбирать	Важное условие
Количество конверсий	Все хорошие конверсии примерно равноценны	Цель должна надёжно фиксировать сам факт результата
Выручка	Размер заказа важнее числа заказов	У конверсий должна быть заполнена сопоставимая выручка
Чистая прибыль	Маржинальность различается и известны затраты	Значение прибыли должно быть корректным и может быть отрицательным

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

Шаг 3. Настройте сигналы

Плюс-сигналы

Добавьте цели оптимизации и/или моделируемые конверсии, которые означают нужный бизнес-результат. Они включают режим цели проекта.

Пример для банка:

+ оформлена заявка на РКО
+ моделируемая вероятность одобрения
- спам-заявка
- отказ клиента до контакта

Минус-сигналы

Минус-цели не являются отдельным спросом: они вычитают массу у сегмента. Не добавляйте обычное отсутствие конверсии как минус-цель — это и так отражено в данных.

Без собственных целей

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

Шаг 4. Ограничьте область условием

Нажмите Задать условие, если карта должна обучаться не на всём проекте. Сначала сохраните новую карту: условие привязывается к её ID.

Хорошее условие отвечает на вопрос «где эта карта применима?»:

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

Не повторяйте в условии будущую сегментацию. Например, если партнёр умеет различать города, не нужно создавать отдельную карту на каждый город только ради этого — выберите ось city в интеграции.

Шаг 5. Выберите окно обучения

Окно задаёт, сколько последних дней участвует в расчёте. В текущем интерфейсе доступно от 14 до 180 дней. Внутри окна свежие данные весят сильнее, поэтому устаревший всплеск постепенно теряет влияние.

Практический выбор:

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

Это бизнес-выбор области истории. Порог достаточности и структура сегментов остаются самоадаптивными.

Шаг 6. Добавьте интеграцию

Карта может обучаться без интеграции, но файл тогда никуда не публикуется. Откройте блок интеграций и выберите профиль.

Готовый профиль партнёра

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

Например, профиль Gradius принимает интерес и географию: interest, country, region, city.

Своя интеграция

Выберите Своя интеграция, если файл разбирает ваша система. Отметьте только те оси, значения которых вы реально сможете определить во время показа.

Плохой пример: включить operatingSystemMajorVersion, но не передавать версию ОС в сопоставление. Такая ветка никогда не совпадёт и полезный трафик получит ноль.

Максимум сегментов

Укажите фактический лимит принимающей системы. Чем выше лимит, тем детальнее может быть карта, но тем больше файл и дороже сопоставление. Sales Ninja строит карту сразу под этот предел; партнёр не должен молча обрезать готовый файл.

Шаг 7. Сохраните и запустите обучение

После сохранения в списке появится действие Начать обучение. Запуск не ждёт расчёт в открытом запросе: карта ставится в очередь, а список обновляет состояние.

Состояние	Что означает
Обучение не запускалось	Ещё нет снапшота, статистики и ссылки
В очереди на обучение	Запрос принят и ждёт выполнения
Обучается	Идёт одна из фаз расчёта
Обучена	Новый снапшот и выгрузки опубликованы
Обучение не удалось	Новый расчёт не опубликован; смотрите ошибку и повторите после исправления

Фазы активного расчёта:

1. читаем данные;
2. строим карту;
3. публикуем выгрузки.

Не запускайте второй расчёт, пока первый активен. После первого успеха карточка покажет дату, долю трафика, долю спроса и число сегментов.

Шаг 8. Передайте постоянную ссылку

У опубликованной интеграции появляется действие Скопировать ссылку. Передайте именно этот адрес партнёру. Не скачивайте один файл для постоянного ручного размещения: ссылка остаётся прежней, а содержимое обновляется.

Партнёр должен ориентироваться на container.generatedOnUtc, сохранить последний успешно разобранный файл и не удалять его из-за временной сетевой ошибки.

Статистика

Откройте Статистика на карточке или в шапке редактора.

Обзор

Показатель	Как читать
Доля трафика	Какая часть исходного трафика попала в сегменты, разрешённые к показу
Спроса в них	Какая часть выбранной метрики сосредоточена в разрешённом трафике
Плотность спроса	Отношение доли спроса к доле трафика; во сколько раз карта плотнее случайного отбора
Сегментов	Сколько непересекающихся правил опубликовано
Осей в разрезе	Сколько осей реально пригодилось текущему дереву
Остывающих	Сколько сегментов потеряло спрос к концу окна
Самый плотный	Максимальный коэффициент среди найденных сегментов

Пример:

Доля трафика: 31,8%
Спроса в них: 64,1%
Плотность спроса: ×2,02

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

Покрытие и отдача

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

Дерево сегментов

Ветка уточняет родителя. У узла с коэффициентом число относится к остатку этой ветки после исключения показанных потомков. Узел без собственного коэффициента служит маршрутом к потомкам; его неперечисленный остаток равен нулю.

Пример:

device=desktop                    ×1.35
└─ browser=safari                 ×4.82
└─ browser=outdated_browser       ×0 (исключён)

• desktop + safari → 4.82;
• desktop + chrome → 1.35;
• desktop + outdated_browser → 0;
• smartphone → 0, если другой ветки нет.

Самые горячие сегменты

Таблица сортирует сегменты по вкладу в спрос: объём умножается на превышение над средним. Поэтому маленький сегмент с огромным коэффициентом не обязательно будет выше крупного сегмента с умеренным коэффициентом.

Фильтры позволяют искать значения, выбирать условия и минимальный коэффициент. Они меняют только представление статистики, а не опубликованный файл.

Распределение и история

Распределение показывает, какой объём трафика находится в диапазонах коэффициентов. История сравнивает долю трафика и долю спроса между версиями. Резкий скачок — повод проверить цели, условие, окно и изменения входных данных, а не вручную «сглаживать» коэффициенты у партнёра.

Показатель ещё не измерен

После первого расчёта может не хватать независимой будущей истории для честной оценки качества. В таком случае кабинет показывает прочерк и пояснение. Это не нулевой эффект и не ошибка файла — просто результат ещё нельзя измерить.

Как менять работающую карту

• Смена метрики или плюс-сигналов меняет сам смысл спроса; зафиксируйте это как новую интерпретацию статистики.
• Смена условия меняет исходную аудиторию, поэтому доли до и после нельзя сравнивать как одинаковую базу.
• Добавление оси расширяет пространство поиска, но ось может не попасть в результат, если не разделяет спрос.
• Уменьшение лимита сегментов делает карту грубее; партнёр должен принять новую версию целиком.
• Выключение карты останавливает новые расчёты, но не удаляет уже опубликованный файл.

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

Диагностика

Нет статистики и ссылки

Проверьте, запускалось ли обучение и завершилось ли оно успешно. Ссылка появляется только после первой публикации конкретной интеграции.

Интеграция не предлагает нужную ось

Профиль партнёра не умеет её принимать. Выберите другую поддерживаемую ось или согласуйте новый контракт с партнёром; выбор своей интеграции не добавит возможность в чужую систему.

В файле меньше осей, чем выбрано

Это нормально: taxonomy.conditionKeys содержит оси, реально использованные в этом снапшоте. Не давшая полезного разделения ось не публикуется.

Сегментов мало

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

Новый расчёт завершился ошибкой

Исправьте причину и повторите обучение. По постоянной ссылке при этом остаётся последний валидный файл — партнёру не нужно переключать адрес.

Партнёр получает слишком много нулей

Убедитесь, что во время показа у него доступны все поля из taxonomy.conditionKeys и значения нормализованы по общему разделу справочников. Неизвестное значение или неполный путь не должны случайно совпадать с более широким сегментом.

Для реализации чтения файла используйте контракт контейнера.