Сначала договориться о предмете счёта

У магазина есть рекламная платформа, сайт, система заказов и финансовая выгрузка. Каждая решает свою задачу. Платформа связывает доступное событие с рекламным контактом, сайт отправляет уведомление об оплате, учётная система хранит состояние заказа. Их поля с названием «конверсия» могут обозначать разные вещи. В словарь нельзя переносить это слово без уточнения действия и источника.

Начать удобно с одного решения. Допустим, директору по маркетингу нужно понимать, сколько оплаченных заказов осталось после полных возвратов в выбранной группе продаж. Это ещё не вопрос о дополнительных продажах благодаря рекламе. Для него нужны иная постановка и контроль. Здесь команда сначала приводит к общему смыслу наблюдаемый результат, чтобы не сравнивать уведомления сайта с заказами магазина.

В MRC Outcomes and Data Quality Standards.pdf) определения результата и расчётов рассматриваются как документированная часть методики. Это основание требовать ясности, а не готовый словарь для любого продавца. Приведённые ниже названия и правила разработаны редакцией для учебной задачи.

Полезно разделить три сущности. Событие сообщает, что система что-то зарегистрировала. Заказ является объектом бизнеса и может пройти несколько состояний. Показатель отбирает объекты по правилу и считает их. Одно уведомление об оплате не обязательно создаёт новый заказ: оно могло повторно прийти после сбоя доставки.

Событие, объект и показатель. Уведомление системы и число подходящих заказов не являются одной единицей.
Уведомление системы и число подходящих заказов не являются одной единицей.

Отдельно записывается единица. В нашей задаче это заказ, а не покупатель, товарная позиция или устройство. Один покупатель с двумя заказами даст два результата. Три вещи внутри одного заказа дадут один. Без этой строки даже аккуратное удаление дублей может уничтожить настоящую вторую покупку или оставить три позиции вместо одной.

Такой словарь дополняет соглашение об учёте событий между системами. Соглашение объясняет расхождение конкретных счётчиков. Словарь нужен, чтобы команда повторяемо принимала и меняла определения во всех следующих кампаниях.

Заполнить карточку определения, а не список сокращений

Первая карточка в примере называется `paid_orders_v1`, по-русски «Оплаченные заказы, версия 1». В неё попадают уникальные заказы, у которых первая подтверждённая оплата произошла в выбранные московские сутки. Полный возврат позже не удаляет исторический факт оплаты. Это осознанное определение, которое годится для оперативного отчёта, но не обещает сохранить деньги продавцу.

Источником подтверждения служит система заказов, а не повторная загрузка страницы благодарности. Идентификатор заказа используется внутри разрешённого контура магазина. Внешнему подрядчику может быть достаточно агрегатов или специально подготовленного технического ключа. Наличие поля в словаре не разрешает передавать его всем участникам закупки.

У карточки есть владелец бизнес-смысла, например руководитель аналитики магазина, и исполнитель преобразования данных. Первый решает, какую покупку считать подходящей. Второй отвечает за реализацию и проверку. Эти роли можно совместить в небольшой команде, но ответственность за изменение не должна оставаться у безымянного «аналитического отдела».

Минимальная карточка содержит следующее:

ПолеЗаполненный пример
Название и версияОплаченные заказы, `paid_orders_v1`
ЕдиницаУникальный заказ магазина
УсловиеЕсть первое подтверждение успешной оплаты
ВремяМомент первой оплаты, сутки Europe/Moscow
ПовторПовторная доставка того же события не создаёт заказ
ВозвратыНе меняют факт оплаты, считаются отдельно
ИсточникСистема заказов; сайт служит дополнительной диагностикой
ОтветственныйРуководитель аналитики; реализация у инженера данных

Для рабочего документа к карточке добавляют доступные поля, допустимые пропуски, дату начала действия, ссылку на преобразование и набор тестов. В открытом CSV-примере словаря эти сведения разложены по строкам. Данные и роли вымышлены; реальные персональные сведения не требуются для понимания правил.

