← Материалы и инструкции

Подключите согласие
к реальному действию

SDK записывает выбор посетителя вместе с версией документа. Он не заменяет правовой текст, не находит все сторонние скрипты и не удаляет данные из ваших систем.

1. Подтвердите домен и опубликуйте текст

Добавьте сайт в кабинете, разместите проверочный файл и опубликуйте утверждённый текст согласия. Укажите одну конкретную цель. В первой версии поддерживается один действующий документ и одна цель на сайт.

2. Установите скрипт

В разделе «Документы и SDK» скопируйте код с идентификатором вашего сайта. Укажите адрес развёрнутого API:

<script src="https://soglivo.com/sdk.js"
  data-site="SITE_ID"
  data-api="https://api.soglivo.com" defer></script>

По умолчанию SDK показывает текст согласия и равнодоступные действия «Согласен» и «Не согласен». Кнопка настроек позволяет открыть его снова.

3. Отложите необязательные скрипты

Замените обычное подключение каждого скрипта, которому требуется согласие, на инертное:

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

Адрес в примере вымышленный. Подставьте ваш сервис. После успешной записи согласия SDK подключит отмеченные скрипты. Если оставить обычный тег script, он запустится независимо от SDK. Вложенные теги из менеджеров тегов тоже нужно настроить отдельно.

Согласие в форме заявки

Добавьте в подключение SDK атрибут data-mode="form". Вместо общего окна покажите в своей форме отдельный, заранее не отмеченный флажок и полный текст актуального документа. До передачи заявки дождитесь записи согласия:

const consentDocument = await window.Soglivo.ready;
document.querySelector("#consent-text").textContent = consentDocument.body;

// В обработчике вашей формы:
if (!consentCheckbox.checked) return;
await window.Soglivo.accept();
// Только теперь отправьте данные формы на свой сервер.

Не объединяйте это согласие с рекламной рассылкой. Отдельные цели и правовые основания нужно проектировать отдельно. Этот пример показывает порядок действий, а не готовую универсальную форму.

Отказ и отзыв

Для собственных элементов интерфейса используйте Soglivo.reject(), Soglivo.withdraw() и Soglivo.open(). Уже запущенные отмеченные скрипты прекращаются перезагрузкой страницы после отказа или отзыва. Очистку ранее записанных cookie и обработку данных у внешних поставщиков выполняет интеграция сайта.

События soglivo:change и soglivo:error позволяют отразить выбор и ошибки в интерфейсе. Не отправляйте форму, если Promise записи согласия завершился ошибкой.

Что сохраняется

Сервер записывает случайный идентификатор посетителя, действие, время, версию и хеш документа. Тело запроса SDK не содержит имени, почты, IP, User-Agent или адреса текущей страницы; поле пути заполняется значением «/», чтобы не собирать идентификаторы из URL.

Журнал хранит события 365 дней. Через 365 дней после записи сохранённый выбор перестаёт действовать в SDK: посетителю снова предлагается принять решение. Выгрузка содержит исходные строки событий, их хеши и документы. Связь хешей позволяет заметить изменения в экспортированных записях; это не электронная подпись и не независимое подтверждение личности.

Проверьте подключение

  1. Откройте сайт в новом профиле браузера. Необязательные скрипты не должны загружаться.
  2. Прочитайте текст и откажитесь. Убедитесь, что скрипты по-прежнему не подключились.
  3. Дайте согласие. Найдите новое событие и правильную версию документа в кабинете.
  4. Опубликуйте новую версию и перезагрузите страницу. Посетителю снова должен быть доступен выбор.
  5. Отзовите согласие. Проверьте остановку скриптов и действия вашей интеграции по очистке данных.
  6. Смоделируйте недоступность API: необязательная обработка должна остаться выключенной.
Перейти к подключению сайта ↗