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

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

Если вы переходите с Google Ads 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.