В W3C Data on the Web Best Practices происхождение, качество данных, обозначение версии и история изменений выделены отдельно. Для рекламной команды отсюда следует удобный приём: карточка определения должна показывать, откуда пришёл смысл и чем нынешняя редакция отличается от предыдущей. Само следование этому приёму не означает сертификацию W3C.

Развести повтор события и повторную покупку

В учебном журнале есть восемь строк. Заказ O1 оплачен на 10 тысяч рублей, но уведомление e1 доставлено дважды. У O2 сначала создан заказ, затем прошла оплата 5 тысяч. O3 оплачен на 8 тысяч и полностью возвращён через два дня. O4 на 4 тысячи оплачен вечером предыдущей даты по UTC, уже после московской полуночи. O5 на 6 тысяч оплачен поздно вечером по UTC, когда в Москве наступил следующий день.

Все идентификаторы условные. Буква O здесь обозначает заказ, e1 событие. Ни один из них не связан с реальным покупателем. Учебный JSON-журнал позволяет проверить результат на тех же строках, а не доверять иллюстрации.

Сначала удаляется повторная доставка e1. Затем из оставшегося потока выбираются подтверждения оплаты и определяется первая оплата каждого заказа. Создание O2 не является оплатой. Запись о возврате O3 относится к изменению результата этого заказа и не создаёт ещё одну продажу. Только после этого применяется граница периода.

Уникальность события и уникальность бизнес-объекта решают разные задачи. Если удалять всё по покупателю, можно потерять его второй самостоятельный заказ. Если удалять только одинаковые строки целиком, повтор с другим временем приёма может сохраниться. В карточке нужны ключ события, ключ объекта и правило обработки повторов, а не одно слово «дедупликация».

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

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

Выбрать время результата и границы суток

В примере считаются сутки 1 сентября 2026 года по Москве. Время хранится с обозначением часового пояса. Начало периода соответствует 31 августа в 21:00 UTC, конец 1 сентября в 21:00 UTC. Начальная граница включается, конечная исключается. Это позволяет соседним дням не делить один и тот же момент.

Поэтому O4 с оплатой 31 августа в 21:30 UTC относится к 1 сентября по Москве. O5 с оплатой 1 сентября в 22:30 UTC уже относится ко 2 сентября. Если один отчёт обрезает дату по UTC, а другой по московскому времени, они разойдутся без какого-либо сбоя рекламного счётчика.

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

В карточке задаётся срок обновления отчёта. В учебном сценарии оперативный срез выгружают на следующий день, а окончательный для выбранного правила готовят после согласованного периода возвратов. Сам срок является условием примера, не нормативом для всех магазинов. Если категория допускает более поздние возвраты, их нельзя молча игнорировать ради удобного графика.

У закрытого отчёта также есть дата состояния. Формулировка «заказы 1 сентября по данным на 4 сентября» отличается от «заказы, полученные системой 4 сентября». В первом случае пересчитывается история событий, во втором описан поток загрузки. Для закупки и для поддержки полезны оба, но у них должны быть разные названия.

Этот выбор особенно важен при задержке конверсий. Если поздние результаты постоянно попадают в новый день, автостратегия может учиться на неверном распределении. Словарь не исправляет алгоритм платформы, зато даёт точное описание того, что команда отправляет и когда.

Назвать новое определение новой версией

Теперь директор просит считать заказы, которые остались после полного возврата. Команда создаёт вторую карточку `retained_orders_v2`, «Заказы без полного возврата, версия 2». Она использует тот же день первой оплаты, но исключает полный возврат, известный на дату состояния отчёта. Для нашего примера это 4 сентября в 00:00 по Москве.

Первая версия даёт четыре заказа: O1, O2, O3 и O4. Их исходные оплаты составляют 27 тысяч рублей. Вторая даёт три заказа и 19 тысяч: O3 исключён после возврата 8 тысяч. O5 не входит ни в одну версию за 1 сентября. Первая карточка не стала ошибочной; изменился вопрос, на который отвечает вторая.

Одни строки, две версии. Разницу составляет один полностью возвращённый заказ O3; история первой оплаты сохраняется.
Разницу составляет один полностью возвращённый заказ O3; история первой оплаты сохраняется.

