Используйте метод IngestEvents для внесения корректировок в ранее зарегистрированные конверсии Google Ads. В API Data Manager корректировка может изменить значение конверсии или дополнить данные пользователя.
Если вы переходите с Google Ads API, ознакомьтесь с разделом «Переход с Google Ads API», чтобы сравнить, как обрабатываются изменения в каждом API.
Поддерживаемые типы конверсии
Вы можете настроить следующие типы конверсий в Google Ads:
- Многоисточниковые конверсии : конверсии, зарегистрированные тегом Google вашего сайта для действия конверсии
WEBSITE. - Офлайн-конверсии и улучшенные конверсии для лидов : Ранее загруженные офлайн-события для действия конверсии
UPLOAD_CLICKS.
Как работают корректировки
В рамках одного и того же действия конверсии Google Ads сопоставляет события, используя transactionId :
- Если
transactionIdсовпадает с существующей конверсией для того же действия, API Data Manager обрабатывает запрос как корректировку конверсии . - Если
transactionIdне соответствует существующей конверсии, Google Ads создаст новую конверсию . См. раздел «Несоответствующие события» .
Отправить корректировку
Для корректировки существующей конверсии отправьте запрос IngestEvents , содержащий:
- Идентификатор
transactionIdсовпадает с идентификатором исходного события. - Тот же пункт назначения и то же действие конверсии, что и в исходном событии.
- Обновленные значения для полей, которые вы хотите изменить.
Указывать тип корректировки не требуется. API Data Manager определяет способ обработки запроса на основе transactionId и предоставленных вами полей.
Для получения дополнительной информации об отправке запросов на прием данных см. раздел «Отправка событий» .
Поддерживаемые поля
В таблице ниже перечислены поля, которые можно изменять, и способы применения обновлений:
| Поле | Поведение |
|---|---|
conversionValue , currency | Перезаписано. Новое значение заменяет записанное. |
userData | Дополняется, если исходное событие не содержало данных о пользователе, в противном случае игнорируется . |
Все остальные поля, такие как adIdentifiers.gclid | Проигнорировано |
Значения преобразования
Отправьте новое conversionValue и currency , чтобы пересчитать значение зарегистрированной конверсии. Новое значение заменит ранее записанное значение в отчетах и ставках, не увеличивая счетчик конверсий.
Данные пользователя
Вот как Google Ads обрабатывает userData , такие как адрес электронной почты или номер телефона:
Дополняется при отсутствии данных: если исходное событие было зафиксировано без пользовательских данных, корректировка добавляет пользовательские данные для улучшения атрибуции.
Если данные пользователя уже присутствуют, они игнорируются: если тег Google или предыдущая загрузка уже содержали данные пользователя, новые данные пользователя игнорируются. Существующие данные пользователя не перезаписываются и не дополняются.
Другие области
Идентификаторы и метаданные, отличные от значения конверсии, валюты и данных пользователя, такие как adIdentifiers.gclid , нельзя обновить для соответствующих событий. Google Ads игнорирует эти поля и сохраняет значения, записанные с исходным событием.
Непревзойденные события
Если transactionId не совпадает с существующим событием, запрос рассматривается как новая загрузка данных о конверсии, а не как корректировка.
Google Ads пытается связать новую конверсию с кликом по объявлению, используя предоставленные вами идентификаторы, такие как adIdentifiers.gclid или userData .