Asignaciones de campo

Usa las asignaciones de las tablas para asignar una solicitud de recopilación de datos de Measurement Protocol (/mp/collect) a su equivalente de IngestEventsRequest en la API de Data Manager.

Campos de la solicitud

Solicitud /mp/collect (Measurement Protocol) IngestEventsRequest (API de Data Manager) Notas
measurement_id (parámetro de consulta) destinations Mapa a product_destination_id para eventos web. Consulta Campos de destino para obtener más detalles.
firebase_app_id (parámetro de consulta) destinations Asigna el mapa a product_destination_id para los eventos de aplicaciones. Consulta Campos de destino para obtener más detalles.
api_secret (parámetro de consulta) Sin equivalente Consulta Configura el acceso a la API para obtener información sobre cómo autenticar solicitudes en la API de Data Manager.
consent consent Se establece en un objeto Consent.
events events Se establece en una lista de recursos Event. Consulta la sección Campos de eventos para obtener más detalles.
client_id events.client_id Se requiere para los eventos web.
app_instance_id events.app_instance_id Se requiere para los eventos de aplicaciones.
user_id events.user_id Opcional. Es un identificador único para un usuario.
timestamp_micros events.event_timestamp En Measurement Protocol, se puede proporcionar a nivel de la solicitud o para un evento individual. En la API de Data Manager, no hay una marca de tiempo a nivel de la solicitud. Establece event_timestamp en cada evento a la hora en que ocurrió.
  • Si usas el formato JSON, establece un valor en formato RFC 3339.
  • Si usas búferes de protocolo, usa Timestamp y configura los campos seconds y (opcionalmente) nanoseconds.

Consulta Formato de marca de tiempo para obtener más detalles.
user_properties events.user_properties Se establece en un objeto UserProperties. La API de Data Manager no admite la configuración de marcas de tiempo para propiedades del usuario individuales. Las marcas de tiempo asociadas con los cambios en las propiedades del usuario se infieren a partir de la marca de tiempo del evento (event_timestamp).
user_data events.user_data Se establece en un objeto UserData. Consulta Campos de identificadores del usuario para obtener más detalles.
non_personalized_ads events.consent.ad_personalization Si non_personalized_ads es true, establece ad_personalization en DENIED.
user_location events.event_location Consulta Campos de ubicación del usuario para obtener más detalles.
ip_override events.event_device_info.ip_address
device events.event_device_info Consulta Campos del dispositivo para obtener más detalles.
user_agent events.event_device_info.user_agent
validation_behavior Sin equivalente Usa Diagnóstico para recuperar el estado de tu carga, así como los errores y las advertencias de eventos individuales durante el procesamiento posterior. Si la IngestEventsRequest falla (por ejemplo, debido a la falta de campos obligatorios), no se procesará ningún evento y deberás resolver el error y volver a intentar la solicitud. Consulta Cómo comprender los errores de la API para obtener más información.
/debug/mp/collect validate_only Establece validate_only en true para validar eventos sin transferir ningún dato, de forma similar al servidor de validación del Measurement Protocol.
Sin equivalente encoding Se requiere para las cargas de UserData. Se establece en el Encoding que se usa para los valores de UserIdentifier.

Campos de destino

El Measurement Protocol envía eventos directamente a un flujo de datos específico con el parámetro de consulta measurement_id o firebase_app_id.

La API de Data Manager usa un objeto Destination para especificar dónde enviar los datos. Consulta Configura destinos para obtener más información sobre los destinos.

A continuación, se muestra cómo asignar los campos del Protocolo de medición a los campos equivalentes en un objeto Destination:

Protocolo de medición Destination (API de Data Manager) Notas
measurement_id (parámetro de consulta) product_destination_id Se establece en el ID de medición del flujo de datos web de Google Analytics.
firebase_app_id (parámetro de consulta) product_destination_id Se establece en el ID de aplicación de Firebase del flujo de datos de la aplicación de Google Analytics.
Sin equivalente operating_account Establece account_id en el ID de la propiedad de Google Analytics. Establece account_type en GOOGLE_ANALYTICS_PROPERTY.
Sin equivalente login_account Establece account_id en el ID de la propiedad de Google Analytics. Establece account_type en GOOGLE_ANALYTICS_PROPERTY.

Campos del evento