Определение денежного показателя записывается отдельно. «Сумма первых оплат» и «сумма после полных возвратов» различаются. В нашем упрощённом примере нет частичных возвратов, доставки, комиссий, налоговых корректировок и мультивалютности. Поэтому 19 тысяч нельзя назвать прибылью, а 27 тысяч нельзя автоматически сопоставить с доходом рекламной платформы.

Для частичного возврата число сохранённых заказов и сумма могут меняться по-разному. Заказ способен остаться одним заказом, но принести меньше денег. Если команде нужны такие операции, карточки количества и суммы получат свои правила. Подмена суммы количеством или количества деньгами не лечится общей приставкой «net».

Историю лучше хранить в двух слоях. Первый сохраняет опубликованный срез и его версию. Второй содержит позднее пересчитанные значения с новой датой состояния. В отчёте можно показать обе линии и объяснить разницу. Заменить старые четыре на новые три без примечания значит изменить историю так, что следующий аналитик не сможет восстановить прежнее решение.

При этом версия схемы файла и версия бизнес-определения независимы. В JSON Schema Core описан язык структуры JSON. Документ опубликован как Internet-Draft, его нельзя называть окончательным стандартом IETF. Даже корректный по схеме файл с числом 4 не объясняет, какие четыре заказа посчитаны и на какую дату.

Проверить переход на одном наборе данных

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

Переход проверяется заранее. Новая версия проверяется на том же наборе данных, затем переносится в зависимые системы.
Новая версия проверяется на том же наборе данных, затем переносится в зависимые системы.

Ожидаемый результат учебного испытания заранее записан: четыре заказа первой версии, три второй, разница ровно O3. Если появится ещё одно расхождение, инженер не объясняет его общей «новой методикой», а находит строку и условие. Именно ожидаемый список отличий делает переход проверяемым.

Нужны и отрицательные случаи. Созданный, но неоплаченный заказ не попадает в обе версии. Повтор e1 не увеличивает результат. Заказ за конечной временной границей остаётся в следующем дне. Полный возврат после даты состояния не может задним числом проникнуть в сохранённый срез, хотя попадёт в более поздний пересчёт.

Практический порядок приёмки состоит из четырёх шагов. Аналитик описывает смысл и ожидаемые отличия. Инженер воспроизводит расчёт. Владелец финансовой выгрузки проверяет выбранные состояния и суммы. Руководитель отчётности подтверждает названия и отображение версий для пользователя. В маленькой команде роли могут совпасть, но результат проверки всё равно остаётся записанным.

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

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

Перенести определение в отчёты и рекламные системы

У определения обычно несколько потребителей: ежедневная таблица маркетинга, финансовая сводка, отчёт агентства и событие для оптимизации. Команда составляет список зависимостей. Одно переименование в хранилище не гарантирует, что все потребители начали читать новую версию. Копия старой формулы может продолжить жить в личной таблице.

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

Особенно внимательно меняют события, отправляемые в рекламную платформу. Если вместо быстрой оплаты начать передавать результат после длинного периода возвратов, у оптимизатора изменятся задержка и число сигналов. Это продуктовая перемена для закупки, а не косметика названия. Её обсуждают с тем, кто управляет кампанией, и проверяют в отдельном ограниченном запуске.

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

Если внешняя платформа не принимает вашу версию, словарь фиксирует преобразование и потерю смысла. Например, она получает событие оплаты, а возвраты остаются во внутреннем отчёте. Тогда её показатель не переименовывают в «заказы после возвратов». Пользователь видит два уровня результата и понимает, почему значения различаются.

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

Поддерживать словарь через реальные изменения

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

Запрос на изменение объясняет, для какого решения старое определение больше не подходит и какие строки теперь попадут или исчезнут. В нём также записывают последствия для истории и рекламной оптимизации, ответственного за проверку и срок перевода старой версии в режим чтения. Без этих сведений новое название скрывает ещё одну неоговорённую методику.

Отдельно учитывают отсутствие данных. Неизвестное состояние возврата не равно отсутствию возврата. Если система заказов недоступна, карточка описывает неполноту и запрещённые выводы. Иногда корректнее остановить обновление результата и показать время последней полной загрузки, чем заполнить пустые места нулями.

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

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