#Загрузчик loader.js

Статус: Доступно.

Назначение: один тег <script> подключает к сайту счётчик посещений, сбор поведения и чат Формула ИИ и управляет ими через согласие посетителя.

#Содержание

1. Когда использовать
2. Доступ
3. Что входит в загрузчик
4. Установка вручную
5. Согласие посетителя
6. Интеграция с баннером cookie
7. Как проверить установку
8. Ответ сервера и кэширование
9. Заметки
10. Открытые вопросы

#Когда использовать

• Сайт привязан к Формула ИИ (модулем или кодом привязки), и нужны чат, счётчик и сбор поведения без серверной части.
• Модуль для вашей CMS (Bitrix, WordPress) ставит загрузчик сам — вручную тег добавлять не нужно.

Если нужен только счётчик посещений без привязки сайта, используйте JS-трекер по токену.

#Доступ

#Что входит в загрузчик

Загрузчик собирается на облаке по настройкам сайта и подключает только включённые части.

Настройки сайта целиком:

Настройки меняет персонал в кабинете: «Продвижение → Система → Сайты (модуль)».

#Установка вручную

Публичный ключ показывает ответ bind (протокол коннектора); в интерфейсе кабинета он сейчас не выводится (см. открытые вопросы).

Шаг 1. Перед основным тегом добавьте заглушку очереди согласия. Она нужна, чтобы вызов consent до загрузки скрипта не потерялся.

<script>
  window.sapport = window.sapport || {
    q: [],
    consent: function (v) { this.q.push(['consent', !!v]); }
  };
</script>

Шаг 2. Добавьте загрузчик ячейки вашего сайта (пример для RU; EN — https://wfacademy.org, ID — https://wfacademy.id):

<script async src="https://formula-cream.pro/api/v1/connector/loader.js?k=0123456789abcdef0123456789abcdef"></script>

Параметры запроса:

Шаг 3. Разместите тег на всех страницах, которые нужно учитывать (обычно — в общем шаблоне, в <head> перед </head>).

#Согласие посетителя

Режим задаётся настройкой consent_mode.

#API на странице

// согласие дано
window.sapport.consent(true);

// согласие отозвано: остановит сбор поведения
window.sapport.consent(false);

// то же событием
window.dispatchEvent(new CustomEvent('sapport:consent', { detail: true }));
// допустима и форма { granted: true }
window.dispatchEvent(new CustomEvent('sapport:consent', { detail: { granted: true } }));

#Что именно зависит от согласия

#Интеграция с баннером cookie

Подключите вызов к кнопкам вашего баннера согласия:

document.querySelector('#cookie-accept').addEventListener('click', function () {
  window.sapport.consent(true);
});
document.querySelector('#cookie-reject').addEventListener('click', function () {
  window.sapport.consent(false);
});

// сохранённый выбор при следующем визите
if (localStorage.getItem('cookie-consent') === 'granted') {
  window.sapport.consent(true);
}

Если баннер даёт выбор по категориям, привязывайте consent(true) к категории «аналитика» (статистика), а не к «маркетингу».

#Как проверить установку

1. Откройте страницу сайта с инструментами разработчика → вкладка «Сеть». Должен быть запрос loader.js?k=… со статусом 200.
2. Убедитесь, что ответ — не заглушка: тело не равно /* Sapport connector: off */.
3. В консоли выполните typeof window.sapport.consent — ожидается function.
4. Проверьте запрос посещения: после загрузки страницы уходит POST /api/v1/track/visit, ответ 204.
5. В кабинете «Продвижение → Система → Сайты (модуль)» у сайта должно быть состояние «привязан», включены «Счётчик посещений» и нужные части.
6. Если на странице подключены и модуль, и ручной тег, посещения удвоятся — оставьте один.

#Ответ сервера и кэширование

Выключив сайт или часть в кабинете, учтите кэш: загрузчик опустеет на страницах в пределах 5 минут.

#Заметки

• Повторное подключение безопасно: загрузчик защищён от двойного запуска (метка __sapportConnector).
• Для политики Content-Security-Policy разрешите скрипты и соединения с доменом вашей ячейки.
• Загрузчик не поддерживает SPA-переходы счётчика: учитывается загрузка страницы, не смена адреса через History API (сбор поведения следит за history.pushState).

#Открытые вопросы

1. К владельцу. Где взять публичный ключ без модуля. Поле public_key есть в ответе привязки, но интерфейс кабинета его не показывает и готовый тег не выдаёт. Ручная установка поэтому поддерживается как сценарий протокола, а не как кнопка в кабинете. Нужно решение: показывать ключ и готовый тег в карточке сайта.
2. Техническое. Тот же ключ служит токеном трекера: стоит ли предупредить, что он публичен и допускает запись хитов с чужих страниц (защита — лимиты и квота, см. JS-трекер).