Files
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

14 KiB
Raw Permalink Blame History

EXO — передача UTM и идентификаторов рекламных переходов

Что входит в обновление

Обновлены браузерные кодовые базы Fitnes, Hotel, MedCsFiz и MedCbezFiz из последних архивов *_Server_NoBottomCall.zip.

Дизайн, тексты, изображения, калькуляторы, выбранные аппараты и адреса обработчиков сохранены. Нижние фиксированные кнопки не возвращены. Добавлен общий для четырёх направлений файл attribution.js; изменены его подключение в index.html и сбор данных формы в script.js.

Обновление готово к размещению как клиентская часть. Оно не содержит и не подменяет серверный обработчик или интеграцию с CRM.

Фактический состав форм и адреса отправки

Направление Формы в актуальном архиве POST endpoint
Fitnes leadForm /api/leads/fitness-centers
Hotel leadForm, exoCallbackForm /api/leads/hotels
MedCsFiz leadForm, exoCallbackForm /api/leads/medical-centers-existing-physio
MedCbezFiz leadForm, exoCallbackForm /api/leads/medical-centers-no-physio

Итого 7 форм. В последнем исходном архиве Fitnes отдельного exoCallbackForm нет, а «Звонок» является tel:-ссылкой. Новый попап для Fitnes в рамках этого обновления не добавлялся; доработана существующая основная форма. Прямой телефонный звонок не является отправкой браузерной лид-формы и сам по себе не передаёт JSON с UTM.

В трёх остальных серверных версиях дополнительно исправлен момент инициализации попапа: обработчики теперь подключаются после готовности DOM, даже если script.js расположен до HTML попапа.

Передаваемые поля

Семь строковых полей находятся непосредственно в корне JSON, рядом с именем и телефоном:

utm_source
utm_medium
utm_campaign
utm_content
utm_term
yclid
gclid

В каждом обработчике перед сериализацией выполняется:

Object.assign(payload, collectAttribution());

payload.attribution больше не создаётся. Все семь ключей присутствуют; отсутствие метки обозначается пустой строкой. Пустая строка не означает «direct» и не должна заменяться выдуманным источником. На сервере пустые UTM не должны затирать подтверждённый источник уже существующего контакта, если CRM объединяет повторные заявки.

Модуль также заполняет скрытые поля этих форм, обновляет их перед отправкой и восстанавливает после сброса формы. Визуальных полей для UTM не добавлено. Поля с контактами и выбранной конфигурацией продолжают передаваться исходными обработчиками.

Сохранение и приоритет меток

Ниже — выбранные настройки реализации, а не данные исходного лендинга и не утверждение о правилах рекламных систем.

  1. Метки читаются при загрузке страницы, до основного script.js, а не только при отправке.
  2. Набор сохраняется целиком в ключе exo_attribution_v1. Основное хранилище — localStorage, резервное — sessionStorage; на текущей странице также остаётся копия в памяти.
  3. Срок хранения — 30 дней от размеченного перехода. Настройка TTL_DAYS находится в начале attribution.js.
  4. Новое открытие с непустыми метками заменяет весь предыдущий набор. Это исключает смесь, например, новой utm_source и старых utm_campaign/yclid.
  5. Открытие без меток использует сохранённый актуальный набор. Очистка query-параметров, переход по якорю и повторное заполнение формы не стирают его.
  6. Истёкшая или повреждённая запись не используется. Отсутствующие UTM не генерируются.
  7. Если браузер запрещает хранилища, форма продолжает работать: на текущей странице используются метки из URL/памяти. Если запрещены оба хранилища, сохранение после закрытия или перезагрузки страницы гарантировать нельзя.

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

Граница сохранения: отдельный origin браузера. Между разными браузерами, устройствами и поддоменами метки автоматически не переносятся. Для переходов с одного лендинга на другой поддомен нужна отдельно согласованная междоменная схема. Cookies и автоматическое дописывание меток во все ссылки не добавлялись.

Пример запроса Hotel: обратный звонок

Пример синтетический, не реальная заявка:

