Conversion API: как передавать конверсии с сервера

Conversion api — практическая система, в которой подтверждённые конверсии доходят до рекламной платформы с нужными идентификаторами и без дублей.

28 октября 2026 15 мин чтения
Одна конверсия — два сигнала
Одна конверсия — два сигнала

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

В этом руководстве разбираем отдельный интент: Передача рекламным платформам конкретных конверсионных событий через серверный API. U728 остаётся общей архитектурой server-side аналитики, U860 — загрузкой офлайн-конверсий. Пример для сквозной проверки: CRM подтверждает качественный лид и отправляет серверное событие вместе с event_id браузерной копии. Цель — не внедрить больше полей, а сделать ход решения видимым для клиента и команды.

ЭтапДействиеКритерий
01Выбрать итоговую конверсиюдля «Conversion API» есть владелец и артефакт
02Описать контракт событиядля «Conversion API» есть владелец и артефакт
03Собрать разрешённые идентификаторыдля «Conversion API» есть владелец и артефакт
04Связать браузер и сервер event_idдля «Conversion API» есть владелец и артефакт
05Передать время и источникдля «Conversion API» есть владелец и артефакт
06Нормализовать и защитить данныедля «Conversion API» есть владелец и артефакт

Выбрать итоговую конверсию: Conversion API

Зафиксируйте исходное обещание до первого изменения. Для серверной конверсии операция «выбрать итоговую конверсию» сохраняет связь с исходным пользовательским событием. маркетинговый аналитик получает «карточка приёмки «выбрать итоговую конверсию» с версией правила; отдельный контроль — артефакт операции «выбрать итоговую конверсию» для темы «Conversion API»: готовая URL и строка параметров» по примеру «ситуация «при действии «выбрать итоговую конверсию» в теме «Conversion API» возникает отклонение: названия параметров меняются внутри одной кампании» требует от роли «маркетинговый аналитик» выполнить «выбрать итоговую конверсию»; к примеру прикладывается артефакт операции «выбрать итоговую конверсию» для темы «Conversion API»: готовая URL и строка параметров». Признак «при действии «выбрать итоговую конверсию» в теме «Conversion API» возникает отклонение: названия параметров меняются внутри одной кампании» ведёт к дублю или потере сигнала. Контроль ведётся через «доля операций «выбрать итоговую конверсию», принятых без повтора, и время до завершения; разрез для анализа — артефакт операции «выбрать итоговую конверсию» для темы «Conversion API»: готовая URL и строка параметров». Повторная отправка должна быть безопасной, а идентификатор события — стабильным.

  • Рабочий объект: операция «выбрать итоговую конверсию» в контуре «Conversion API».
  • Владелец результата: маркетинговый аналитик.
  • Стоп-сигнал: при действии «выбрать итоговую конверсию» в теме «Conversion API» возникает отклонение: названия параметров меняются внутри одной кампании.
  • Материал приёмки: артефакт операции «выбрать итоговую конверсию» для темы «Conversion API»: готовая URL и строка параметров.

Описать контракт события: Conversion API

Сверьте термин с двумя соседними типами обращений. Для серверной конверсии операция «описать контракт события» сохраняет связь с исходным пользовательским событием. владелец аналитического контракта получает «карточка приёмки «описать контракт события» с версией правила; отдельный контроль — артефакт операции «описать контракт события» для темы «Conversion API»: схема события и снимок dataLayer» по примеру «ситуация «при действии «описать контракт события» в теме «Conversion API» возникает отклонение: событие отправляется до появления обязательных данных» требует от роли «владелец аналитического контракта» выполнить «описать контракт события»; к примеру прикладывается артефакт операции «описать контракт события» для темы «Conversion API»: схема события и снимок dataLayer». Признак «при действии «описать контракт события» в теме «Conversion API» возникает отклонение: событие отправляется до появления обязательных данных» ведёт к дублю или потере сигнала. Контроль ведётся через «доля операций «описать контракт события», принятых без повтора, и время до завершения; разрез для анализа — артефакт операции «описать контракт события» для темы «Conversion API»: схема события и снимок dataLayer». Повторная отправка должна быть безопасной, а идентификатор события — стабильным.

  • Рабочий объект: операция «описать контракт события» в контуре «Conversion API».
  • Владелец результата: владелец аналитического контракта.
  • Стоп-сигнал: при действии «описать контракт события» в теме «Conversion API» возникает отклонение: событие отправляется до появления обязательных данных.
  • Материал приёмки: артефакт операции «описать контракт события» для темы «Conversion API»: схема события и снимок dataLayer.

