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

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

Поля запроса

UploadClickConversionRequest (Google Ads API) IngestEventsRequest (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 Нет эквивалента API менеджера данных не поддерживает частичную проверку на ошибки. Если какое-либо поле запроса IngestEventsRequest не проходит проверку, API менеджера данных отклоняет весь запрос.
validate_only validate_only
conversions events Список конверсий или событий. Подробности см. в разделе «Поля конверсий» .

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

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

API Data Manager не требует токена разработчика, а информация об авторизации и связанных клиентах указывается с помощью полей объекта Destination , а не заголовков запроса. Дополнительную информацию об объектах Destination см. в разделе «Настройка объектов Destination».

Вот как сопоставить поля Google Ads API для отдельного conversion_action с соответствующими полями в Destination :

API Google Ads Destination (API менеджера данных) Примечания
customer_id запроса operating_account Установите account_id равным идентификатору клиента аккаунта конверсий Google Ads . Установите account_type для operating_account равным GOOGLE_ADS .

Для API Data Manager может потребоваться другой идентификатор клиента, отличный от того, который вы используете для API Google Ads. Подробнее см. раздел «Различия в требованиях к целевым аккаунтам» .

заголовок запроса developer-token Нет эквивалента Для использования API Data Manager токен разработчика не требуется.
заголовок запроса login-customer-id login_account Установите account_id равным идентификатору клиента учетной записи для входа. Установите account_type равным GOOGLE_ADS , если учетная запись является учетной записью Google Ads, или DATA_PARTNER если учетная запись является учетной записью партнера по данным.
заголовок запроса linked-customer-id linked_account Установите account_id равным идентификатору клиента связанной учетной записи. Установите account_type равным DATA_PARTNER .
conversion_action элемента ClickConversion product_destination_id Установите значение, равное числовому идентификатору действия преобразования. Не используйте имя ресурса ConversionAction .
Нет эквивалента reference Пользовательский идентификатор для Destination назначения. Заполните это поле, если вы отправляете данные о конверсиях для нескольких действий конверсии в одном запросе .

Поля преобразования

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

Подробности см. в формате временной метки .
conversion_environment Нет эквивалента
conversion_value conversion_value Укажите значение в валюте, а не в микросекундах. Например, для конвертируемой суммы в 5,23 доллара используйте значение 5.23 .
currency_code currency
custom_variables custom_variables Подробности см. в разделе «Поля пользовательских переменных» .
customer_type
Нет эквивалента 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 (API Google Ads) CartData (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 (API менеджера данных) Примечания
product_id merchant_product_id
quantity quantity
unit_price unit_price
Нет эквивалента item_id
Нет эквивалента additional_item_parameters

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

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

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

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

Поля ответа

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