Сопоставления полей

Используйте сопоставления в таблицах, чтобы сопоставить UploadClickConversionRequest в Google Ads API с его эквивалентом IngestEventsRequest в Data Manager API.

Аутентификация

Для Data Manager API требуются учетные данные с другой областью действия, чем для Google Ads API. Следуйте инструкциям в разделе Настройте доступ к API, чтобы создать новые учетные данные, включающие область действия Data Manager API.

Поля запроса

UploadClickConversionRequest (Google Ads API) IngestEventsRequest (Data Manager API) Примечания
  • customer_id
  • Заголовок запроса developer-token
  • Заголовок запроса login-customer_id
  • Заголовок запроса linked-customer-id
  • conversion_action
destinations Подробнее о полях клиентов и действий-конверсий…
Ранее такого отчета не существовало consent Необязательные настройки согласия по умолчанию для событий в запросе. Вы можете переопределить это значение для отдельного события, задав поле consent объекта Event.
Ранее такого отчета не существовало encoding Обязательно. Укажите Encoding, используемый для значений атрибута "UserIdentifier".
Ранее такого отчета не существовало encryption_info Указывается, если запрос содержит зашифрованные значения. Подробнее о шифровании…
job_id Ранее такого отчета не существовало Используйте значение request_id, возвращенное в ответе, чтобы получить диагностику.
partial_failure Ранее такого отчета не существовало В Data Manager API используется модель быстрого обнаружения ошибок. Если какое-либо поле объекта IngestEventsRequest не пройдет проверку, Data Manager API отклонит весь запрос.
validate_only validate_only
conversions events Список конверсий или событий. Подробнее о полях конверсий…

Поля клиентов и действий-конверсий

Google Ads API требует наличия заголовка запроса developer-token. Вы можете задать заголовки login-customer-id и linked-customer-id для разных сценариев аутентификации.

Для Data Manager API не требуется токен разработчика. Информация для входа и данные о связанном клиенте указываются в полях Destination, а не в заголовках запроса. Подробнее о целевых сервисах можно узнать в статье Как настроить целевые сервисы.

Ниже показано, как сопоставить поля Google Ads API для одного conversion_action с эквивалентными полями в Destination:

Google Ads API Destination (Data Manager API) Примечания
customer_id запроса operating_account Установите для параметра account_id идентификатор клиента аккаунта для обработки конверсий Google Рекламы. Это значение может отличаться от значения customer_id в вашем запросе Google Ads API. Задайте для параметра account_type объекта operating_account значение GOOGLE_ADS.
Заголовок запроса developer-token Ранее такого отчета не существовало Для работы с Data Manager API токен разработчика не требуется.
Заголовок запроса login-customer-id login_account Установите для параметра account_id идентификатор клиента аккаунта, в который выполнен вход. Установите для параметра account_type значение GOOGLE_ADS, если аккаунт для входа – это аккаунт Google Рекламы, или DATA_PARTNER, если это аккаунт партнера по обработке данных.
Заголовок запроса linked-customer-id linked_account Если вы открываете operating_account по партнерской ссылке, задайте для параметра account_id идентификатор клиента связанного аккаунта, а для параметра account_type – значение DATA_PARTNER. В противном случае не задавайте поле linked_account.
conversion_action из ClickConversion product_destination_id Числовой идентификатор действия-конверсии. Не используйте название ресурса ConversionAction.
Ранее такого отчета не существовало reference Идентификатор Destination, заданный пользователем. Укажите это поле, если вы отправляете данные о конверсиях для нескольких действий-конверсий в одном запросе.

Поля конверсий

ClickConversion (Google Ads API) Event (Data Manager API) Примечания
cart_data cart_data Подробнее о полях данных корзины…
consent consent В обоих API используется похожий объект Consent (ad_user_data, ad_personalization).
В Data Manager API также можно задать согласие для всех событий в запросе, установив поле consent на уровне запроса.
conversion_action destination_references Если вы отправляете данные о конверсиях для нескольких действий-конверсий в одном запросе, укажите в этом поле соответствующее значение reference из поля destination.
conversion_date_time event_timestamp
  • Если вы используете формат JSON, задайте значение в формате RFC 3339, который немного отличается от формата даты и времени Google Ads API.
  • Если вы используете буферы протоколов, примените Timestamp и задайте значения полей seconds и (необязательно) nanoseconds.