Собрать разрешённые идентификаторы: Conversion API

Проверьте ключ записи на входах из разных каналов. Для серверной конверсии операция «собрать разрешённые идентификаторы» сохраняет связь с исходным пользовательским событием. администратор GTM получает «карточка приёмки «собрать разрешённые идентификаторы» с версией правила; отдельный контроль — артефакт операции «собрать разрешённые идентификаторы» для темы «Conversion API»: версия контейнера и трасса Preview» по примеру «ситуация «при действии «собрать разрешённые идентификаторы» в теме «Conversion API» возникает отклонение: триггер срабатывает на лишних страницах или дважды» требует от роли «администратор GTM» выполнить «собрать разрешённые идентификаторы»; к примеру прикладывается артефакт операции «собрать разрешённые идентификаторы» для темы «Conversion API»: версия контейнера и трасса Preview». Признак «при действии «собрать разрешённые идентификаторы» в теме «Conversion API» возникает отклонение: триггер срабатывает на лишних страницах или дважды» ведёт к дублю или потере сигнала. Контроль ведётся через «доля операций «собрать разрешённые идентификаторы», принятых без повтора, и время до завершения; разрез для анализа — артефакт операции «собрать разрешённые идентификаторы» для темы «Conversion API»: версия контейнера и трасса Preview». Повторная отправка должна быть безопасной, а идентификатор события — стабильным.

  • Рабочий объект: операция «собрать разрешённые идентификаторы» в контуре «Conversion API».
  • Владелец результата: администратор GTM.
  • Стоп-сигнал: при действии «собрать разрешённые идентификаторы» в теме «Conversion API» возникает отклонение: триггер срабатывает на лишних страницах или дважды.
  • Материал приёмки: артефакт операции «собрать разрешённые идентификаторы» для темы «Conversion API»: версия контейнера и трасса Preview.

Связать браузер и сервер event_id: Conversion API

Назовите сотрудника, который вправе принять итог. Для серверной конверсии операция «связать браузер и сервер event_id» сохраняет связь с исходным пользовательским событием. инженер интеграции получает «карточка приёмки «связать браузер и сервер event_id» с версией правила; отдельный контроль — артефакт операции «связать браузер и сервер event_id» для темы «Conversion API»: event_id и ответ платформы» по примеру «ситуация «при действии «связать браузер и сервер event_id» в теме «Conversion API» возникает отклонение: клиентская и серверная копии не имеют общего event_id» требует от роли «инженер интеграции» выполнить «связать браузер и сервер event_id»; к примеру прикладывается артефакт операции «связать браузер и сервер event_id» для темы «Conversion API»: event_id и ответ платформы». Признак «при действии «связать браузер и сервер event_id» в теме «Conversion API» возникает отклонение: клиентская и серверная копии не имеют общего event_id» ведёт к дублю или потере сигнала. Контроль ведётся через «доля операций «связать браузер и сервер event_id», принятых без повтора, и время до завершения; разрез для анализа — артефакт операции «связать браузер и сервер event_id» для темы «Conversion API»: event_id и ответ платформы». Повторная отправка должна быть безопасной, а идентификатор события — стабильным.

  • Рабочий объект: операция «связать браузер и сервер event_id» в контуре «Conversion API».
  • Владелец результата: инженер интеграции.
  • Стоп-сигнал: при действии «связать браузер и сервер event_id» в теме «Conversion API» возникает отклонение: клиентская и серверная копии не имеют общего event_id.
  • Материал приёмки: артефакт операции «связать браузер и сервер event_id» для темы «Conversion API»: event_id и ответ платформы.

Передать время и источник: Conversion API

Разберите приоритет на обычном и критическом случаях. Для серверной конверсии операция «передать время и источник» сохраняет связь с исходным пользовательским событием. аналитик GA4 получает «карточка приёмки «передать время и источник» с версией правила; отдельный контроль — артефакт операции «передать время и источник» для темы «Conversion API»: payload, код ответа и событие в отладке» по примеру «ситуация «при действии «передать время и источник» в теме «Conversion API» возникает отклонение: запрос принят endpoint, но потерял сессию или время события» требует от роли «аналитик GA4» выполнить «передать время и источник»; к примеру прикладывается артефакт операции «передать время и источник» для темы «Conversion API»: payload, код ответа и событие в отладке». Признак «при действии «передать время и источник» в теме «Conversion API» возникает отклонение: запрос принят endpoint, но потерял сессию или время события» ведёт к дублю или потере сигнала. Контроль ведётся через «доля операций «передать время и источник», принятых без повтора, и время до завершения; разрез для анализа — артефакт операции «передать время и источник» для темы «Conversion API»: payload, код ответа и событие в отладке». Повторная отправка должна быть безопасной, а идентификатор события — стабильным.

  • Рабочий объект: операция «передать время и источник» в контуре «Conversion API».
  • Владелец результата: аналитик GA4.
  • Стоп-сигнал: при действии «передать время и источник» в теме «Conversion API» возникает отклонение: запрос принят endpoint, но потерял сессию или время события.
  • Материал приёмки: артефакт операции «передать время и источник» для темы «Conversion API»: payload, код ответа и событие в отладке.

