Открыли раздел «Документация» на docs.datool.ru

На docs.datool.ru открылся раздел «Документация» — подробный справочник по сайту и кабинету datool.ru. В нём 52 статьи: от регистрации и первого входа до отчётов для клиентов, отслеживания слов и партнёрской программы. Каждый экран, блок, кнопка и фильтр описаны так, чтобы было понятно, что они показывают, как их читать и кому они открыты.

Зачем это нужно. Аналитика каналов MAX — это десятки показателей: подписчики, охваты, реакции, индекс качества, индекс цитируемости, реклама, похожие каналы. На странице канала у каждого числа есть короткая подсказка, но ответить в подсказке на вопрос «как именно это считается и почему у двух каналов разные значения» нельзя. Теперь у каждого раздела сайта есть своя статья, а у каждого показателя — методика.

Что внутри

Статьи собраны в группы — в том же порядке, в каком человек обычно знакомится с сервисом:

• Начало работы. Что такое datool.ru, регистрация и вход (по почте, через Яндекс или MAX), как устроен сайт, что видно без входа, после входа и по подписке, тарифы и оплата.
• Витрина MAX. Поиск и каталог каналов, категории и регионы, рейтинги и подборки, «Сегодня в MAX», «Статистика MAX», добавление канала и подтверждение владельца, страница поста и демо-канал.
• Страница канала. Отдельная статья на каждую вкладку: дашборд, все сообщения, анализ аудитории, упоминания, популярное, охваты, график публикаций, реклама, похожие каналы и вовлечённость.
• Моё в MAX. Мои каналы, «Слежу» и уведомления, отслеживание слов, избранное, закрытые каналы, отчёты PDF и выгрузки, все события.
• Кабинет. Профиль, организация и участники, подписки и пакеты, баланс, промокоды, партнёрская программа, ключи API, уведомления и главный бот, поддержка.
• Методики. Как считаются показатели, откуда данные и как часто обновляются, индекс качества, индекс цитируемости, как мы распознаём рекламу, хиты, похожие каналы, категории и территории.
• Вопросы и ответы — короткие ответы на то, о чём спрашивают чаще всего.

У каждой статьи указано время чтения: от 3 минут у самых простых до 20 минут у статьи о дашборде канала.

Скриншоты в каждой статье

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

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

Как устроена страница статьи

• Меню слева — все разделы с иконками; раздел можно свернуть, браузер это запомнит. Сверху — переключатель «Документация | API».
• Поиск по всей документации и справочнику API — в полосе сверху, открывается клавишей «/». Под каждым результатом — кусок текста вокруг найденного слова.
• «На странице» — оглавление статьи справа; в меню слева подсвечивается раздел, до которого вы дочитали.
• Хлебные крошки, дата обновления и кнопки «назад / дальше» — чтобы читать раздел подряд.
• «Страница полезна?» — ответ «да» или «нет» в конце статьи. По этим ответам мы понимаем, какие статьи нужно дописать.
• «Открыть в Markdown» — та же статья простым текстом: её удобно сохранить или передать ИИ-ассистенту.

На телефоне меню открывается кнопкой в верхней полосе, текст и скриншоты подстраиваются под ширину экрана.

Справка из кабинета — в один щелчок

В подвале каждой вкладки кабинета hi.datool.ru и раздела «Моё в MAX» есть ссылка «Справка». Она открывает в новой вкладке статью именно о том разделе, где вы сейчас: на «Слежу» — статью «Слежу и уведомления», на «API-ключах» — «Ключи API», на «Подписках и оплате» — «Подписки, пакеты и реквизиты». Искать нужную статью самому не придётся.

Из подсказок на страницах тоже есть ссылки на документацию. Например, совет в «Индексе качества» подтвердить канал ведёт прямо к инструкции «Подтвердить, что канал ваш».

Для поисковиков и ИИ-ассистентов

Документация открыта всем, без входа. У каждой статьи есть описание для поисковой выдачи, разметка хлебных крошек и вопросов-ответов, карта сайта с датами обновления. Для ИИ-ассистентов есть файл llms.txt — оглавление всех статей со ссылками на их Markdown-версии, и llms-full.txt — вся документация одним файлом. Поэтому ассистент, которого спросили о datool.ru, может опираться на наши статьи, а не на догадки.

Кому это полезно

• Новым пользователям — чтобы за 10–15 минут понять, где что лежит, и не пропустить полезные функции вроде «Слежу» или выгрузок.
• Владельцам каналов — чтобы разобраться, из чего складывается индекс качества, как подтвердить канал и что даёт синий знак.
• Рекламодателям и агентствам — чтобы понимать методику рекламной статистики и объяснять клиентам, откуда цифры в отчёте.
• Командам — чтобы новый участник организации прочитал статьи «Организация и участники» и «Подписки, пакеты и реквизиты» и не задавал одни и те же вопросы.

Как начать

1. Откройте docs.datool.ru.
2. Начните с блока «Чаще всего ищут» — там самые нужные статьи: регистрация, тарифы, подтверждение канала, дашборд, «Слежу», ключи API.
3. Если вопрос конкретный — нажмите «/» и введите слово: «отписки», «реклама», «выгрузка».
4. Работая в кабинете, пользуйтесь ссылкой «Справка» в подвале страницы.

Частые вопросы