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

Используйте сопоставления в таблицах, чтобы сопоставить 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 целевого сервиса.
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 обрабатывает события асинхронно. Проверьте результаты обработки с помощью диагностики.