Начните с одной строки, которая не сходится
У бренда три отчёта за понедельник. DSP, то есть платформа закупки рекламы, показывает миллион событий. Верификатор насчитал 920 тысяч. В CRM появилось 340 заказов, но рекламная система приписала кампании 390. Все эти цифры могут быть корректными внутри своих правил. Пока правила неизвестны, сравнение итогов мало что объясняет.
В учебной ситуации миллион в DSP оказался числом оплачиваемых показов после собственных исключений. Верификатор получил только часть событий: его код работал не во всех размещениях. А CRM выгрузила подтверждённые заказы по времени создания, тогда как рекламный кабинет считал несколько типов целевых действий по времени рекламного контакта. Исправлять арифметику здесь рано.
Возьмите конкретную строку: одна площадка, один формат, один день, один креатив. Попросите каждую сторону написать обычным языком, какое событие попало в число и какое осталось за его пределами. Если ответ нельзя проверить по выгрузке, определение ещё не готово к работе. Фраза «показы по стандарту платформы» не объясняет, что произошло с рекламой.
Такой документ дальше будем называть соглашением об учёте событий. Это рабочее приложение к настройкам и отчётности, не юридический шаблон и не новый отраслевой стандарт. Его задача скромнее: по любой строке отчёта восстановить, почему она появилась и почему изменилась.
Отделите действие системы от результата для человека
Уведомление о победе в аукционе подтверждает победу ставки. Оно ещё не подтверждает, что объявление загрузилось на устройстве. В OpenRTB 2.6 отдельно описаны уведомление о победе и уведомление о списании; последнее зависит от коммерческих правил биржи. Поддержку этих уведомлений нужно выяснять у участников конкретной интеграции.
Поэтому строку «показ» полезно разложить на несколько наблюдений. Сначала система выбрала ставку. Затем передала рекламный материал. После этого сработал счётчик загрузки или воспроизведения. Отдельный измеритель проверил видимость, если такой замер был доступен. Финансовая система применила правило оплаты. Эти наблюдения связаны, но число на каждом шаге своё.
| Название в соглашении | Что должно произойти | Что этим не подтверждено |
|---|---|---|
| Победа ставки | Биржа отправила уведомление о победе | Загрузка объявления |
| Учтённый показ | Сработал согласованный счётчик показа | Видимость и внимание |
| Оплачиваемое событие | Выполнено условие списания | Продажа товара |
| Измеренный видимый показ | Измеритель подтвердил свой критерий видимости | Что человек запомнил рекламу |
| Подтверждённый заказ | CRM присвоила заказу согласованный статус | Что заказ вызван рекламой |
Таблица защищает от распространённой ошибки закупки: платить за одну величину, а обсуждать качество по другой без связующего расчёта. Для роликов добавляются свои события. Их отличие разобрано в материале об SSAI; универсального «видеопоказа», одинакового для всех способов доставки, в рабочем соглашении лучше не оставлять.
Заполните паспорт каждого события
Вместо общего словаря на десятки страниц начните с пяти событий, от которых зависят деньги и решение о кампании. Для каждого запишите источник, точное условие появления, единицу подсчёта и владельца определения. У показов владельцем может быть технический специалист поставщика, у подтверждённой продажи сотрудник аналитики магазина. Одобрение определения нужно от обеих сторон сверки.
Учебный паспорт события «подтверждённый заказ» содержит такие поля: источник shop-crm, тип order-confirmed, идентификатор order-1842, версия статуса 3, время создания 27 октября в 23:50 по Москве, время подтверждения 28 октября в 09:10, сумма после скидки 4 900 рублей. К рекламному контакту заказ привязывается отдельным правилом атрибуции. Сам идентификатор не доказывает связь с рекламой.
Выгрузку без персональных данных можно обсуждать с подрядчиком. Телефон и адрес покупателя для проверки количества заказов обычно не нужны. В конкретном проекте перечень полей и доступ к ним согласуют с ответственными за данные: наличие технического поля ещё не даёт права передавать его всем участникам цепочки.
Для показа аналогичный паспорт включает источник события, его идентификатор, кампанию, площадку, формат, версию креатива, время возникновения и получения, а также состояние фильтра качества. Денежное поле хранится с валютой, единицей цены и точностью. Иначе сумма 120 может означать рубли за тысячу показов, копейки за один показ или цену в другой валюте.
Если какой-то реквизит недоступен, это записывают прямо. При отсутствии идентификаторов отдельных показов стороны переходят к агрегатам по одинаковым размещениям и времени. У такого сравнения ниже точность: совпадение дневных итогов не исключает, что одна группа событий потерялась, а другая посчиталась дважды.
Повторная доставка не должна становиться новым событием
Система получила подтверждение, но ответ потерялся по дороге. Отправитель повторил сообщение. В сыром журнале теперь две строки об одном заказе. Если считать строки, продажи вырастут без второго покупателя.
В CloudEvents 1.0.2 событие различают по паре источника и идентификатора. Повторная доставка может сохранить тот же идентификатор. Это полезный инженерный принцип для собственного учёта; применять весь формат CloudEvents в рекламной интеграции ради этого необязательно.
В нашем примере сообщения shop-crm / order-1842 с одной версией статуса считаются одной записью, сколько бы раз они ни пришли. Идентификатор 1842 из другого магазина не объединяют с ним автоматически: пространства идентификаторов различаются. А новая версия статуса того же заказа требует обновления состояния, а не добавления ещё одной продажи.
Такое правило нуждается в сроке хранения ключей повторов. Если журнал защищён от дублей только сутки, сообщение, доставленное через два дня, снова может попасть в счётчик. Срок выбирают по фактическим задержкам и требованиям системы, фиксируют в соглашении и проверяют отдельным испытанием. Число дней из чужой статьи здесь не поможет.
Есть и обратная ошибка. Два разных рекламных показа могут иметь одинаковый номер из-за сбоя генератора идентификаторов. Автоматическое объединение скроет реальную доставку. Поэтому в проверку входят источник ключа, область его уникальности и случаи конфликтующих реквизитов. Совпавший ключ с разными кампаниями отправляют на разбор, а не молча удаляют.
Договоритесь о двух часах и границе суток
Событие произошло в 23:58, сервер получил его в 00:03. По первому времени оно относится ко вторнику, по второму к среде. При сравнении российских и зарубежных систем добавляется часовой пояс: календарная дата в UTC не всегда совпадает с московской.
В соглашении нужны оба времени: когда событие произошло и когда его приняла система. Для бизнес-отчёта выбирают одно, второе оставляют для расследования задержек. Период задают точными границами: например, начиная с полуночи 27 октября по Москве и до полуночи 28 октября, не включая её. Запись «за 27-е» слишком короткая для обмена между системами.
Учебная сверка показывает 10 000 полученных сообщений. Среди них 200 повторов с теми же ключами. После исключения повторов остаётся 9 800 событий. Из них 300 произошли за пределами выбранных суток, а 100 пока не имеют подтверждённого времени возникновения. Сопоставимая база на текущий момент составляет 9 400 событий. Сотню неопределённых записей показывают отдельно, не распределяют по датам наугад.
У второго участника на той же базе 9 350 событий. Разница составляет 50, или около 0,53% от базы 9 400. Это предмет дальнейшей проверки. Первоначальный разрыв между 10 000 и 9 350 был смесью повторов, периода и неизвестного времени; объявлять все 650 событий потерянными показами было бы ошибкой.

