У одной операции может быть несколько доставок

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

Документация Measurement Protocol Метрики прямо описывает дополнение обычного веб-счётчика серверными данными. Это конкретная возможность российского инструмента. Она не означает, что любое внутреннее поле магазина станет готовым ключом удаления дублей в любом получателе. Перед подключением разработчик читает требования выбранной платформы и способ связи с уже записанным визитом.

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

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

Согласовать ключ до отправки из браузера

В учебном сервисе сбора событий, который далее называем коллектором, ключ состоит из магазина, типа операции и устойчивого ID операции. Пример: `shop-a / purchase / pay-101`. Названия полей принадлежат нашему примеру. Это не готовый запрос API Метрики или универсальная схема всех рекламных платформ. Если два магазина используют одинаковый номер заказа, идентификатор магазина в ключе разделяет независимые продажи.

Одна операция, два пути. Схема учебного коллектора, не готовый payload внешней платформы.
Схема учебного коллектора, не готовый payload внешней платформы.

Принцип пространства идентификаторов есть в ECAPI 1.0: `data_set_id` отделяет наборы данных, а поле `id` помогает связать один факт из разных источников. В описании этого поля документ также использует обозначение event_id. При реализации важно ориентироваться на фактическую схему и правила получателя, а не переносить название из случайного примера кода.

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

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

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

Определить, кто подтверждает оплату

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

Разработчик отдельно проверяет, как сервер получил статус. Название источника `server` не делает запись достоверной автоматически. Нужны контролируемый отправитель и проверка состояния в системе, которая отвечает за оплату. Поле «подтверждено» в CSV служит условием учебной задачи, а не способом защитить реальный API: в открытом запросе такой флаг мог бы написать кто угодно.

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

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

Пройти девять строк учебного журнала

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

Результат после разбора пакета. Противоречивая A-103 исключена до разбора. Возврат отражён отдельно.
Противоречивая A-103 исключена до разбора. Возврат отражён отдельно.

Второй заказ A-102 подтверждён сервером на 3 000 рублей и принимается отдельно.

У третьего, A-103, два контролируемых серверных сообщения расходятся по сумме: 7 000 и 700 рублей. Наше учебное правило помещает такую операцию на разбор до выгрузки. Затем магазин B присылает собственную покупку B-101 на 4 000 с тем же коротким ID `pay-101`: другое пространство делает её самостоятельной операцией.

Последняя строка сообщает о возврате 3 000 рублей по A-102.

У неё отдельные тип и ключ. Она не увеличивает число покупок и не удаляет историческую запись о первой оплате. Способ передачи корректировки рекламной платформе согласуется с её API; универсальной команды «отменить любую конверсию» этот пример не предполагает.

Итог после разбора всего учебного пакетаЗначение
Полученные передачи9
Принятые операции покупки3
Сумма этих покупок до учёта возврата12 000 рублей
Отдельная операция возврата1 на 3 000 рублей
Противоречивая операция до разбирательстваA-103

Суммы не являются выручкой реального магазина или доказанным эффектом рекламы.

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

Конфликт нельзя закрывать порядком прихода

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

Ненадёжное браузерное сообщение не должно иметь те же полномочия, что проверенная учётная запись.

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

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

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

Проверить включение двумя отдельными испытаниями

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

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

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

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

Оставить владельца и доказательства исправления

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

В пакет приёмки входят исходные учебные строки, ожидаемый итог, версия преобразования, ответы тестового получателя и подтверждение повторного прогона. Рабочий ключ и номер попытки хранятся раздельно. Секретные токены и реальные персональные данные не переносятся в общедоступные примеры или скриншоты. Успешный HTTP-ответ рассматривается вместе с содержанием ответа API и последующим отчётом.

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