Используйте сопоставления в таблицах, чтобы сопоставить запрос на сбор данных Measurement Protocol (/mp/collect) с его эквивалентом IngestEventsRequest в Data Manager API.
Аутентификация
Для Data Manager API требуются учетные данные OAuth, а не api_secret. Следуйте инструкциям в статье Как настроить доступ к API, чтобы создать новые учетные данные, включающие область действия Data Manager API.
Поля запроса
Запрос /mp/collect (Measurement Protocol) |
IngestEventsRequest (Data Manager API) |
Примечания |
|---|---|---|
measurement_id (параметр запроса) |
destinations |
Сопоставьте с product_destination_id для веб-событий. Подробнее о полях целевой страницы… |
firebase_app_id (параметр запроса) |
destinations |
Сопоставление с product_destination_id для событий в приложении. Подробнее о полях целевой страницы… |
api_secret (параметр запроса) |
Ранее такого отчета не существовало | Подробнее о том, как настроить доступ к API… |
consent |
consent |
Установите объект Consent. |
events |
events |
Установите список ресурсов Event. Подробнее о полях событий… |
client_id |
events.client_id |
Обязательно для событий на сайте. |
app_instance_id |
events.app_instance_id |
Обязательно для событий в приложении. |
user_id |
events.user_id |
Необязательное поле. Уникальный идентификатор пользователя. |
timestamp_micros |
events.event_timestamp |
В Measurement Protocol это можно указать на уровне запроса или отдельного события. В Data Manager API нет временной метки на уровне запроса. Для каждого события задайте в параметре event_timestamp время, когда оно произошло.
Подробнее о формате временных меток… |
user_properties |
events.user_properties |
Установите объект API Менеджера данных не поддерживает установку временных меток для отдельных свойств пользователя. Временные метки, связанные с изменениями свойств пользователя, выводятся из временной метки события ( |
user_data |
events.user_data |
Установите объект UserData. Подробнее о полях с идентификатором пользователя… |
non_personalized_ads |
events.consent.ad_personalization |
Если non_personalized_ads равно true, задайте для ad_personalization значение CONSENT_DENIED. |
user_location |
events.event_location |
Подробнее о полях местоположения пользователя… |
ip_override |
events.event_device_info.ip_address |
|
device |
events.event_device_info |
Подробнее о полях устройств… |
user_agent |
events.event_device_info.user_agent |
|
validation_behavior |
Ранее такого отчета не существовало | Используйте Диагностику, чтобы узнать статус загрузки, а также ошибки и предупреждения для отдельных событий во время последующей обработки. Если IngestEventsRequest завершится ошибкой (например, из-за отсутствия обязательных полей), события не будут обработаны. Вам потребуется устранить ошибку и повторить запрос. Подробнее об ошибках API… |
/debug/mp/collect |
validate_only |
Задайте для параметра validate_only значение true, чтобы проверять события без получения данных, как на сервере валидации Measurement Protocol. |
| Ранее такого отчета не существовало | encoding |
Обязательно для загрузки файлов UserData. Укажите Encoding, используемый для значений UserIdentifier. |
Целевые поля
Measurement Protocol отправляет события непосредственно в определенный поток данных с помощью параметра запроса measurement_id или firebase_app_id.
В Data Manager API объект Destination используется для указания места, куда нужно отправлять данные.
Подробнее о настройке целевых страниц…
Ниже описано, как сопоставить поля Measurement Protocol с эквивалентными полями в Destination.
| Measurement Protocol | Destination (Data Manager API) |
Примечания |
|---|---|---|
measurement_id (параметр запроса) |
product_destination_id |
Укажите идентификатор потока данных сайта в Google Аналитике. |
firebase_app_id (параметр запроса) |
product_destination_id |
Укажите идентификатор приложения Firebase для потока данных приложения Google Аналитики. |
| Ранее такого отчета не существовало | operating_account |
Задайте для account_id идентификатор ресурса Google Аналитики. Задайте для параметра account_type значение GOOGLE_ANALYTICS_PROPERTY. |
| Ранее такого отчета не существовало | login_account |
Задайте для account_id идентификатор ресурса Google Аналитики. Задайте для параметра account_type значение GOOGLE_ANALYTICS_PROPERTY. |
Поля типа обращения event
Measurement Protocol events[] |
Event (Data Manager API) |
Примечания |
|---|---|---|
name |
event_name |
Если в event_name используется зарезервированное название, API отклоняет событие с ошибкой INVALID_EVENT_NAME. |
| Ранее такого отчета не существовало | event_source |
Значение WEB, если событие было сгенерировано в веб-браузере, и APP, если событие было сгенерировано в приложении. |
| Ранее такого отчета не существовало | destination_references |
Обязательно, если список destinations на уровне запроса содержит несколько Destination Google Аналитики. Добавьте запись, чтобы указать, куда должно отправляться событие. |
timestamp_micros |
event_timestamp |
Подробнее о формате временной метки… |
params.currency |
currency |
|
params.value |
conversion_value |
|
params.customer_type |
user_properties.customer_type |
В Measurement Protocol параметр customer_type задается как параметр события. В Data Manager API задайте его в поле customer_type объекта UserProperties в событии. |
params.transaction_id |
transaction_id |
Обязательный для некоторых событий и вариантов использования. Подробнее о том, как преобразовать данные в объекты Event… |
params.items |
cart_data.items |
Подробнее о полях объектов для данных корзины… |
params.coupon |
cart_data.coupon_codes |
Используйте поле coupon_codes, чтобы указать купоны, примененные к корзине. В Google Аналитику можно передать только один купон. Это не зависит от купонов на уровне Item, которые можно задать с помощью cart_data.items.additional_item_parameters для отдельных товаров. |
params.session_id |
additional_event_parameters |
Сопоставьте с записью, в которой для параметра parameter_name задано значение session_id. |
params.engagement_time_msec |
additional_event_parameters |
Сопоставьте с записью, в которой для параметра parameter_name задано значение engagement_time_msec. |
Другое в категории "params" |
additional_event_parameters |
Сопоставьте другие параметры как список объектов с |
Поля с идентификатором пользователя
Measurement Protocol user_data |
UserIdentifier (Data Manager API) |
Примечания |
|---|---|---|
sha256_email_address[] |
email_address |
Установите форматированный и хешированный адрес электронной почты. Вы также можете зашифровать хешированный адрес электронной почты. |
sha256_phone_number[] |
phone_number |
Отформатированный и хешированный номер телефона. Вы также можете зашифровать хешированный номер телефона. |
address[] |
address |
Задайте объект AddressInfo. Следуйте правилам форматирования и хеширования. |
address[].sha256_first_name |
address.given_name |
Форматированное и хешированное имя. Вы также можете зашифровать хешированное имя. |
address[].sha256_last_name |
address.family_name |
Укажите отформатированную и хешированную фамилию. Вы также можете зашифровать хешированную фамилию. |
address[].country |
address.region_code |
|
address[].postal_code |
address.postal_code |
|
address[].city |
address.city |
Укажите нормализованное название города. Не хешируйте это поле. |
address[].region |
address.administrative_area |
Укажите нормализованный административный район (штат или провинцию). Не хешируйте это поле. |
address[].sha256_street |
address.address_line |
Укажите отформатированный и хешированный почтовый адрес. Вы также можете зашифровать хешированный почтовый адрес. |
Поля товаров для данных корзины
Measurement Protocol items[] |
Item (Data Manager API) |
Примечания |
|---|---|---|
item_id |
item_id |
Обязательно. |
item_name |
additional_item_parameters |
Сопоставьте с записью, в которой для параметра parameter_name задано значение item_name. |
quantity |
quantity |
Обязательно. |
price |
unit_price |
Обязательно. |
| Другие поля объектов | additional_item_parameters |
Сопоставьте другие параметры товаров (например, |
Поля местоположения пользователя
Measurement Protocol user_location |
EventLocation (Data Manager API) |
Примечания |
|---|---|---|
city |
city |
Название города, в котором произошло событие. |
country_id |
region_code |
Укажите двухбуквенный код региона CLDR. |
region_id |
subdivision_code |
Укажите код административной единицы по стандарту ISO 3166-2. |
continent_id |
continent_code |
Укажите код континента в формате UN M49. |
subcontinent_id |
subcontinent_code |
Укажите код субконтинента в формате UN M49. |
Поля устройств
Measurement Protocol device |
DeviceInfo (Data Manager API) |
Примечания |
|---|---|---|
category |
category |
|
language |
language_code |
|
screen_resolution |
screen_height и screen_width |
В Measurement Protocol screen_resolution передается как строка ("1280x720"). В Data Manager API screen_height и screen_width передаются как отдельные целочисленные значения. |
operating_system |
operating_system |
|
operating_system_version |
operating_system_version |
|
model |
model |
|
brand |
brand |
|
browser |
browser |
|
browser_version |
browser_version |