Measurement Protocol events[] Event (API de Data Manager) Notas
name event_name Si event_name usa un nombre reservado, la API rechaza el evento con un error INVALID_EVENT_NAME.
Sin equivalente event_source Se establece en WEB si el evento se generó desde un navegador web y en APP si se generó desde una app.
Sin equivalente destination_references Se requiere si la lista destinations a nivel de la solicitud contiene más de un objeto Destination de Google Analytics. Agrega una entrada para especificar qué destino debe recibir el evento.
timestamp_micros event_timestamp
  • Si usas el formato JSON, establece un valor en formato RFC 3339.
  • Si usas búferes de protocolo, usa Timestamp y configura los campos seconds y (opcionalmente) nanoseconds.

Consulta Formato de marca de tiempo para obtener más detalles.
params.currency currency
params.value conversion_value
params.customer_type user_properties.customer_type En el Protocolo de medición, el parámetro customer_type se establece como un parámetro de evento. En la API de Data Manager, configúralo en el campo customer_type del objeto UserProperties del evento.
params.transaction_id transaction_id Obligatorio para algunos eventos y casos de uso. Consulta Cómo convertir los datos en objetos Event para obtener más detalles.
params.items cart_data.items Consulta Campos de artículos para los datos del carrito para obtener más detalles.
params.coupon cart_data.coupon_codes Usa el campo coupon_codes para proporcionar los cupones que se aplicaron al carrito. Solo proporciona un cupón para Google Analytics. Esto es independiente de los cupones a nivel de Item, que se pueden establecer con cart_data.items.additional_item_parameters para artículos individuales.
params.session_id additional_event_parameters Asigna un mapa a una entrada con parameter_name establecido en session_id.
params.engagement_time_msec additional_event_parameters Asigna un mapa a una entrada con parameter_name establecido en engagement_time_msec.
Otro params additional_event_parameters

Asigna otros parámetros como una lista de objetos con parameter_name y value.

Nota: No agregues entradas para transaction_id, currency ni value aquí. En su lugar, usa los campos de nivel superior en Event.

Campos de identificadores del usuario

Measurement Protocol user_data UserIdentifier (API de Data Manager) Notas
sha256_email_address[] email_address Se establece en la dirección de correo electrónico con formato y codificación hash. También puedes encriptar la dirección de correo electrónico hasheada.
sha256_phone_number[] phone_number Se establece en el número de teléfono con formato y codificado con hash. También puedes encriptar el número de teléfono codificado con hash.
address[] address Se establece en un objeto AddressInfo. Sigue los lineamientos de formato y codificación hash.
address[].sha256_first_name address.given_name Se establece en el nombre proporcionado con formato y con hash. También puedes encriptar el nombre proporcionado con hash.
address[].sha256_last_name address.family_name Se establece en el nombre de familia con formato y hash. También puedes encriptar el nombre de la familia hasheado.
address[].country address.region_code
address[].postal_code address.postal_code
address[].city Sin equivalente No se admite en la versión actual de la API de Data Manager.
address[].region Sin equivalente No se admite en la versión actual de la API de Data Manager.
address[].sha256_street Sin equivalente No se admite en la versión actual de la API de Data Manager.

Campos de artículos para los datos del carrito

Measurement Protocol items[] Item (API de Data Manager) Notas
item_id item_id Obligatorio.
item_name additional_item_parameters Asigna un mapa a una entrada con parameter_name establecido en item_name.
quantity quantity Obligatorio.
price unit_price Obligatorio.
Otros campos de elementos additional_item_parameters

Asigna otros parámetros del elemento (como discount, affiliation, item_brand, etcétera) como una lista de objetos con parameter_name y value.

Nota: No agregues entradas para quantity, price ni item_id aquí. En su lugar, usa los campos de nivel superior en Item.

Campos de ubicación del usuario

Measurement Protocol user_location EventLocation (API de Data Manager) Notas
city city El nombre de la ciudad en la que ocurrió el evento.
country_id region_code Se establece en el código de región CLDR de 2 letras.
region_id subdivision_code Se establece en el código de subdivisión ISO 3166-2.
continent_id continent_code Se establece en el código de continente en formato UN M49.
subcontinent_id subcontinent_code Se establece en el código de subcontinente en formato UN M49.

Campos del dispositivo

Measurement Protocol device DeviceInfo (API de Data Manager) Notas
category category
language language_code
screen_resolution screen_height y screen_width En el Protocolo de Measurement, screen_resolution se proporciona como una cadena ("1280x720"). En la API de Data Manager, envía screen_height y screen_width como valores enteros separados.
operating_system operating_system
operating_system_version operating_system_version
model model
brand brand
browser browser
browser_version browser_version
Anterior
Pasos para la actualización