Подробнее о формате временной метки…
conversion_environment Ранее такого отчета не существовало
conversion_value conversion_value Укажите значение в валюте, а не в микроединицах. Например, если ценность конверсии составляет 5,23 долл.США, используйте значение 5.23.
currency_code currency
custom_variables custom_variables Подробнее о полях пользовательских переменных…
customer_type user_properties.customer_type Установите значение из перечисления CustomerType.
Ранее такого отчета не существовало event_source
Ранее такого отчета не существовало event_device_info
external_attribution_data Ранее такого отчета не существовало
gbraid ad_identifiers.gbraid
gclid ad_identifiers.gclid
Ранее такого отчета не существовало last_updated_timestamp
order_id transaction_id
session_attributes_encoded ad_identifiers.session_attributes Подробнее о том, как добавить атрибуты сеанса…
session_attributes_key_value_pairs experimental_fields Подробнее о том, как добавить атрибуты сеанса…
user_identifiers user_data.user_identifiers Подробнее о полях с идентификатором пользователя…
user_ip_address landing_page_device_info.ip_address
wbraid ad_identifiers.wbraid

Поля данных корзины

CartData (Google Ads API) CartData (Data Manager API) Примечания
feed_country_code merchant_feed_label Укажите ярлык фида.
feed_language_code merchant_feed_language_code
items items
local_transaction_cost transaction_discount
merchant_id merchant_id

Поля товаров для данных корзины

Item (Google Ads API) Item (Data Manager API) Примечания
product_id merchant_product_id
quantity quantity
unit_price unit_price
Ранее такого отчета не существовало item_id
Ранее такого отчета не существовало additional_item_parameters

Поля пользовательских переменных

CustomVariable (Google Ads API) CustomVariable (Data Manager API) Примечания
Ранее такого отчета не существовало destination_references Google Ads API требует отправлять отдельные запросы для каждого действия-конверсии. Data Manager API позволяет отправлять конверсии для нескольких действий-конверсий в одном запросе, а также использовать поле destination_references, чтобы указать, в какие целевые сервисы следует передавать определенную специальную переменную.
conversion_custom_variable variable Укажите название переменной, а не название ресурса.
value value

Поля с идентификатором пользователя

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API)
address_info address Соблюдайте правила форматирования и хеширования. Вы также можете зашифровать хешированные атрибуты адреса.
hashed_email email_address Установите форматированный и хешированный адрес электронной почты. Вы также можете зашифровать хешированный адрес электронной почты.
hashed_phone_number phone_number Отформатированный и хешированный номер телефона. Вы также можете зашифровать хешированный номер телефона.
Другие поля:
  • mobile_id
  • third_party_user_id
  • user_identifier_source
Бесполезный Ни один из этих API не поддерживает такие идентификаторы для офлайн-конверсий или расширенного отслеживания конверсий лидов. Кроме того, Data Manager API не поддерживает эти идентификаторы при отправке событий-конверсий в качестве дополнительного источника данных.

Поля ответа

UploadClickConversionResponse (Google Ads API) IngestEventsResponse (Data Manager API) Примечания
job_id Ранее такого отчета не существовало Используйте значение request_id, возвращенное в ответе, чтобы получить диагностику.
partial_failure_error Ранее такого отчета не существовало В Data Manager API используется модель быстрого обнаружения ошибок. Если какое-либо поле объекта IngestEventsRequest не пройдет проверку, Data Manager API отклонит весь запрос.
request-id заголовок ответа request_id Идентификатор запроса возвращается в виде поля ответа в Data Manager API, а не в виде заголовка ответа.
results Ранее такого отчета не существовало Data Manager API обрабатывает события асинхронно. Проверьте результаты обработки с помощью диагностики.