Корректировка конверсий

Используйте метод IngestEvents, чтобы корректировать ранее зарегистрированные конверсии Google Рекламы. В Data Manager API корректировка может пересчитать ценность конверсии или дополнить пользовательские данные.

Если вы переходите с Google Ads API, ознакомьтесь с инструкциями по обновлению, чтобы сравнить, как корректировки обрабатываются в каждом API.

Поддерживаемые типы конверсий

Вы можете изменить следующие типы конверсий Google Рекламы:

Как работают корректировки

В рамках одного действия-конверсии Google Реклама сопоставляет события, используя следующие параметры: transactionId:

  • Если значение transactionId совпадает с существующей конверсией для того же действия-конверсии, Data Manager API обрабатывает запрос как корректировку конверсии.
  • Если transactionId не соответствует существующей конверсии, Google Реклама создает новую конверсию. Подробнее о несопоставленных событиях…

Как отправить корректировку

Чтобы изменить существующую конверсию, отправьте запрос IngestEvents, в котором указаны:

  • Та же transactionId, что и у исходного события.
  • То же целевое действие и действие-конверсия, что и в исходном событии.
  • Новые значения для полей, которые вы хотите изменить.
  • Все поля, необходимые для события, включая хотя бы один идентификатор, например adIdentifiers или userData. Ознакомьтесь с требованиями к событиям и идентификаторам для офлайн-конверсий или конверсий из нескольких источников.

Рекомендуем отправлять те же идентификаторы, которые вы отправили или получили с исходным событием. Если transactionId не соответствует существующей конверсии, Google Реклама использует эти идентификаторы, чтобы связать новую конверсию.

Указывать тип корректировки не нужно. Data Manager API определяет, как обработать запрос, на основе значения поля transactionId и указанных вами полей.

Подробнее о том, как отправлять запросы на загрузку данных о конверсиях из нескольких источников и офлайн-конверсиях…

Поддерживаемые поля

В таблице ниже показано, как Google Реклама применяет каждое поле, когда событие соответствует существующей конверсии.

Поле Поведение
conversionValue, currency Перезаписано. Новое значение заменит записанное.
userData Дополняются, если в исходном событии нет пользовательских данных, в противном случае игнорируются.
Другие поля, например adIdentifiers.gclid. Не обновлено. Google Реклама сохраняет значения, зарегистрированные вместе с исходным событием. Обязательные поля должны быть заполнены.

Ценность конверсий

Отправьте новые значения conversionValue и currency, чтобы переопределить ценность зарегистрированной конверсии. Новое значение заменяет предыдущее в отчетах и при назначении ставок, не увеличивая количество конверсий.

Пользовательские данные

Вот как Google Реклама обрабатывает userData, например адрес электронной почты или номер телефона:

  • Данные дополняются при отсутствии. Если исходное событие было зарегистрировано без пользовательских данных, корректировка добавляет эти данные, чтобы улучшить атрибуцию.

  • Игнорируется, если присутствует. Если тег Google или предыдущая загрузка уже собрали пользовательские данные, новые пользовательские данные игнорируются. Существующие пользовательские данные не перезаписываются и не дополняются.

Другие поля

Идентификаторы и метаданные, отличные от ценности конверсии, валюты и пользовательских данных, например adIdentifiers.gclid, нельзя изменить для сопоставленных событий. Google Реклама сохраняет значения, записанные при исходном событии.

При этом необходимо указать все обязательные поля, например хотя бы один идентификатор. Data Manager API проверяет их для каждого события.

Несопоставленные события

Если значение transactionId не соответствует существующему событию, запрос будет обработан как загрузка новой конверсии, а не корректировка.

Google Реклама попытается связать новую конверсию с кликом по объявлению, используя предоставленные вами идентификаторы, например adIdentifiers.gclid или userData.