Наблюдение за поздними поступлениями помогает выбрать срок закрытия отчёта. Например, команда сохраняет предварительную версию утром следующего дня, затем повторяет выгрузку через согласованный интервал. Сам интервал в этом примере не норматив. Его определяют по журналу задержек, договору и тому, какое решение принимают по данным.
Сохраняйте этапы фильтрации
Некачественный трафик, или IVT, исключают на разных этапах. В отчёте полезно видеть исходное число, исключения и итог после фильтров. Документ MRC по IVT, июнь 2020, раздел 6 разделяет уровни такой отчётности. Он не устанавливает автоматический возврат денег за любое расхождение между поставщиками.
Предположим, из 9 400 сопоставимых событий первый фильтр исключил 400. Второй нашёл ещё 250 подозрительных событий, но 150 из них уже входят в первые 400. Уникальных исключений получается 500, итог после обоих фильтров 8 900. Если вычесть 400 и 250 целиком, отчёт потеряет 150 событий второй раз.
Здесь нужна связь между этапами, а не две итоговые доли в процентах. Когда индивидуальные ключи недоступны, поставщик должен описать метод определения пересечения и его ограничения. Без этого точный общий остаток получить нельзя. Допустимо показать диапазон или оставить показатель несогласованным; придумывать точность ради красивого отчёта хуже.
Отдельно храните недоступные измерению события. Показ, к которому не удалось подключить проверку, не становится автоматически качественным или мошенническим. Он остаётся неизмеренным по этому критерию. Для приёмки кампании команда заранее решает, какую долю и какие виды неизмеренного объёма готова принять и чем подтвердит остальное.
Если спор дошёл до счёта, следующая задача уже коммерческая: установить, какие спорные события действительно оплачивались. Для неё есть пошаговая сверка IVT и перерасчёта. Соглашение об учёте даёт исходные данные, но не подменяет условия договора.
Заказ может изменить статус после закрытия дня
Вчерашние 340 подтверждённых заказов сегодня превратились в 332: восемь покупателей отменили покупку. Это не обязательно ошибка выгрузки. Если цель кампании связана с выкупом или чистой выручкой, изменение должно попасть в отчёт по заранее выбранному правилу.
Есть два полезных представления. Первое сохраняет события на дату их возникновения: заказ создан, подтверждён, отменён. Второе показывает последнее известное состояние каждого заказа. Они отвечают на разные вопросы. Количество созданных заказов за день нельзя незаметно заменить количеством оставшихся заказов на конец недели под тем же названием столбца.
В учебном паспорте order-1842 версия 3 означает подтверждение, версия 4 означает отмену. При расчёте текущей подтверждённой выручки действует версия 4. В журнале операций остаются обе версии, иначе аналитик не объяснит изменение вчерашнего отчёта. Отмена не создаёт отрицательного нового клиента и не удаляет факт прежнего рекламного контакта.

