Files
exodevices/fitnes/legacy/Fitnes v3/README.md
T
yuriy.pandClaude Opus 5.5 a61d53962a Add after-hours callbacks and persistent ad attribution to all four landings
- The callback dialog switches its copy outside business hours
  (shared/business-hours.ts); such leads get a "нерабочее время" tag,
  a marker in the deal name and a line in the note in amoCRM.
- utm_*, yclid and gclid are read on page load and kept for 30 days
  (src/lib/attribution.ts), last tagged visit wins, and are sent with
  every lead.
- The callback dialog is rebuilt: focus trap, focus return, phone
  masking and a full-number check.
- fitnes drops the floating MobileCta; header and mobile bars follow
  the new dialog state in the other three.
- Add the latest design mockups under legacy/.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 20:53:40 +06:00

53 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Fitnes — обратный звонок + UTM
Обновление текущей кодовой базы `Fitnes_Server_UTM.zip`.
## Что изменено
Кнопка «Звонок» в шапке открывает отдельный попап «Перезвоним вам».
В попапе обязательны имя, полный телефон и согласие на обработку данных/ответный звонок.
Номер для прямого звонка: **+7 927 789-60-71**. Он синхронизирован с футером и сообщением ошибки основной формы.
Нижняя фиксированная кнопка не добавлена. Контент, изображения, калькулятор и конструктор сохранены.
## Структура
- `index.html` — текущая страница с двумя независимыми формами;
- `styles.css` — исходные стили + локальные стили попапа;
- `script.js` — исходный интерфейс + логика обратного звонка;
- `attribution.js` — общий модуль UTM, сохранён без изменения;
- `assets/` — все исходные изображения;
- `UTM_INTEGRATION.md` — контракт передачи рекламных меток;
- `UTM_QA.md` — проведённая локальная проверка этого обновления;
- `DEPLOY.txt` — порядок размещения.
## Заявки и API
Обе формы используют **`/api/leads/fitness-centers`**.
Обратный звонок дополнительно передаёт `lead_type: "callback"`, `source: "header-call-popup"`,
`page: "/fitness"`, адрес/заголовок страницы, время отправки и выбранную конфигурацию.
Согласие передаётся как `consent: true` после обязательного подтверждения пользователем.
Поля UTM и идентификаторы `yclid`/`gclid` идут **на верхнем уровне JSON**, без `attribution`.
Используется прежнее правило: последний размеченный переход, срок хранения — 30 дней,
новый набор заменяет предыдущий целиком. Между доменами метки не переносятся.
**Серверный обработчик и CRM не входят в архив.** Адрес API взят из существующей основной формы.
На сервере нужно разрешить тип `callback` без обязательных company/email и настроить маппинг UTM в CRM.
Клиентское сообщение об успехе зависит от ответа API и само по себе не доказывает запись в CRM.
При неуспешном HTTP-ответе или явной JSON-ошибке (`success: false`, `ok: false`, непустой `error`)
попап показывает ошибку и оставляет поля для повторной отправки. Защита от повторного нажатия
действует во время запроса. Прерывание ожидания — через 20 секунд; повторная попытка после таймаута
может дублировать серверную заявку, поэтому дедупликацию при необходимости реализует сервер.
## Просмотр
Отдельный `Fitnes_Callback.html` содержит скрипты, стили и изображения внутри одного файла.
При открытии через `file://` попап валидирует поля, но не отправляет запрос и не показывает ложный успех.
Для реальных заявок необходим опубликованный сайт с рабочим API.
## Минимальная приёмка после публикации
1. Откройте лендинг с `?utm_source=yandex&utm_medium=cpc&utm_campaign=callback_test&yclid=test_click`.
2. Нажмите «Звонок», заполните имя/телефон, отметьте согласие и отправьте тестовую заявку.
3. В Network проверьте POST на `/api/leads/fitness-centers`: рекламные метки на верхнем уровне JSON.
4. Подтвердите появление заявки и отдельных UTM-полей в CRM. Затем повторите через основную форму.
5. Проверьте повторный заход без меток, новую кампанию и обработку серверной ошибки.
## After-hours callback
Рабочее время для прямого звонка: Пн–Пт 09:00–18:00, Europe/Samara. Вне этого времени любые tel:-ссылки открывают форму обратного звонка; заявки получают lead_type=callback_after_hours. Настройки находятся в business-hours.js.