Перейти к содержимому

Язык

Меню документации

Категории cookie

Как Cookiesh делит файлы cookie и трекеры на категории согласия и классифицирует их при сканировании, как блокировать скрипты и iframe и что хранит сам Cookiesh.

Последнее обновление: 29 октября 2026 г.

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

Четыре категории

Категория Нужно ли согласие Примеры
necessary Нет, всегда включена Сессии входа, корзины покупок, балансировка нагрузки, CSRF-токены, сам файл cookie с согласием
preferences Да Язык, тема, недавно просмотренные товары
analytics Да Трафиковая и продуктовая аналитика, A/B-тесты, тепловые карты
marketing Да Реклама, ретаргетинг, пиксели и встраиваемые виджеты соцсетей

Названия категорий фиксированы, поэтому ваш код и правила в менеджере тегов никогда не сломаются. Подпись и описание, которые видят посетители, можно изменить в разделе Banners → Copy.

Относите к necessary только действительно необходимое. Регуляторы толкуют это исключение узко: файл cookie подпадает под него, только если услуга, которую запросил посетитель, без него не может работать. Аналитика, даже собственная (first-party), по правилам ЕС строго необходимой не считается.

Сканер cookie обходит ваши страницы по расписанию (ежемесячно на Hobby, ежедневно на Pro и Enterprise). Он фиксирует каждый файл cookie, ключ localStorage и sessionStorage и сторонний запрос и сверяет их с нашей базой из более чем 20 000 известных трекеров.

  • Для известных элементов категория, поставщик, цель и срок действия заполняются автоматически.
  • Неизвестные элементы появляются в разделе Cookies → Needs review. Пока вы их не классифицируете, они считаются marketing, поэтому ничего не проскочит без блокировки.

Любую классификацию можно изменить в разделе Cookies → All cookies. Файлы cookie, до которых сканер не может добраться, например те, что устанавливаются только после входа, добавьте вручную кнопкой Add cookie. Всё, что вы классифицировали, попадает в декларацию файлов cookie, которую посетители видят в центре настроек.

Блокировка скриптов

Cookiesh автоматически блокирует известные трекеры. Чтобы явно управлять собственными скриптами, замените тип скрипта на text/plain и добавьте категорию:

<script
  type="text/plain"
  data-cookiesh="analytics"
  src="https://analytics.example.com/script.js"
></script>

Когда посетитель разрешит эту категорию, Cookiesh вернет исходный тип и запустит скрипт в исходном порядке. Если скрипт относится к нескольким категориям, перечислите их все через пробел. Тогда он запустится, только когда разрешены все перечисленные категории:

<script type="text/plain" data-cookiesh="analytics marketing">
  initAttribution();
</script>

Блокировка iframe и встраиваемого контента

Встроенные видео, карты и публикации из соцсетей часто устанавливают файлы cookie сразу при загрузке. Переименуйте src в data-cookiesh-src и добавьте категорию:

<iframe
  data-cookiesh-src="https://www.youtube-nocookie.com/embed/VIDEO_ID"
  data-cookiesh="marketing"
  width="560"
  height="315"
  title="Product demo"
></iframe>

Пока посетитель не дал согласия, Cookiesh показывает заглушку с коротким пояснением и кнопкой Разрешить и загрузить. Эта кнопка разрешает категорию только для встраиваемого контента, а не для всего сайта.

Что хранит Cookiesh

Cookiesh сохраняет выбор посетителя в одном собственном (first-party) файле cookie, который сам по себе строго необходим:

Имя Назначение Срок действия
cookiesh_consent Запоминает выбор посетителя, идентификатор согласия и версию баннера По умолчанию 6 месяцев, можно настроить до 13 месяцев

Файл cookie не содержит персональных данных, кроме случайного идентификатора согласия. Когда срок его действия истекает, Cookiesh снова спрашивает посетителя. Когда посетитель отзывает согласие для категории, Cookiesh удаляет известные ему собственные файлы cookie этой категории. Сторонние файлы cookie на других доменах может удалить только браузер посетителя.