00 Введение
Что такое Кофеин
Кофеин (Caffeine) — это опенсорсный рекламный сервер, который можно развернуть у себя. Он даёт полный контроль над монетизацией: вы сами решаете, какую рекламу показывать, где её размещать и какие данные собирать.
Проект полностью открыт, весь исходный код доступен в репозитории github.com/akovardin/adscoffee. Платформа поднимается целиком через Docker Compose или запускается отдельными сервисами.
Философия проекта
- Опенсорс и self-hosted. Никаких «чёрных ящиков»: вы всегда видите, как выбирается реклама и как обрабатываются данные. Любой компонент можно заменить на облачный или управляемый.
- Полный контроль. Вы сами управляете всеми аспектами монетизации — от дизайна рекламных блоков до тонкой настройки таргетинга и частоты показов.
- Этика. Реклама проектируется ненавязчивой и релевантной, без постоянного отслеживания пользователей и бессрочного хранения персональных данных.
- Медиация. Можно одновременно подключать несколько источников: собственные кампании, прямых рекламодателей и партнёрские предложения из CPA и тизерных сетей. Платформа сама распределит показы и выберет лучший оффер.
Как это работает
- Вы разворачиваете платформу у себя на сервере (см. Быстрый старт).
- В админке создаёте сайт — площадку, на которой будет показываться реклама: сайт, документацию, репозиторий или приложение.
- Добавляете плейсмент — место на сайте, где будет показываться реклама, — и получаете идентификатор для интеграции.
- Наполняете плейсмент рекламой: создаёте рекламодателей, кампании, группы и креативы или подключаете рекламные сети через юниты и медиацию.
- Встраиваете рекламу на сайт (JS-виджет, баннер, нативный JSON или Android SDK) и следите за показами, переходами и доходом в аналитике.
Кому это подходит
Независимым разработчикам, владельцам open-source проектов, разработчикам приложений под Аврору и другие альтернативные ОС, а также компаниям, которые выпускают инструменты для разработчиков и хотят монетизировать их, не отдавая данные и контроль третьим лицам.
Основные возможности
- Самостоятельное развёртывание всей платформы через Docker Compose.
- Управление рекламодателями, кампаниями, группами, креативами и рекламными сетями.
- Сайты, плейсменты и юниты с фильтрами и переходами между связанными сущностями.
- Форматы креативов: баннер и интерстишел (в том числе через Android SDK).
- Таргетинг (бандлы, гео, плейсменты, расписание), бюджеты, каппинг и лимиты показов.
- Медиация: собственные кампании, прямые рекламодатели и партнёрские сети (включая Yandex Ads).
- Показ рекламы через сервер (
/dsp,/native,/banner,/inapp,/tracker,/postback) и SDK. - Аналитика на ClickHouse: часовые витрины, доход (
revenue), дашборды Grafana в реальном времени.
Что такое этичная реклама
Этичная реклама — это демонстрация ненавязчивой и релевантной рекламы реальных товаров, основанной на содержимом страницы, без отслеживания пользователей.
- Отсутствие отслеживания. Не используются постоянные рекламные cookie, личные данные не хранятся бессрочно.
- Ориентация на контент. Реклама подбирается на основе того, что читает пользователь, а не его личности.
- Продажа рекламы, а не данных. Рекламная сеть зарабатывает на показах, а не на продаже пользовательских данных.