Нормализовать и защитить данные: Conversion API

Передайте карточку другой смене без устной подсказки. Для серверной конверсии операция «нормализовать и защитить данные» сохраняет связь с исходным пользовательским событием. специалист по приватности получает «карточка приёмки «нормализовать и защитить данные» с версией правила; отдельный контроль — артефакт операции «нормализовать и защитить данные» для темы «Conversion API»: последовательность default и update» по примеру «ситуация «при действии «нормализовать и защитить данные» в теме «Conversion API» возникает отклонение: состояние по умолчанию задаётся после запуска тегов» требует от роли «специалист по приватности» выполнить «нормализовать и защитить данные»; к примеру прикладывается артефакт операции «нормализовать и защитить данные» для темы «Conversion API»: последовательность default и update». Признак «при действии «нормализовать и защитить данные» в теме «Conversion API» возникает отклонение: состояние по умолчанию задаётся после запуска тегов» ведёт к дублю или потере сигнала. Контроль ведётся через «доля операций «нормализовать и защитить данные», принятых без повтора, и время до завершения; разрез для анализа — артефакт операции «нормализовать и защитить данные» для темы «Conversion API»: последовательность default и update». Повторная отправка должна быть безопасной, а идентификатор события — стабильным.

  • Рабочий объект: операция «нормализовать и защитить данные» в контуре «Conversion API».
  • Владелец результата: специалист по приватности.
  • Стоп-сигнал: при действии «нормализовать и защитить данные» в теме «Conversion API» возникает отклонение: состояние по умолчанию задаётся после запуска тегов.
  • Материал приёмки: артефакт операции «нормализовать и защитить данные» для темы «Conversion API»: последовательность default и update.

Реализовать повтор с ограничением: Conversion API

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

  • Рабочий объект: операция «реализовать повтор с ограничением» в контуре «Conversion API».
  • Владелец результата: владелец сайта.
  • Стоп-сигнал: при действии «реализовать повтор с ограничением» в теме «Conversion API» возникает отклонение: выбор пользователя визуально есть, но не применяется к хранилищам.
  • Материал приёмки: артефакт операции «реализовать повтор с ограничением» для темы «Conversion API»: сохранённый выбор и состояние тегов.

Проверять ответы API: Conversion API

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

  • Рабочий объект: операция «проверять ответы API» в контуре «Conversion API».
  • Владелец результата: аналитик качества лидов.
  • Стоп-сигнал: при действии «проверять ответы API» в теме «Conversion API» возникает отклонение: защитное правило режет настоящие заявки.
  • Материал приёмки: артефакт операции «проверять ответы API» для темы «Conversion API»: метка причины и ручная выборка.

Сверять с первичной системой: Conversion API

Возьмите рисковый сегмент отдельно от общей средней. Для серверной конверсии операция «сверять с первичной системой» сохраняет связь с исходным пользовательским событием. владелец сквозной аналитики получает «карточка приёмки «сверять с первичной системой» с версией правила; отдельный контроль — артефакт операции «сверять с первичной системой» для темы «Conversion API»: таблица связей Client ID с заявкой» по примеру «ситуация «при действии «сверять с первичной системой» в теме «Conversion API» возникает отклонение: один идентификатор ошибочно считается постоянным пользователем» требует от роли «владелец сквозной аналитики» выполнить «сверять с первичной системой»; к примеру прикладывается артефакт операции «сверять с первичной системой» для темы «Conversion API»: таблица связей Client ID с заявкой». Признак «при действии «сверять с первичной системой» в теме «Conversion API» возникает отклонение: один идентификатор ошибочно считается постоянным пользователем» ведёт к дублю или потере сигнала. Контроль ведётся через «доля операций «сверять с первичной системой», принятых без повтора, и время до завершения; разрез для анализа — артефакт операции «сверять с первичной системой» для темы «Conversion API»: таблица связей Client ID с заявкой». Повторная отправка должна быть безопасной, а идентификатор события — стабильным.

  • Рабочий объект: операция «сверять с первичной системой» в контуре «Conversion API».
  • Владелец результата: владелец сквозной аналитики.
  • Стоп-сигнал: при действии «сверять с первичной системой» в теме «Conversion API» возникает отклонение: один идентификатор ошибочно считается постоянным пользователем.
  • Материал приёмки: артефакт операции «сверять с первичной системой» для темы «Conversion API»: таблица связей Client ID с заявкой.

Контролировать качество сопоставления: Conversion API

Назначьте дату повторного замера и условие возврата. Для серверной конверсии операция «контролировать качество сопоставления» сохраняет связь с исходным пользовательским событием. аналитик Яндекс Метрики получает «карточка приёмки «контролировать качество сопоставления» с версией правила; отдельный контроль — артефакт операции «контролировать качество сопоставления» для темы «Conversion API»: карта цели и тестовая конверсия» по примеру «ситуация «при действии «контролировать качество сопоставления» в теме «Conversion API» возникает отклонение: цель фиксирует клик вместо подтверждённого результата» требует от роли «аналитик Яндекс Метрики» выполнить «контролировать качество сопоставления»; к примеру прикладывается артефакт операции «контролировать качество сопоставления» для темы «Conversion API»: карта цели и тестовая конверсия». Признак «при действии «контролировать качество сопоставления» в теме «Conversion API» возникает отклонение: цель фиксирует клик вместо подтверждённого результата» ведёт к дублю или потере сигнала. Контроль ведётся через «доля операций «контролировать качество сопоставления», принятых без повтора, и время до завершения; разрез для анализа — артефакт операции «контролировать качество сопоставления» для темы «Conversion API»: карта цели и тестовая конверсия». Повторная отправка должна быть безопасной, а идентификатор события — стабильным.

  • Рабочий объект: операция «контролировать качество сопоставления» в контуре «Conversion API».
  • Владелец результата: аналитик Яндекс Метрики.
  • Стоп-сигнал: при действии «контролировать качество сопоставления» в теме «Conversion API» возникает отклонение: цель фиксирует клик вместо подтверждённого результата.
  • Материал приёмки: артефакт операции «контролировать качество сопоставления» для темы «Conversion API»: карта цели и тестовая конверсия.

Матрица контроля и владения

ПроверкаДоказательствоКогда смотреть
Полнотавход, история и итог «Conversion API» связаныежедневно
Сроктаймер «Conversion API» имеет начало, паузы и финишеженедельно
Качествовыборка «Conversion API» сверена с исходникамиеженедельно
Причинаотклонение «Conversion API» привязано к этапуежемесячно
Эффектдля «Conversion API» есть исходная и контрольная линиипосле каждого изменения

Что изучить дальше

Чек-лист запуска

  • Граница «Conversion API» записана одним предложением.
  • Каждый статус «Conversion API» означает наблюдаемое состояние.
  • Для риска «Conversion API» есть ручной маршрут.
  • Поля «Conversion API» собираются только для решения.
  • Версия правила «Conversion API» сохраняется с результатом.
  • Исходная линия «Conversion API» снята до автоматизации.
  • Метрики «Conversion API» разделены по типу и сложности.
  • Для «Conversion API» назначены дата проверки и откат.

Остался вопрос по теме статьи? Напишите его в предложку блога — отвечаю лично: задать вопрос в MAX. Частые вопросы разбираю отдельными статьями и присылаю ссылку тому, кто спросил.

Частые вопросы

С чего начать работу по теме «Conversion API»?

Для «Conversion API» выберите один поток, зафиксируйте исходные метрики и пройдите весь цикл вручную. После этого будет видно, какой шаг требует изменения.

Какую метрику выбрать для «Conversion API»?

Основной набор: принятые события, качество сопоставления, дубли, задержка и доля ошибок API. Обязательно разделяйте его по типу запроса, каналу и сложности.

Когда нужна ручная проверка в «Conversion API»?

Для «Conversion API» ручная проверка нужна при новой теме, низкой уверенности автоматики, высоком риске для клиента и после изменения правил.

Как понять, что «Conversion API» работает?

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

Как часто пересматривать правила «Conversion API»?

Правила «Conversion API» пересматривают раз в месяц при стабильном потоке и сразу после релиза, нового канала или заметного сдвига защитной метрики.

Статья помогла?
Николай Шаповалов Николай Шаповалов Основатель Tapbox, делает сервисы для MAX Канал автора в MAX

Читайте дальше