- 01Удалите другие подключения Яндекс Метрики из темы, плагинов, менеджеров тегов и cookie-систем, чтобы не было двойного счётчика.
- 02Установите и активируйте плагин.
- 03Откройте «Настройки → Согласие для Метрики».
- 04Укажите номер счётчика, включите интеграцию и сохраните настройки.
- 05Нажмите «Проверить на сайте» и сделайте выбор в существующем cookie-баннере.
- 06Очистите кэш сайта/CDN и проверьте работу в приватном окне браузера.
До согласия и после отказа запросов Метрики от этого плагина быть не должно. После согласия счётчик может инициализироваться один раз на страницу.
Если используемый cookie-баннер не поддерживается, Метрика останется выключенной, а режим проверки покажет это.
Автоматическое определение согласия
Плагин умеет автоматически получать решение пользователя из следующих источников согласия:
- 07Cookiebot — отдельное согласие на статистику.
- 08CookieYes — сохранённый выбор пользователя с разрешённой аналитикой.
- 09Complianz — режим opt-in с явно сохранённым согласием на статистику.
- 10WP Consent API — явное разрешение статистики, если выше не обнаружена поддерживаемая CMP-система.
- 11Простой бинарный протокол баннера — элементы с data-cookie-action и сохранённым значением accepted / declined в localStorage.cookie_consent , если другая поддерживаемая система не обнаружена.
Если одновременно обнаружено несколько поддерживаемых CMP-систем, каждая из них должна явно разрешать аналитику. Любой отказ блокирует загрузку. Простой баннер не может переопределить отказ, полученный от распознанной CMP-системы.
Закрытие баннера, прокрутка страницы, ожидание или нажатие посторонней кнопки «ОК» не считаются согласием. Плагин только читает сохранённый выбор и не изменяет его самостоятельно.
Интеграция для разработчиков
Для собственного cookie-баннера можно перед загрузкой контроллера предоставить функцию:
window.stolkomMetrikaGetConsent = function () { return YOUR_BANNER_HAS_EXPLICIT_ANALYTICS_CONSENT === true; };
После каждого сохранённого изменения или истечения срока согласия вызовите:
window.stolkomMetrikaConsent.refresh();
Либо после сохранения выбора отправьте событие:
document.dispatchEvent(new CustomEvent('stolkom:consent', { detail: { analytics: true } }));
При отзыве используйте analytics: false . Только буквальное значение true разрешает аналитику. Пользовательская интеграция не может переопределить отказ, полученный от обнаруженной CMP-системы.
Для диагностики доступно:
window.stolkomMetrikaConsent.getStatus();
Возможные состояния включают waiting , scheduled , loading , active , conflict , error , revoked , reload-required и ready в режиме администраторской проверки.
Загрузка и отзыв согласия
После получения согласия плагин дожидается события window.load и свободного времени браузера перед запросом SDK Метрики. Непосредственно перед загрузкой и инициализацией согласие проверяется ещё раз.
Отзыв согласия отменяет запланированную загрузку. Если счётчик уже активен, плагин вызывает destruct и, где это возможно, удаляет доступные first-party cookie и данные хранилища _ym_* , связанные с указанным счётчиком. Уже отправленные запросы вернуть невозможно.
Если на странице уже обнаружена функция ym , конструктор Metrica или известный скрипт SDK Метрики, это считается конфликтом. Перед использованием плагина удалите другие подключения Яндекс Метрики.
Если согласие было отозвано во время загрузки SDK, а затем выдано повторно, плагин не принуждает страницу к перезагрузке — новое разрешение применяется при следующей загрузке страницы.
Внешние сервисы и данные
Сам факт активации плагина не отправляет запросы в Яндекс. Администратор должен указать номер счётчика и включить интеграцию, а посетитель отдельно должен разрешить аналитику.
После согласия браузер загружает https://mc.yandex.ru/metrika/tag.js , после чего аналитические данные отправляются в Яндекс Метрику. SDK может использовать и другие домены, управляемые Яндексом.
Передаваемые данные могут включать IP-адрес, данные браузера и устройства, URL страницы, источник перехода, cookie-идентификаторы, просмотры страниц и временные показатели. Дополнительные цели, настроенные владельцем сайта, могут передавать другие данные. Не размещайте персональные данные в URL, реферерах и параметрах целей.
- 12Сервис: https://metrika.yandex.ru/
- 13Условия использования: https://yandex.ru/legal/metrica_termsofuse/ru/
- 14Политика конфиденциальности: https://yandex.ru/legal/confidential/ru/
В WordPress плагин хранит только собственные настройки. При удалении плагина эти настройки удаляются. Данные cookie-баннера и исторические данные, уже отправленные в Яндекс, плагин не удаляет.
Переводы
Исходные строки плагина используют текстовый домен stolkom-consent-for-yandex-metrica . Русский перевод ru_RU включён в плагин как встроенный вариант. После публикации WordPress.org также может предоставлять обновлённые языковые пакеты сообщества.