У исправления есть причина и время. Ошибку суммы, возврат товара и пересчёт атрибуции лучше кодировать раздельно. Для финансового отдела это разные основания изменения. Для обучения автоматической стратегии тоже: поздняя продажа и ошибочно задвоенный заказ по-разному влияют на качество входных данных.
Такая история особенно полезна, когда агентство получает CRM-данные раз в сутки, а внутренний аналитик смотрит их почти в реальном времени. Оба могут видеть правильные версии с разным временем обновления. В отчёте добавляют момент выгрузки и номер версии набора данных, затем сравнивают одинаковые состояния.
Зафиксируйте минимальное соглашение на одной странице
Заполненный образец можно скачать в CSV. Это учебная таблица полей и решений, а не выгрузка пользователей. В проекте к ней добавляют владельцев, согласованный срок закрытия и ссылки на доступные технические журналы.
| Поле соглашения | Учебное решение |
|---|---|
| Событие для сверки | Учтённый показ после удаления повторов, до фильтров качества |
| Ключ повтора | Источник события и идентификатор |
| День отчёта | Время возникновения, московский часовой пояс |
| Время получения | Храним отдельно для проверки задержек |
| Неизвестное время | Отдельная группа, не включаем в точную дневную базу |
| Этапы фильтров | Исходная база, уникальные исключения, остаток |
| Исправления | Новая версия с причиной, старая доступна для проверки |
| Заказ | Отдельные статусы создания, подтверждения и отмены |
| Неизмеренный объём | Отдельный показатель с причиной отсутствия замера |
После согласования проведите небольшую техническую приёмку. Отправьте одно событие дважды, одно с задержкой через полночь, одно с исправленным статусом и одно с отсутствующим обязательным полем. Проверяющий заранее знает ожидаемый результат. Если два повтора снова увеличили продажи, формальное согласие в документе ещё не превратилось в работающую систему.
В журнал испытания записывают исходные сообщения, ожидаемое число, фактическое число и версию правил. Реальные персональные данные для него не нужны. Ошибку исправляют в тестовой среде, после чего весь набор запускают ещё раз: исправление дублей не должно ломать отмены.
Как разбирать остаточное расхождение
Когда определения совпали, сравните один и тот же срез последовательно: получение сообщения, удаление повторов, выбор периода, применение фильтра, финансовый учёт. На каждом шаге сохраняйте вход, выход и причину исключения. Общий процент расхождения без такого пути плохо помогает технической команде.
Допуск тоже привязывают к событию. Допустимая разница агрегированных показов не обязана подходить для количества дорогих подтверждённых заказов. В некоторых интеграциях событие вообще невозможно сопоставить поштучно, и команда выбирает более грубую проверку. Это ограничение измерения отражают в решении о закупке, а не скрывают в примечании к таблице.
Для российской кампании полезно заранее назвать сотрудника, который может остановить спорное списание на проверку, и того, кто подтверждает итоговый набор данных. Самостоятельно менять официальные документы по технической таблице нельзя: порядок корректировки определяется отношениями сторон. Здесь описан способ собрать доказательства, а не правовая инструкция.
Начать можно с одной действующей кампании и одного спорного дня. Если участники восстановили все переходы от исходных сообщений к оплачиваемому объёму, переносите те же поля в следующую интеграцию. Определения измерения и окна атрибуции стоит закрепить в рабочем словаре команды; практическая проверка programmatic-отчёта поможет сверить уже собранную таблицу.





