Возьмите один возврат, где оператор точно выбрал причину, и найдите его запись в базе. Если там есть только комментарий вроде «не подошло», аналитике уже нечего надёжно группировать. Добавьте отдельный стабильный код — например, `size_mismatch` — и оставьте текст для внутренней заметки.
Событие отправляют не при открытии формы, а после подтверждённого перехода возврата в нужный бизнес-статус. Тогда отменённая заявка не попадёт в отчёт как возврат, а retry фоновой задачи можно обезвредить уникальным event id.
Одна причина проходит через четыре системы
| Участок | Поле | Что сверить |
|---|---|---|
| Форма | reason_code | значение из разрешённого списка |
| База | return.reason_code | сохранено до отправки события |
| Очередь | event_id и return_id | повтор не создаёт новое событие |
| Аналитика | return_reason | тот же код без перевода |
| Отчёт | custom dimension | виден код, а не `(not set)` |
Человеческое название «Не подошёл размер» можно переводить и менять. Код остаётся прежним, поэтому исторический отчёт не распадается. Удалённую причину лучше пометить неактивной, а не переиспользовать её код для нового смысла.
Контракт refund содержит минимум для сверки
gtag('event', 'refund', {
transaction_id: 'ORDER-1042',
currency: 'RUB',
value: 3490.00,
return_reason: 'size_mismatch',
return_id: 'RET-208',
items: [{ item_id: 'SKU-77', quantity: 1, price: 3490.00 }]
});Пример условный и не содержит реальных заказов. Google рекомендует для `refund` передавать `transaction_id`, а для возврата части заказа — ещё и позиции с `item_id` и quantity. `return_reason` и `return_id` — пользовательские параметры вашего контракта, а не стандартные поля GA4.
Параметр отправлен — ещё не значит, что он есть в отчёте
GA4 принимает custom event parameters, но для анализа значения в интерфейсе нужно создать соответствующую event-scoped custom dimension. Имя параметра в настройке должно совпадать с отправляемым. После изменения не оценивайте старые события как ошибку: новая настройка не обязана превращать прошлый свободный текст в новый код.
- Проверить событие в DebugView или тестовом property.
- Убедиться, что причина лежит на event level, если она одна для возврата.
- Для разных причин по позициям определить item-level схему заранее.
- Не отправлять комментарий сотрудника и персональные данные.
- Сохранить словарь кодов в документации контракта.
Дубли появляются между бизнес-операцией и очередью
Webhook платёжного провайдера, повтор API и ручное подтверждение могут описывать один возврат. Выберите один authoritative момент и сформируйте детерминированный `event_id`, например из return id и версии события. Outbox-запись создаётся в той же транзакции, что и смена статуса; consumer отмечает доставку и безопасно повторяет отправку.
| Симптом | Вероятная причина | Исправление |
|---|---|---|
| Причина `(not set)` | параметр не зарегистрирован/не дошёл | DebugView и custom dimension |
| Две причины на один возврат | два источника события | единый owner и event id |
| В отчёте текстовые варианты | свободный ввод | справочник кодов |
| Нет товаров | событие только на заказ | items для partial refund |
| Причина старая | payload собран до изменения | создавать после commit |
Один контрольный возврат закрывает диагностику
- Создать тестовый заказ и вернуть одну позицию по известной причине.
- Записать order id, return id, item id и reason code.
- Проверить одну outbox/job запись после смены статуса.
- Увидеть один refund event с теми же идентификаторами.
- Повторить обработчик и убедиться, что второе событие не появилось.
- Сверить сумму и количество с операционной базой.
Готовая цепочка отвечает на два независимых вопроса: сколько денег возвращено и почему клиент вернул товар. Для предметного разбора подготовьте обезличенный payload события, схему таблицы возвратов, список кодов причин и один trace фоновой задачи — комментарии клиентов передавать не нужно.