00 Введение

 

Что такое Кофеин

Кофеин (Caffeine) — это опенсорсный рекламный сервер, который можно развернуть у себя. Он даёт полный контроль над монетизацией: вы сами решаете, какую рекламу показывать, где её размещать и какие данные собирать.

Проект полностью открыт, весь исходный код доступен в репозитории github.com/akovardin/adscoffee. Платформа поднимается целиком через Docker Compose или запускается отдельными сервисами.

Философия проекта

  • Опенсорс и self-hosted. Никаких «чёрных ящиков»: вы всегда видите, как выбирается реклама и как обрабатываются данные. Любой компонент можно заменить на облачный или управляемый.
  • Полный контроль. Вы сами управляете всеми аспектами монетизации — от дизайна рекламных блоков до тонкой настройки таргетинга и частоты показов.
  • Этика. Реклама проектируется ненавязчивой и релевантной, без постоянного отслеживания пользователей и бессрочного хранения персональных данных.
  • Медиация. Можно одновременно подключать несколько источников: собственные кампании, прямых рекламодателей и партнёрские предложения из CPA и тизерных сетей. Платформа сама распределит показы и выберет лучший оффер.

Как это работает

  1. Вы разворачиваете платформу у себя на сервере (см. Быстрый старт).
  2. В админке создаёте сайт — площадку, на которой будет показываться реклама: сайт, документацию, репозиторий или приложение.
  3. Добавляете плейсмент — место на сайте, где будет показываться реклама, — и получаете идентификатор для интеграции.
  4. Наполняете плейсмент рекламой: создаёте рекламодателей, кампании, группы и креативы или подключаете рекламные сети через юниты и медиацию.
  5. Встраиваете рекламу на сайт (JS-виджет, баннер, нативный JSON или Android SDK) и следите за показами, переходами и доходом в аналитике.

Кому это подходит

Независимым разработчикам, владельцам open-source проектов, разработчикам приложений под Аврору и другие альтернативные ОС, а также компаниям, которые выпускают инструменты для разработчиков и хотят монетизировать их, не отдавая данные и контроль третьим лицам.

Основные возможности

  • Самостоятельное развёртывание всей платформы через Docker Compose.
  • Управление рекламодателями, кампаниями, группами, креативами и рекламными сетями.
  • Сайты, плейсменты и юниты с фильтрами и переходами между связанными сущностями.
  • Форматы креативов: баннер и интерстишел (в том числе через Android SDK).
  • Таргетинг (бандлы, гео, плейсменты, расписание), бюджеты, каппинг и лимиты показов.
  • Медиация: собственные кампании, прямые рекламодатели и партнёрские сети (включая Yandex Ads).
  • Показ рекламы через сервер (/dsp, /native, /banner, /inapp, /tracker, /postback) и SDK.
  • Аналитика на ClickHouse: часовые витрины, доход (revenue), дашборды Grafana в реальном времени.

Что такое этичная реклама

Этичная реклама — это демонстрация ненавязчивой и релевантной рекламы реальных товаров, основанной на содержимом страницы, без отслеживания пользователей.

  • Отсутствие отслеживания. Не используются постоянные рекламные cookie, личные данные не хранятся бессрочно.
  • Ориентация на контент. Реклама подбирается на основе того, что читает пользователь, а не его личности.
  • Продажа рекламы, а не данных. Рекламная сеть зарабатывает на показах, а не на продаже пользовательских данных.