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

Язык

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

Правила геотаргетинга

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

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

Законы о защите данных различаются от юрисдикции к юрисдикции. Посетителям из ЕС нужен баннер с предварительным согласием до начала любого отслеживания, жителям Калифорнии — способ отказаться от продажи и передачи их данных, а многим другим посетителям достаточно уведомления. Правила геотаргетинга позволяют решить всё это одной установкой. Геотаргетинг входит в тарифы Pro и Enterprise.

Как определяется регион

Когда загружается скрипт Cookiesh, наша edge-сеть определяет по соединению страну посетителя, а для США, Канады и Бразилии — еще и штат или провинцию. В скрипт передается только итоговый код региона, например FR или US-CA. IP-адрес никогда не сохраняется и не попадает в запись о согласии.

Регион сохраняется в каждой записи о согласии, поэтому вы всегда можете показать, какое правило действовало, когда посетитель делал выбор.

Правила по умолчанию

Новые сайты начинают с этих правил. Они проверяются сверху вниз, и срабатывает первое совпадение:

Регион Коды Режим Значения Consent Mode v2 по умолчанию
ЕС и ЕЭЗ EU, EEA Предварительное согласие Все сигналы denied
Великобритания GB Предварительное согласие Все сигналы denied
Швейцария CH Предварительное согласие Все сигналы denied
Бразилия BR Предварительное согласие Все сигналы denied
Калифорния US-CA Отказ, с учетом GPC granted, рекламные сигналы denied при GPC
Остальной мир * Уведомление Все сигналы granted

Три режима работают так:

  • Предварительное согласие (opt-in). Необязательные категории остаются заблокированными, пока посетитель не согласится. На первом уровне показываются кнопки Принять все, Отклонить все и Настроить.
  • Отказ (opt-out). Категории по умолчанию разрешены. Посетитель может одним щелчком отказаться от marketing (продажи и передачи данных), а сигнал Global Privacy Control оформляет отказ автоматически.
  • Уведомление. Категории разрешены. Короткое уведомление ссылается на вашу политику использования файлов cookie и центр настроек.

Собственные правила

В разделе Banners → Geo-targeting нажмите Add rule и выберите:

  1. Регионы. Страны (ISO 3166-1, например DE), штаты и провинции (ISO 3166-2, например US-CO) или группы (EU, EEA).
  2. Режим. Предварительное согласие, отказ или уведомление.
  3. Состояние по умолчанию для каждой категории в режимах отказа и уведомления.
  4. Тексты баннера, если для региона нужны другие формулировки, например заголовок «Do Not Sell or Share».

Перетаскивайте правила, чтобы изменить порядок. Поскольку срабатывает первое совпадение, ставьте конкретные правила, например для одного штата США, выше общих.

Если сомневаетесь, используйте предварительное согласие. Баннер с предварительным согласием отвечает самым строгим требованиям, поэтому это безопасный выбор для любого региона, который вы еще не проверили.

Global Privacy Control

Global Privacy Control — это сигнал браузера, который сообщает сайтам, что данные посетителя нельзя продавать или передавать. В регионах с моделью отказа Cookiesh считает его действительным отказом от marketing, записывает согласие с методом gpc и вместо баннера показывает короткое сообщение о том, что сигнал отказа учтен. Такое же поведение можно включить для любого другого правила.

Проверка правил

Добавьте к любому URL вашего сайта параметр ?cookiesh_region= с кодом региона, чтобы имитировать посетителя из этого региона. Переопределение работает, только пока включен режим отладки. Его можно включить в разделе Settings → Debug mode:

https://example.com/?cookiesh_region=US-CA
https://example.com/?cookiesh_region=DE

Затем выполните Cookiesh.debug() в консоли браузера. Команда выведет определенный регион, сработавшее правило, показанный баннер и текущее состояние каждой категории. Когда закончите, снова выключите режим отладки.