使用表格中的映射，将 Measurement Protocol 数据收集请求 (/mp/collect) 映射到 Data Manager API 中的等效 IngestEventsRequest。
请求字段
/mp/collect 请求 (Measurement Protocol) |
IngestEventsRequest (Data Manager API) |
备注 |
|---|---|---|
measurement_id（查询参数） |
destinations |
网站活动的product_destination_id地图。如需了解详情，请参阅目标字段。 |
firebase_app_id（查询参数） |
destinations |
针对应用事件映射到 product_destination_id。如需了解详情，请参阅目标字段。 |
api_secret（查询参数） |
无对应报告 | 如需了解如何在 Data Manager API 中对请求进行身份验证，请参阅设置 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 |
设置为 UserProperties 对象。Data Manager API 不支持为各个用户属性设置时间戳。与用户属性更改相关联的时间戳是从事件 (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 上传是必需的。设置为用于 UserIdentifier 值的 Encoding。 |
目标字段
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 Analytics 网站数据流的衡量 ID |
firebase_app_id（查询参数） |
product_destination_id |
设置为 Google Analytics 应用数据流的 Firebase 应用 ID |
| 无对应报告 | operating_account |
将 account_id 设置为 Google Analytics 媒体资源 ID。将 account_type 设为 GOOGLE_ANALYTICS_PROPERTY。 |
| 无对应报告 | login_account |
将 account_id 设置为 Google Analytics 媒体资源 ID。将 account_type 设为 GOOGLE_ANALYTICS_PROPERTY。 |
事件字段
Measurement Protocol events[] |
Event (Data Manager API) |
备注 |
|---|---|---|
name |
event_name |
如果 event_name 使用预留名称，API 会拒绝该事件并返回 INVALID_EVENT_NAME 错误。 |
| 无对应报告 | event_source |
如果事件是从 Web 浏览器生成的，则设置为 WEB；如果事件是从应用生成的，则设置为 APP。 |
| 无对应报告 | destination_references |
如果请求级 destinations 列表包含多个 Google Analytics Destination，则为必需。添加一个条目，以指定哪个目的地应接收事件。 |
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 中，在事件的 UserProperties 对象中，将该值设置在 customer_type 字段中。 |
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 (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 |
无对应报告 | 当前版本的数据管理器 API 不支持此功能。 |
address[].region |
无对应报告 | 当前版本的数据管理器 API 不支持此功能。 |
address[].sha256_street |
无对应报告 | 当前版本的数据管理器 API 不支持此功能。 |
购物车数据的商品字段
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 |
设置为 联合国 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 |