Главная/Документация

Настройка расширения

Ext Ops Panel – панель управления для ваших Chrome-расширений (MV3). Расширение подключается в двух местах: hosted-пиксели, которые репортят события жизненного цикла, и опциональный эндпоинт метрик, который ваш сервис отдаёт для кастом-метрик. Эта страница – карта; у каждого раздела свой гайд.

Что подключается

1. Пиксели жизненного цикла (приём событий)

Счётчики установок, удалений и возвратов (reinstall), а также причины удаления приходят с hosted-страниц welcome и uninstall, на которые вы направляете своё расширение. Сервис аналитики вашего расширения форвардит эти события в приёмные ручки панели; локальная запись остаётся источником правды, а панель получает только агрегированные счётчики. Отсюда берутся базовые first-party метрики (установки / удаления / возвраты / фидбек / здоровье Chrome Web Store), которые видны ещё до подключения любых кастом-метрик.

Онбординг существующего расширения (пиксели welcome/uninstall, форма фидбека и reinstall-редирект) – это операторский плейбук, а не публичный API, который вы подключаете руками, поэтому точные payload'ы живут рядом с процессом онбординга. Кастом-метрики ниже – это та часть, которую вы реализуете сами.

2. Кастом-метрики (metadata-driven)

Помимо базовых метрик, сервис вашего расширения может отдавать один эндпоинт метрик, который панель пуллит. Каждая метрика несёт свою презентацию: где и как показать её на дашборде (табы, секции, тип рендера) и в Telegram-статусе (строка, позиция, формат). Панель – generic-рендерер, поэтому вы никогда не хардкодите экран или сообщение бота на нашей стороне. Это и есть формальный, задокументированный контракт.

3. Мониторинг (push-heartbeat + uptime-пинги)

Мониторинг ставит расширение под постоянное наблюдение: агент на стенде вашего сервиса пушит heartbeat-отчёты (пропуски эскалируют светофор на карточке расширения), а панель сама пингует ваши публичные URL на доступность. Отдельное Telegram статус-сообщение и edge-алерты реагируют на каждую смену цвета.