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>
This commit is contained in:
1 parent
56ff5839b8
commit
a61d53962a
145 files changed
+9242
-523
No files matched your search
@@ -0,0 +1,131 @@
|
||||
# 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, рядом с именем и телефоном:
|
||||
|
||||
```text
|
||||
utm_source
|
||||
utm_medium
|
||||
utm_campaign
|
||||
utm_content
|
||||
utm_term
|
||||
yclid
|
||||
gclid
|
||||
```
|
||||
|
||||
В каждом обработчике перед сериализацией выполняется:
|
||||
|
||||
```javascript
|
||||
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: обратный звонок
|
||||
|
||||
Пример синтетический, не реальная заявка:
|
||||
|
||||
```json
|
||||
{
|
||||
"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 (добавить после адреса страницы):
|
||||
|
||||
```text
|
||||
?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 из адреса, открыть ту же страницу и проверить:
|
||||
|
||||
```javascript
|
||||
collectAttribution()
|
||||
```
|
||||
|
||||
Отправить тестовую заявку основной формы. Для Hotel и обоих медицинских лендингов отдельно отправить заявку через «Звонок». В Network → Request Payload проверить поля верхнего уровня; в CRM — соответствующие поля созданных лидов. Использовать специально выделенные тестовые контакты и не смешивать тесты с реальными заявками.
|
||||
|
||||
Проверить также повторную заявку, переход с другой кампании без `yclid`, чистый прямой заход без истории, отказ браузера в доступе к хранилищу и повторную отправку после ошибки API. Отчёт проведённых локальных проверок приложен отдельно; он не подменяет эту серверную приёмку.
|
||||
Reference in new issue
Block a user