Дата без границ не задаёт одинаковую выборку

Сутки по Москве начинаются в другой момент, чем сутки по UTC. UTC - общая временная шкала, а смещение показывает, на сколько местные часы отличаются от неё в выбранный момент. Для нашего учебного дня используется московское смещение плюс три часа. Событие в 21:00 UTC относится уже к полуночи следующего московского дня.

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

Для третьего ноября 2026 года по Москве наш интервал начинается второго ноября в 21:00 UTC и заканчивается третьего ноября в 21:00 UTC. Запись точно на начале включается. Запись точно на конце относится к следующему дню. Прибавлять к концу искусственные доли секунды не требуется: правило границы остаётся точным при любой согласованной точности данных.

Границы московского дня. Собственное правило интервала: начало включается, конец исключается.
Собственное правило интервала: начало включается, конец исключается.

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

Сохранить момент вместе со смещением

RFC 3339 описывает запись даты и времени для интернет-протоколов. В такой метке Z обозначает нулевое смещение; другое смещение записывается явно. Строка с датой и часами без этих сведений может не определять единственный момент. По ней нельзя безопасно сопоставлять журналы разных систем.

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

При повторяющемся местном часе две записи «01:30» могут относиться к разным моментам. В отдельной учебной паре 1 ноября 2026 года одна метка имеет смещение минус четыре часа, другая минус пять. Это 05:30 и 06:30 UTC соответственно, с расстоянием один час. Удаление смещения сделает две разные записи внешне одинаковыми.

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

Пройти семь событий у границы дня

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

СобытиеМомент UTCДата по МосквеВ московском 3 ноября
Z-102.11, 20:59:5902.11Нет
Z-202.11, 21:00:0003.11Да
Z-302.11, 23:30:0003.11Да
Z-403.11, 00:30:0003.11Да
Z-503.11, 20:59:5903.11Да
Z-603.11, 21:00:0004.11Нет
Z-703.11, 23:30:0004.11Нет

По московскому дню включены Z-2, Z-3, Z-4 и Z-5: четыре события на четыреста рублей. По дню UTC включены Z-4, Z-5, Z-6 и Z-7: тоже четыре события на четыреста рублей. Общие суммы совпали, хотя состав отличается. Поэтому проверка одного итога может не заметить подмену периода.

Равные суммы, разные события. Вымышленные события по 100 рублей.
Вымышленные события по 100 рублей.

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

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

Проверить настройки API, а не только часы компьютера

В API отчётов Яндекс Метрики параметр timezone задаётся смещением в формате плюс или минус часы и минуты. Он влияет на период выборки и связанные с датой и временем группировки. По умолчанию применяется часовой пояс счётчика. Это конкретный контракт продукта: часовой пояс ноутбука аналитика не обязан управлять запросом.

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

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

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

Не перемещать событие по времени доставки

Событие могло произойти до полуночи, а прийти в систему после неё. В нашем дополнительном учебном случае действие произошло третьего ноября в 20:59:59 UTC, а получено в 21:02 UTC. По нашему правилу учитывается время события по Москве, поэтому оно относится к 3 ноября. Дата получения нужна для диагностики задержки и полноты, но не подменяет назначение основной даты молча.

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

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

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

Сверить целый период и его части

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

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

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

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

Закрепить правило в ежедневной выгрузке

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

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

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