Установка виджета

Последнее обновление: 8 сентября 2026

Виджет Cookiestack подключается одним тегом <script> — без сборки, npm-пакетов или изменений в вашем коде. Занимает 2–3 минуты.

1. Получите API-ключ

Зарегистрируйтесь и добавьте домен в разделе Домены. Каждому домену автоматически выдаётся свой уникальный data-api-key — он привязан к конкретному сайту, отдельно настроенному баннеру и статистике согласий.

2. Вставьте тег в <head>

<script
  src="https://api.cookiestack.dev/widget.js"
  data-api-key="YOUR_API_KEY"
  async
></script>

Тег должен быть внутри <head>, до тегов остальных трекеров (Google Tag Manager, Яндекс.Метрика и т.д.) — иначе они успеют загрузиться до того, как виджет установит статус согласия по умолчанию.

Атрибут async не блокирует отрисовку страницы. Скрипт сам определяет, к какому API-серверу обращаться, по своему собственному src — менять этот адрес вручную не нужно.

3. Проверьте установку

Откройте сайт в режиме инкогнито — баннер согласия должен появиться при первой загрузке. Если он не появился, откройте консоль браузера:

[Cookiestack] data-api-key attribute is missing on the script tag. — атрибут data-api-key не задан или пуст.
[Cookiestack] failed to load config. — домен ещё не подтверждён, либо ключ не найден. См. гайд «Первый домен».

После того как посетитель дал согласие, баннер сменяется небольшой плавающей кнопкой «Настроить» внизу слева — через неё можно в любой момент открыть настройки заново.

Что дальше

Настройка баннера — цвета, позиция, тексты, языки.
Интеграция с Яндекс.Метрикой — без ручной вставки её скрипта.
JavaScript API — как заблокировать собственные скрипты до согласия.