Skip to content

Jew-Yeah/marketing-response-engine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MMM Response Engine

Marketing Mix Modeling toolkit for marginal response curves, baseline control and budget analysis.

Проект реализует минимальный воспроизводимый пайплайн MMM:

  • загрузка и препроцессинг данных,
  • обучение модели,
  • оценка качества,
  • построение response curves по каналам,
  • текстовый CLI-интерфейс.

Цель проекта — получить интерпретируемые кривые отклика рекламных каналов в реальных величинах.


Структура проекта

  • core/
  • data/
  • output/
  • main.py
  • baseline.py
  • requirements.txt

Установка

bash
pip install -r requirements.txt

Запуск

python main.py

С параметрами:

python main.py --baseline median
python main.py --baseline min
python main.py --baseline zero
python main.py --no-show


Параметры

Параметр Описание
--baseline Как фиксируются остальные каналы: median / min / zero
--test-size Доля тестовой выборки
--no-show Не показывать графики, только сохранить PNG
--dataset Имя CSV-файла в папке data/

Baseline модель

python baseline.py

Используется линейная регрессия как простая базовая модель для сравнения.


Что такое baseline

При построении response curves фиксируются остальные каналы:

Sales = f(Channel_i = b, OtherChannels = baseline)

Варианты:

  • median — остальные каналы на медиане (рекомендуется)
  • min — остальные каналы на минимуме
  • zero — остальные каналы обнулены

Baseline определяет контекст интерпретации кривых.


Выходные данные

В папке output/ сохраняются:

  • response_tv_median.png
  • response_radio_median.png
  • response_newspaper_median.png

Каждый график:

  • ось X — бюджет канала ($),
  • ось Y — прогноз продаж ($).

Методология

Используется:

  • GradientBoostingRegressor,
  • стандартизация X и y,
  • обратное масштабирование для интерпретации,
  • median baseline для частичной зависимости.

Проект аппроксимирует:

E[Sales | Channel_i = b]


Ограничения

  • Не учитывается временная динамика.
  • Нет adstock / carryover эффектов.
  • Нет причинной идентификации.
  • Кривые условные, а не каузальные.

Назначение проекта

Проект предназначен для:

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

Лицензия

MIT

About

Движок Marketing Mix Modeling для построения кривых отклика и анализа рекламных бюджетов

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages