Conversion API: как передавать конверсии с сервера
Conversion api — практическая система, в которой подтверждённые конверсии доходят до рекламной платформы с нужными идентификаторами и без дублей.
В этой статье
Коротко. 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»
- first-party data — рядом с темой «Conversion API»
- сквозная аналитика — рядом с темой «Conversion API»
- событийная аналитика — рядом с темой «Conversion API»
- server-side аналитика — рядом с темой «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» пересматривают раз в месяц при стабильном потоке и сразу после релиза, нового канала или заметного сдвига защитной метрики.
Читайте дальше
-
Cookie-баннер для сайта: как собрать согласие для аналитики
Cookie-баннер — практическая система, в которой пользователь понимает категории, может равноценно принять или…
-
Consent Mode: как аналитике учитывать согласие пользователя
Consent mode — практическая система, в которой теги получают состояние согласия до отправки данных и обновляют…
-
Measurement Protocol: отправка событий в GA4 по HTTP
Measurement protocol ga4 — практическая система, в которой серверные и внешние события попадают в GA4 с корректным…