Что именно посчитали стороны

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

В OpenRTB запрос может содержать массив объектов imp. Каждый такой объект описывает предлагаемое рекламное место. Ответная ставка связывается с ним через impid. Идентификатор запроса и идентификатор места выполняют разные задачи. Поле allimps сообщает, охватывает ли предложение весь доступный контекст. Конкретная интеграция может поддерживать часть возможностей протокола. OpenRTB 2.6

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

Сохраните ключи, пока данные ещё доступны

Для учебной сверки достаточно пары request_id и imp_id. Один и тот же короткий номер I1 в разных запросах представляет разные записи. При объединении данных нескольких маршрутов добавьте идентификатор поставщика или биржи и укажите период, в пределах которого идентификаторы запросов уникальны. Выберите часовой пояс выгрузки и версию схемы. Эти детали должны попасть в описание полей, чтобы аналитик следующей смены смог повторить соединение.

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

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

Три запроса превращаются в пять мест

Три запроса содержат пять мест. На четыре места пришлись пять кандидатов, подтверждены две победы и одна доставка.
Учебные счётчики. Разные строки описывают разные объекты.

В учебной выгрузке есть R1 с местами I1 и I2, R2 с I1 и R3 с I1 и I2. Всего три запроса и пять разных пар из запроса и места. Столбец candidates показывает количество предложений покупателя по каждой паре. Он содержит значения 2, 1, 1, 1 и 0. Значит, всего кандидатов пять, а мест хотя бы с одним кандидатом четыре.

Для R1/I1 два кандидата конкурируют за одно место. Из двух записей нельзя автоматически получить два доступных показа. В нашем примере остальные четыре строки также относятся к отдельным местам. Если в фактической интеграции один объект обозначает динамический набор видеопозиций, сначала согласуйте, как он разворачивается. Учебная таблица специально использует более простую модель с одним возможным показом на место.

На схеме рядом числа стоят на разных уровнях. Три сообщения дают пять мест. У четырёх мест есть хотя бы одно предложение. Число отдельных кандидатов снова равно пяти, но совпадение сумм случайное. Увеличьте число альтернатив для R1/I1 с двух до трёх, и кандидатов станет шесть при тех же пяти местах. Именно такой короткий тест помогает увидеть, какой счётчик на самом деле использует отчёт.

Как выбрать знаменатель для участия

Четыре места с кандидатами из пяти дают участие 80 процентов, две победы из четырёх участвовавших мест дают 50 процентов.
Учебная модель. В каждом расчёте явно назван знаменатель.

Если вопрос звучит «по какой доле предложенных мест покупатель сделал ставку», в знаменателе будут пять мест, в числителе четыре. В учебном наборе участие составляет 80%. Если разделить пять кандидатов на пять мест, получится 100%. Этот результат отвечает на вопрос о количестве предложений на место и скрывает, что R3/I2 осталось без ставки.

Можно посчитать и участие на уровне запросов. Все три запроса содержат хотя бы одно место с кандидатом, поэтому результат будет 100%. В отчёте стоит назвать показатель полностью. Например, «запросы хотя бы с одной ставкой» или «места хотя бы с одной ставкой». Такое название позволяет сравнить смены, в которых число мест внутри сообщения менялось.

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

Что считать победой

В учебном примере подтверждены победы по R1/I1 и R3/I1. Это две победившие пары из пяти предложенных мест, или 40%. Если интересует успех среди мест с участием, получим две из четырёх, или 50%. Обе доли можно использовать, если название раскрывает базу. Деление двух побед на три запроса даёт третье число, которое трудно интерпретировать рядом с показателями по местам.

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

При обсуждении прозрачности полезен стандарт MRC по рекламным аукционам. Он даёт рамку для описания процессов и отчётности, но контрольные значения конкретной интеграции придётся получить у её участников. Для договора о сверке попросите указать определение каждого события, доступный журнал и срок, в течение которого его можно запросить. MRC Auction Transparency Standards

Почему победы ещё не сходятся с доставкой

До доставки в учебном наборе дошло R1/I1. У R3/I1 победа есть, а показ не подтверждён. Между этими состояниями может находиться получение креатива, запуск плеера или собственная проверка доставки. Причину в нашем наборе не задавали. Поэтому по двум флагам нельзя утверждать, что площадка потеряла креатив или что покупатель сообщил неверную цену.

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

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

Поддержку протокола проверяют на конкретном маршруте

Таблица полей в общем стандарте помогает сформулировать тест. Документация интегратора показывает, какие объекты он поддерживает и с какими ограничениями. Например, Google публикует отдельное руководство по OpenRTB для Authorized Buyers. При подготовке российской интеграции запросите аналогичную карту у своего поставщика. Совпадение номера версии само по себе не описывает все допустимые ответы. Пример документации интеграции

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

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

Подготовьте двустороннюю сверку

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

Сначала соедините маленький фрагмент без агрегации. Убедитесь, что одному месту действительно соответствуют несколько кандидатов там, где это допускается. Затем соберите итог по местам и только после этого по запросам. При обратном порядке легко размножить строки: присоединение двух кандидатов к одной победе создаст две строки с флагом won. Если просто сложить их, число побед удвоится.

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

Где проверить размножение строк

Возьмите только R1/I1 из учебного набора. Для него есть два кандидата, одна победившая пара и один подтверждённый показ. Если соединить таблицу кандидатов с флагом победы по request_id и imp_id, получите две строки с тем же флагом. Для отчёта об альтернативах это допустимая структура. Для суммирования побед сначала сверните её обратно до одного места или используйте таблицу побед в качестве основания.

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

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

Как принять результат в российской команде

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

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

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