Корректировки преобразования

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

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

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

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

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

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

  • Если transactionId совпадает с существующей конверсией для того же действия, API Data Manager обрабатывает запрос как корректировку конверсии .
  • Если transactionId не соответствует существующей конверсии, Google Ads создаст новую конверсию . См. раздел «Несоответствующие события» .

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

Для корректировки существующей конверсии отправьте запрос IngestEvents , содержащий:

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

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

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

Для получения дополнительной информации об отправке запросов на прием данных см. руководства по отправке событий для офлайн-конверсий или конверсий из нескольких источников .

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

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

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

Значения преобразования

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

Данные пользователя

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

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

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

Другие области

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

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

Непревзойденные события

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

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