Используйте сопоставления в таблицах, чтобы сопоставить запрос на сбор данных по протоколу измерения ( /mp/collect ) с его эквивалентом в API менеджера данных IngestEventsRequest ).
Поля запроса
Запрос /mp/collect (протокол измерения) | IngestEventsRequest (API менеджера данных) | Примечания |
|---|---|---|
measurement_id (параметр запроса) | destinations | Сопоставьте данные с product_destination_id для веб-событий . Подробности см. в разделе «Поля назначения» . |
firebase_app_id (параметр запроса) | destinations | Сопоставьте данные с product_destination_id для событий приложения . Подробности см. в разделе «Поля назначения» . |
api_secret (Параметр запроса) | Нет эквивалента | См. раздел «Настройка доступа к API» , чтобы узнать, как аутентифицировать запросы в API Data Manager. |
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 это можно указать на уровне запроса или для отдельного события. В API Data Manager метка времени на уровне запроса отсутствует. Установите event_timestamp для каждого события равным времени его возникновения.
Подробности см. в формате временной метки . |
user_properties | events.user_properties | Устанавливается в объект UserProperties . API Data Manager не поддерживает установку временных меток для отдельных свойств пользователя . Временные метки, связанные с изменениями свойств пользователя, определяются на основе временной метки события ( event_timestamp ). |
user_data | events.user_data | Задается объектом UserData . Подробнее см. в разделе «Поля идентификатора пользователя» . |
non_personalized_ads | events.consent.ad_personalization | Если non_personalized_ads имеет true , установите ad_personalization в 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 .
API менеджера данных использует объект Destination для указания места отправки данных. Дополнительную информацию о местах назначения см. в разделе «Настройка мест назначения».
Вот как сопоставить поля протокола измерений с эквивалентными полями в Destination :
| Протокол измерений | Destination (API менеджера данных) | Примечания |
|---|---|---|
measurement_id (параметр запроса) | product_destination_id | Укажите идентификатор измерения потока веб-данных Google Analytics. |
firebase_app_id (параметр запроса) | product_destination_id | Укажите идентификатор приложения Firebase из потока данных приложения Google Analytics. |
| Нет эквивалента | operating_account | Установите account_id равным идентификатору ресурса Google Analytics. Установите account_type равным GOOGLE_ANALYTICS_PROPERTY . |
| Нет эквивалента | login_account | Установите account_id равным идентификатору ресурса Google Analytics. Установите account_type равным GOOGLE_ANALYTICS_PROPERTY . |
Поля событий
events[] | Event (API менеджера данных) | Примечания |
|---|---|---|
name | event_name | Если event_name использует зарезервированное имя , API отклоняет событие с ошибкой INVALID_EVENT_NAME . |
| Нет эквивалента | event_source | Если событие было сгенерировано из веб-браузера, установите значение WEB , а если из приложения APP . |
| Нет эквивалента | destination_references | Этот параметр обязателен, если список destinations на уровне запроса содержит более одного Destination Google Analytics. Добавьте запись, чтобы указать, какой целевой адрес должен получить событие. |
timestamp_micros | event_timestamp |
Подробности см. в формате временной метки . |
params.currency | currency | |
params.value | conversion_value | |
params.customer_type | user_properties.customer_type | В протоколе Measurement Protocol параметр customer_type задается как параметр события. В API Data Manager его следует задать в поле customer_type объекта UserProperties события. |
params.transaction_id | transaction_id | Требуется для некоторых событий и сценариев использования. Дополнительные сведения см. в разделе «Преобразование данных в объекты Event . |
params.items | cart_data.items | Подробную информацию о данных корзины см. в разделе «Поля товара» . |
params.coupon | cart_data.coupon_codes | Используйте поле coupon_codes , чтобы указать купоны, примененные к корзине. Для Google Analytics указывайте только один купон. Это не зависит от купонов на уровне 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 (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 | Нет эквивалента | В текущей версии API менеджера данных эта функция не поддерживается. |
address[].region | Нет эквивалента | В текущей версии API менеджера данных эта функция не поддерживается. |
address[].sha256_street | Нет эквивалента | В текущей версии API менеджера данных эта функция не поддерживается. |
Поля для ввода данных о товарах в корзину.
items[] | Item (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 (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 (API менеджера данных) | Примечания |
|---|---|---|
category | category | |
language | language_code | |
screen_resolution | screen_height и screen_width | В протоколе Measurement Protocol screen_resolution передается в виде строки ( "1280x720" ). В API Data Manager screen_height и screen_width передаются как отдельные целочисленные значения. |
operating_system | operating_system | |
operating_system_version | operating_system_version | |
model | model | |
brand | brand | |
browser | browser | |
browser_version | browser_version |