Измерение успеха формы вместо нажатий кнопки
Нажатие кнопки отправки, отправка формы и завершение её обработки — разные события. После нажатия возможны ошибка проверки данных, сбой запроса или отказ сервера. Stats4U предлагает автоматические категории контактов, помеченные отправки и явные события успешной обработки формы; выбор определяет фактический смысл отчёта.
- Отправка
- Результат приложения
- Событие успеха
Включить только необходимые измерения
- Открыть собственный счётчик через Мои счётчики, затем Панель статистики и инструменты и Контактные действия.
- В Настройки измерений включить Автоматически считать клики по телефону, электронной почте и скачиванию для этих категорий нажатий или Считать отправки помеченных форм и подтверждённые успешные отправки форм для помеченных отправок и подтверждённых успехов.
- Выбрать Сохранить и убедиться, что сайт использует сгенерированную интеграцию JavaScript.
Автоматические категории контактов используют имена действий contact-email, contact-phone и download. Они описывают нажатие, а не доставленное письмо, принятый звонок или завершённую загрузку. Событие не отправляет адрес, номер телефона или содержимое полей формы.
Пометить отправку формы
Добавить элементу формы стабильное имя без персональных данных. Имя должно описывать назначение формы, а не идентифицировать посетителя. Этот пример помечает контактную форму:
<form data-s4u-form="contact">
<!-- Existing form controls and submission handling -->
</form>Маркер создаёт form-submitted-contact, когда браузер отправляет форму. Он не доказывает, что сервер её принял или обработал. Нужно сохранить имеющийся код проверки и обработки формы; добавление маркера измерения не реализует обработку формы.
Подтвердить успех в момент фактического успеха
Для собственной формы вызывать функцию успеха только после подтверждения приложением успешной обработки. Получение HTTP-ответа, нажатие кнопки или завершение promise fetch сами по себе недостаточны: приложение должно интерпретировать ответ своего сервера и состояние ошибки.
if (window.s4u && typeof window.s4u.formSuccess === 'function') {
window.s4u.formSuccess('contact');
}Этот вызов создаёт form-success-contact, когда измерение форм включено и трекер доступен. Его следует поместить в существующую ветвь подтверждённого успеха, а не перед запросом и не в безусловный обработчик завершения. Contact Form 7 может использовать поддерживаемую интеграцию события успешной отправки письма; обычной форме нужен явный сигнал успеха от приложения.
Проверить успех и отказ
- На собственной тестовой установке проверить корректную отправку и отправку, которую приложение отклоняет. Только подтверждённый успех должен отправлять событие успеха.
- Использовать Отладка измерений, чтобы без учёта реального события проверить допустимость ожидаемой категории и имени события.
- Сравнить полученные имена событий в отчёте. Превышение числа отправок над числом успехов может быть полезным сигналом, но не доказывает одну конкретную ошибку.
Отладчик проверяет допустимость, а не успешную доставку реальной формы. Ответ приложения и обычные запросы трекера следует исследовать отдельно. Имена людей и содержимое формы не должны попадать в метки событий и диагностические свойства.
Следующий шаг
Проверить руководство по интеграции перед добавлением вызова успеха в приложение.
Открыть руководство по установке