Формула ИИ для разработчиков Справочник API Каталог ошибок OpenAPI
Разделы

#Аналитика: обзор

Статус: Доступно — сбор через loader.js, модули для сайтов и JS/PHP-трекер по токену. Доступно по API — чтение аналитики и дашбордов (страницы 07–08). Планируется — серверный API событий и офлайн-конверсий (страницы 05–06).

Назначение: объяснить, какие данные Формула ИИ собирает с сайта, какими путями они попадают в платформу, как выбрать путь для вашего сайта и что при этом происходит с персональными данными посетителей.

#Содержание

  1. Что собираем и что получаем
  2. Четыре пути сбора
  3. Как выбрать путь
  4. Конфиденциальность и согласие
  5. Как устроены страницы раздела
  6. Открытые вопросы

#Что собираем и что получаем

Сбор данных нужен не сам по себе: Формула ИИ связывает визит, обращение и деньги в одну цепочку и отвечает на вопрос «какой канал окупается». Сырые события остаются внутри платформы; наружу публичный API отдаёт агрегаты.

ЧтоОткуда берётсяГде увидеть
Источники трафика (поиск, соцсети, реклама, прямые заходы)хит посещения (referrer, UTM)экран «Обзор» → «Источники»
Переходы из ИИ-ассистентов (ChatGPT, Perplexity, Gemini, Copilot, You, Claude, Алиса, DuckAssist, Mistral, DeepSeek)хост реферера«Обзор» → «ИИ-ассистенты»
Заходы ИИ-краулеров и поисковых роботовUser-Agent; роботов видит только серверный маячок или трекер по токену«Обзор» → «ИИ-ассистенты»
Атрибуция лидов (источник, UTM, история визита)сессия трекера + форма/чат сайтакарточка лида в CRM
Воронка (показы → клики → сессии → лиды → сделки → выручка)поиск, счётчики, CRM«Обзор», блок воронки
Видимость в поискеSearch Console, Яндекс Вебмастер, Bing, замеры ИИ-цитирований«Обзор», раздел «Видимость»
Отчёты стратегавсё перечисленноеэкран ИИ-стратега

JS-счётчик посещений (пути 1 и 3) не использует cookies и localStorage и отправляет один хит на загрузку страницы. Состав данных сбора поведения и чата — на странице Загрузчик.

#Четыре пути сбора

№ПутьЧто передаётВидит роботовТребуетСтатусСтраница
1loader.js — один тег <script>счётчик посещений, сбор поведения, чат на сайтенет (JS не исполняется)привязанный сайт (получите ключ при привязке модулем)Доступно02
2Модуль для CMS с подписанным серверным маячкомто же + серверный хит каждого просмотра, публикация статейдаBitrix, WordPress; FastAPI и Nuxt — БетаДоступно (Bitrix, WordPress); Бета (FastAPI, Nuxt)03
3JS/PHP-трекер по токенуодно посещение: путь, источник, UTMPHP-вариант — датокен трекера (право seo.manage)Доступно04
4API событий POST /analytics/eventsстраницы, события, формы, конверсиизависит от вашего сервераключ API с областью analytics:write (без списания)Планируется05

Дополняют четвёртый путь офлайн-конверсии (06). Читать результат через API (область analytics:read) — 07; готовые срезы экранов «Обзор» и «Пульс» (область dashboards:read) — 08.

#Как выбрать путь

Ваш сайт на Bitrix или WordPress?
├─ да → модуль (путь 2). Он ставит загрузчик и серверный маячок сам.
└─ нет
   ├─ сайт на FastAPI или Nuxt и нужны роботы и чат?
   │     → модуль FastAPI/Nuxt (путь 2), сейчас Бета: пакет не опубликован
   ├─ нужен только счётчик посещений на любом сайте?
   │     → JS-тег (путь 3); для серверной части на PHP — PHP-вариант
   ├─ нужны чат и сбор поведения на любом HTML-сайте?
   │     → загрузчик (путь 1); ключ выдаёт привязка сайта
   └─ нужны события, SPA, мобильное приложение, платежи из CRM?
         → API событий (путь 4) — Планируется; до выхода используйте путь 3 для посещений

Пути не исключают друг друга, но не включайте два счётчика на одной странице без необходимости: JS-тег (путь 3) и загрузчик (путь 1) отправляют по одному хиту, и посещения удвоятся. Модуль (путь 2) уже включает счётчик загрузчика — отдельный JS-тег рядом с ним не нужен.

#Конфиденциальность и согласие

ВопросКак устроено
Хранение IP и User-Agentв открытом виде не хранятся. Хранится sha256(соль | значение), обрезанный до 32 hex-символов; соль лежит только на стороне облака. Нет соли — хеш равен null и значение не записывается
Срок хранения хитов180 дней
Cookies и localStorageJS-счётчик (пути 1 и 3) их не использует
Режим серверного маячкаfull — хеши IP и User-Agent, страна; anonymous — хеши, страна и образец User-Agent обнуляются; off — маячок выключен
Значение по умолчаниюRU — full; EN и ID — anonymous
Согласие посетителя в загрузчикеconsent_mode: wait (ждать вызова согласия) или immediate (запуск сразу). Подробности — Загрузчик
Невозможно отозватьуже отправленный хит. Отзыв согласия останавливает дальнейший сбор поведения

В режиме anonymous невозможно посчитать уникальных посетителей (оценка строится по хешам IP и User-Agent за день): остаются просмотры. Это сознательный выбор для рынков EN и ID.

Баннер согласия и юридическое основание обработки — ответственность владельца сайта и юрлица его ячейки. Формула ИИ даёт технические выключатели; он не подменяет правовую оценку.

#Как устроены страницы раздела

Каждая страница начинается со статуса: Доступно, Бета или Планируется. Страницы со статусом «Планируется» описывают согласованный контракт; имена полей уточнятся в OpenAPI 3.1. Ошибки, пагинация, идемпотентность и пределы серверного API общие для всех методов — см. Соглашения API. Адреса ячеек:

ЯчейкаАдрес
RUhttps://formula-cream.pro
ENhttps://wfacademy.org
IDhttps://wfacademy.id

Во всех примерах ключи и токены вымышлены.

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

  1. К владельцу. Юридические формулировки согласия для баннеров на EN и ID не зафиксированы в проектных документах — для них нужен текст от юрлиц ячеек.
  2. К владельцу. Где публично показывать «ключ загрузчика» без привязки модулем — см. Загрузчик.

Остальные вопросы раздела — на страницах 05, 06, 07, 08.