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

Используйте сопоставления в таблицах, чтобы сопоставить 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
  • Заголовок запроса 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 не проходит проверку, API Менеджера данных отклоняет весь запрос.
validate_only validate_only
conversions events Список конверсий или событий. Подробную информацию вы найдете в разделе Поля конверсий.

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

В Google Ads API вы задаете заголовки запросов 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 не используются токены разработчика. В Google Ads 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 целевого ресурса.
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 не проходит проверку, API Менеджера данных отклоняет весь запрос.
request-id заголовок ответа request_id Идентификатор запроса возвращается в поле ответа в Data Manager API, а не в заголовке ответа.
results Ранее такого отчета не существовало Data Manager API обрабатывает события асинхронно. Проверьте результаты обработки с помощью диагностики.