Hybrid: ИИ-агент для рекламы и отчётности

Hybrid — programmatic-платформа и adtech-сервис для медиазакупки. Карточка о том, как подключить к её API агента: она для маркетолога, который ведёт несколько рекламодателей и сводит отчёты руками.

Агент — программа, которая делает дело целиком, а не отвечает на вопрос: работает в ваших сервисах, доводит до результата и не ждёт, пока его окликнут. Чат-бот вернёт текст, агент вернётся с результатом.

Коннектор — описание подключения: где взять client_id и client_secret, как проверить связь и какие данные доступны. Это не плагин и не доработка: секрет агент не хранит дольше токена.

В Hybrid API авторизация идёт по протоколу Bearer: для пользователя создаётся клиент с client_id и client_secret, по ним выдаётся access token. grant_type=client_credentials создаёт токен, refresh_token меняет просроченный, каждый живёт 24 часа (expires_in). Для Global API нужно обратиться к менеджеру.

### Реклама на площадке: доля расходов и ставки

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

### Отчёт по каналам: откуда трафик

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

### Каналы: что сработало и что усилить

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

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

Нужны client_id и client_secret: их выдаёт менеджер Hybrid по запросу на support@hybrid.ai, для Global API нужно отдельное обращение. Токен запрашивается с client_credentials и живёт 24 часа; секреты в переписку не пересылаются.

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

Что такое агент, если коротко? Программа, которая делает дело целиком: забирает статистику по рекламодателям, считает доли и отдаёт отчёт, а не отвечает на вопрос. От чат-бота отличается тем, что работает без вас и по расписанию, и сама доводит расчёт до конца.

Что такое коннектор? Описание подключения: где взять client_id и client_secret, как проверить связь и какие данные доступны. Не плагин и не доработка — выданный доступ, который можно отозвать. Секрет агент не хранит дольше токена.

Почему токен обновляется каждые сутки? Так устроен протокол: access token живёт 24 часа, это указано в expires_in. Агент обновляет его сам по refresh_token, поэтому работа не простаивает. Если ключи отозваны, он остановится и скажет об этом.