{
  "name": "Тест UTM",
  "phone": "+7 999 000-00-00",
  "utm_source": "yandex",
  "utm_medium": "cpc",
  "utm_campaign": "hotel_test",
  "utm_content": "banner_01",
  "utm_term": "оборудование для отеля",
  "yclid": "TEST_YCLID",
  "gclid": "",
  "lead_type": "callback",
  "source": "header-call-popup",
  "page_url": "https://example.invalid/hotel/?utm_source=yandex&utm_medium=cpc&utm_campaign=hotel_test",
  "page_title": "Тестовый лендинг"
}

source — техническое место заявки на странице, а utm_source — рекламный источник. Это разные поля; нельзя записывать header-call-popup вместо рекламного источника. Дополнительные поля даты/страницы и их исходные названия сохранены в соответствующих обработчиках; пример выше не перечисляет все возможные поля каждой формы.

Что обязательно проверить на сервере

В переданных исходных архивах нет кода перечисленных API-обработчиков, токенов CRM или таблицы соответствия её полям. Сам факт вложенного attribution в старом Hotel не доказывал потерю UTM сервером: обработчик мог читать этот объект. После изменения формат стал одинаковым на всех формах, но сервер должен принимать новый контракт.

Серверному разработчику необходимо:

  • Убедиться, что нужные POST-маршруты действительно существуют и читают JSON-тело запроса.
  • Разрешить семь строковых полей верхнего уровня в схеме валидации; не отбрасывать их при создании внутреннего объекта заявки.
  • Настроить соответствие этих полей реальным полям конкретной CRM. Названия и ID полей CRM не угадывать: в материалах они отсутствуют.
  • Передать значения и для основной заявки, и для lead_type=callback.
  • Проверить цепочку на тестовой заявке: Request Payload в браузере → вход обработчика → запрос в CRM → карточка лида в CRM.
  • Проверить ответы CRM и не сообщать об успешной записи, когда CRM отклонила запрос. Фронтенд сохранил исходную проверку HTTP-статуса; особый формат бизнес-ошибок CRM без кода обработчика неизвестен.
  • Не публиковать ключи/токены CRM в script.js или attribution.js. Серверные проверки полей, антиспам и защита журналов от утечки контактных данных остаются на сервере.

Для мягкого перехода сервер может временно принимать и новый верхний уровень, и прежний объект attribution, отдавая приоритет новому формату. Это рекомендация для обработчика, не реализованный серверный код.

Размещение

  1. Сохранить резервную копию действующего лендинга.
  2. Загрузить всё содержимое папки соответствующего направления: index.html, script.js, attribution.js, styles.css, assets/.
  3. Не перезаписывать существующий серверный backend этими статическими файлами. Не менять endpoint без проверки маршрутизации.
  4. index.html уже содержит версионные параметры ?v=utm1 для JS. Очистить кеш HTML/CDN, если он используется.
  5. Проверить, что attribution.js?v=utm1 и script.js?v=utm1 возвращают JavaScript, а не HTML-заглушку маршрутизатора.
  6. Выполнить тесты ниже на опубликованной странице и подтвердить наличие значений именно в CRM.

Для одного лишь локального просмотра используйте автономные HTML из отдельного архива. Они содержат скрипты, стили и изображения внутри файла; настоящую серверную отправку по двойному клику в file:// они не заменяют.

Приёмка после публикации

Открыть адрес нужного лендинга с тестовым query (добавить после адреса страницы):

?utm_source=yandex&utm_medium=cpc&utm_campaign=utm_test&utm_content=banner_01&utm_term=test&yclid=TEST_YCLID

В DevTools → Application → Local Storage должна появиться запись exo_attribution_v1 до отправки формы. Затем убрать query из адреса, открыть ту же страницу и проверить:

collectAttribution()

Отправить тестовую заявку основной формы. Для Hotel и обоих медицинских лендингов отдельно отправить заявку через «Звонок». В Network → Request Payload проверить поля верхнего уровня; в CRM — соответствующие поля созданных лидов. Использовать специально выделенные тестовые контакты и не смешивать тесты с реальными заявками.

Проверить также повторную заявку, переход с другой кампании без yclid, чистый прямой заход без истории, отказ браузера в доступе к хранилищу и повторную отправку после ошибки API. Отчёт проведённых локальных проверок приложен отдельно; он не подменяет эту серверную приёмку.