Как установить плагин WordPress

Плагин добавляет отчёты в админку вашего сайта. ZIP загружается через WordPress; отдельная панель на поддомене и SSH для этого варианта не требуются.

Версия 0.4.0 betaWordPress 6.5+PHP 8.1+MySQL / MariaDB

Подготовьте тестовую копию сайта

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

Нужна обычная установка WordPress. Multisite в этой версии не поддерживается. Отчёты и настройки доступны пользователю с правом manage_options, обычно администратору.

Скриншоты на странице продукта показывают кабинет с подписанными тестовыми данными. При первой установке ваш отчёт будет пустым. Статус beta означает, что перед рабочим запуском нужна проверка вашей конфигурации.

Загрузите ZIP и задайте настройки

  1. В WordPress откройте "Плагины → Добавить плагин → Загрузить плагин". Выберите скачанный ZIP, установите и активируйте его. После активации сбор выключен.
  2. Перейдите в "Инструменты → Диванная аналитика". Укажите действующую страницу политики конфиденциальности на вашем сайте и срок хранения от 7 до 365 дней. По умолчанию агрегаты хранятся 90 дней.
  3. Введите разрешённые пути по одному на строку. Например, /, /contacts/, /blog/*. Маска объединяет страницы блога в одну метку. Завершающий слеш имеет значение; сверяйте пути с адресами опубликованных страниц.
  4. Задайте названия нужных событий и рекламных меток. Сбор текстовых фраз оставьте выключенным до проверки состава данных и политики.
  5. Настройте согласие по следующему разделу, затем включите счётчик и сохраните настройки.

Не добавляйте в пути email, телефон, номер клиента или другой персональный идентификатор. Неизвестные адреса попадают в общую группу (other). Полный URL с query и hash в отчёте не сохраняется.

Проверьте в приватном окне

  1. Откройте публичную страницу в отдельном приватном окне и выйдите из WordPress. Авторизованные посетители исключены из сбора, поэтому просмотр из админской вкладки не подходит для проверки.
  2. Откройте DevTools → Network и найдите collect. До разрешения аналитики запросов к /wp-json/dulesov-analytics/v1/collect быть не должно.
  3. Разрешите аналитику. Должен появиться POST-запрос просмотра. Откройте другую разрешённую страницу и проверьте новый запрос.
  4. Вернитесь в админку, выберите текущие даты и обновите отчёт. Даты и часы в аналитике используются в UTC; это может отличаться от локальной даты у посетителя.
  5. Отзовите согласие через кнопку настроек. Новые просмотры и события после отзыва отправляться не должны.

Если в браузере включён DNT или GPC, для отдельной проверки режима согласия понадобится тестовый профиль с выключенным сигналом. На рабочем сайте эти настройки посетителя соблюдаются.

Добавьте рабочие события и метки

Названия событий, кампаний и объявлений задаются строчной латиницей, цифрами, символами _ и -, до 48 символов. Сначала внесите их в разрешённые списки кабинета.

<a href="/contacts/" data-da-event="contact_click">Контакты</a>

// Только после подтверждённого успешного ответа сервера формы:
window.DulesovAnalytics.event('lead_sent');

Универсального обработчика любых WordPress-форм нет. Свяжите lead_sent с подтверждением вашего плагина формы. Нажатие кнопки отправки ещё не подтверждает, что заявка принята. Событие purchase считает обращения; суммы и номера заказов не поддерживаются.

Для Telegram, рекламы и других размещений создавайте ссылки в UTM-конструкторе кабинета. Кампания utm_campaign, канал utm_medium и объявление utm_content должны входить в ваши списки. Неразмеченный переход из приложения, скрывшего реферер, может остаться прямым/неизвестным.

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

Как получать отдельные события из CRM

Настройте очистку и сохраните данные при обновлении

Плагин планирует ежедневную очистку через WP-Cron. Дополнительно очистка запускается по активности не чаще раза в час. Обычный WP-Cron зависит от посещений: для удаления в заданное время настройте его серверный запуск средствами вашего хостинга. Резервные копии очищаются отдельно.

  1. Перед обновлением сохраните защищённую копию базы и установленного плагина.
  2. Сначала обновите тестовую копию. В WordPress загрузите новый ZIP и подтвердите замену установленной версии. Существующие настройки и таблицы должны сохраниться.
  3. Проверьте прежние итоги, новые события и доступ к CSV. Затем выполните те же действия на рабочем сайте.

Кнопка "Удалить" в разделе плагинов запускает uninstall и удаляет таблицы статистики и настройки. Для обновления её использовать нельзя. Деактивация сохраняет данные и прекращает подключение скриптов.

Детали прошлых обращений не восстанавливаются задним числом. Суточные итоги 0.1 сохраняются; сочетания меток и часы используют новые агрегаты. Старые почасовые данные 0.2 сохраняются с неизвестным каналом и отсутствующими новыми полями.

Если просмотров нет или они неполные

  • Проверьте, что сбор включён, политика указана, посетитель вышел из WordPress и дал согласие.
  • Очистите кеш страниц после изменения настроек. Проверьте, что оптимизатор скриптов сохранил порядок tracker и consent.
  • Убедитесь, что REST API не заблокирован плагином безопасности, CSP, прокси или правилом сервера.
  • Сравните даты UTC и текущие фильтры. Снимите фильтры для проверки общего итога.
  • Проверьте блокировщик, DNT/GPC и ошибки сети. При отказе сети автоматической повторной отправки нет.

Лимиты публичного сбора: 120 обращений в минуту с одного сетевого адреса и 50 000 в сутки на установку. Данные показывают обращения к счётчику; уникальные посетители и коэффициент конверсии не вычисляются. Фильтрация ботов приблизительная.

Вернуться к Диванной аналитике · Обсудить установку