# Техническое задание: ecommerce в GA4 и Метрике

Шаблон для заполнения командой магазина. Примеры из статьи не заменяют принятые в проекте определения. Версия: 14.09.2026.

## 1. Проект и ответственность

- Магазин, домен, CMS и версия: [заполнить].
- Тема, корзина, платёжные модули и версии: [заполнить].
- Тестовая среда и способ создания контрольных заказов: [заполнить].
- Ресурс и web-поток GA4, Measurement ID: [заполнить].
- Контейнер GTM, номер счётчика Метрики: [заполнить].
- Владелец правил измерения, разработчик, проверяющий, ответственный за выпуск: [заполнить].

Не включайте в этот документ пароли, ключи API или платёжные данные.

## 2. Определение покупки

- Покупка фиксируется при подтверждении состояния: [заполнить].
- Состояние подтверждает система / ответ API: [заполнить].
- transaction_id формируется из поля: [заполнить].
- Область уникальности ID, включая несколько магазинов: [заполнить].
- Повторный показ подтверждения и повторная попытка оплаты обрабатываются так: [заполнить].
- Оплата, отмена и возврат учитываются отдельно следующим способом: [заполнить].

## 3. Данные товара и суммы

- ID товара и варианта берутся из: [заполнить].
- Название, бренд, категория и вариант: [заполнить поля источника].
- Цена единицы после скидки: [поле и правило].
- Скидка единицы, включая распределение купона: [правило и округление].
- Количество в add/remove: изменение количества; в purchase: купленное количество.
- Валюта и минимальные денежные единицы: [заполнить].
- value покупки в GA4: сумма price × quantity без доставки и налога.
- Доставка и налог: [поля и согласованная трактовка].
- revenue в Метрике: [точно согласовать состав суммы].

Учебный заказ из статьи задан в USD без конвертации: две кружки по 18 USD после скидки и блокнот за 24 USD дают 60 USD товаров; доставка 5 USD, платёж 65 USD. В примере кода суммы хранятся в центах (`1800`, `2400`, `500`), а в ecommerce-событии передаются в USD. Частичный возврат одной кружки — 18 USD: после него остаются товары на 42 USD и деньги на 47 USD с учётом неизменной доставки. Это только сверочный пример; фактические правила доставки и возврата проекта заполните выше.

## 4. Карта событий и отправителей

Для каждого события заполнить: действие → подтверждение → источник данных → получатель → отправитель → правило повторов → пример payload.

| Событие | Когда возникает | Источник | Отправитель | Проверка |
|---|---|---|---|---|
| view_item | [критерий просмотра] | [поле] | [модуль / код] | ID и вариант |
| add_to_cart | Успешное добавление | [ответ корзины] | [заполнить] | Только добавленное количество |
| remove_from_cart | Успешное удаление | [ответ корзины] | [заполнить] | Только удалённое количество |
| begin_checkout | [принятый критерий] | [корзина] | [заполнить] | Полный актуальный состав |
| purchase | [состояние из раздела 2] | [заказ] | [один основной отправитель] | ID, сумма, позиции, отсутствие дубля |
| refund | Подтверждённый возврат | [CRM / учёт] | [канал или явное ограничение] | Исходный ID, возвращённые позиции |

Остальные события добавить по бизнес-задаче. Для Метрики выбрать общий поддерживаемый GA4-поток или нативный формат. Не дублировать одну покупку в обоих форматах в одном счётчике.

## 5. Покрытие и ограничения

Проверить: стандартную корзину, быстрый заказ, гостевую покупку, регистрацию, внешний платёж, повторную оплату, мобильную версию, крупную корзину, частичный возврат. Для каждого неподдерживаемого пути записать последствие для отчётов, ответственного и решение.

## 6. Выбор пользователя и данные

- Когда разрешён запуск аналитики и какие сигналы применяются: [заполнить].
- Как проверяется изменение выбора: [заполнить].
- В ecommerce передаются только согласованные товарные поля и технический ID заказа.
- Имена клиентов, телефоны, email, адреса и комментарии заказа в payload отсутствуют.

## 7. Приёмка

Приложить заполненный checklist.csv. Для контрольных заказов сохранить: ожидаемые данные магазина, фактическое сообщение, сработавший тег, результат отладки, найденный ID в отчёте и объяснение расхождений. Не считать срабатывание тега единственным доказательством.

Проверяющий: [имя]. Дата: [дата]. Версии CMS / модулей / контейнера: [значения]. Ограничения: [список]. Решение о выпуске: [заполнить уполномоченным человеком].

## 8. Поддержка

Ответственный за мониторинг: [имя]. Период сверки: [правило]. Основание порога тревоги: [данные стабильного периода]. Обязательные проверки после изменений оформления и оплаты: [сценарии]. Место хранения истории версий: [ссылка].