Возьмите один возврат, где оператор точно выбрал причину, и найдите его запись в базе. Если там есть только комментарий вроде «не подошло», аналитике уже нечего надёжно группировать. Добавьте отдельный стабильный код — например, `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

Один контрольный возврат закрывает диагностику

  1. Создать тестовый заказ и вернуть одну позицию по известной причине.
  2. Записать order id, return id, item id и reason code.
  3. Проверить одну outbox/job запись после смены статуса.
  4. Увидеть один refund event с теми же идентификаторами.
  5. Повторить обработчик и убедиться, что второе событие не появилось.
  6. Сверить сумму и количество с операционной базой.

Готовая цепочка отвечает на два независимых вопроса: сколько денег возвращено и почему клиент вернул товар. Для предметного разбора подготовьте обезличенный payload события, схему таблицы возвратов, список кодов причин и один trace фоновой задачи — комментарии клиентов передавать не нужно.

Проверенные источники