Se usó la API de Cloud Translation para traducir esta página.

Referencia del Protocolo de medición

En esta página, se describen el mecanismo de transporte y los parámetros de datos del Protocolo de medición.

Transporte

Todos los datos se deben enviar de forma segura con solicitudes POST de HTTPS.

Envía solicitudes al siguiente extremo:

https://www.google-analytics.com/mp/collect

Si deseas que tus datos se procesen en la UE, usa el siguiente extremo:

https://region1.google-analytics.com/mp/collect

Esta es una solicitud de POST de muestra:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
PAYLOAD_DATA

Reemplaza PAYLOAD_DATA por la Carga útil de la solicitud.

El Protocolo de medición muestra un código de estado 2xx si se recibe la solicitud HTTP. El Protocolo de medición no muestra un código de error si la carga útil no tiene el formato correcto, si los datos son incorrectos o si Google Analytics no los procesa.

Carga útil

La carga útil tiene dos partes:

Parámetros de consulta.
Un cuerpo POST JSON

Parámetros de consulta

Nombre del parámetro Descripción

Nombre del parámetro	Descripción
`api_secret`	Obligatorio. El Secreto de la API de la IU de Google Analytics Se encuentra en Administrador > Flujos de datos > Elige tu flujo > Protocolo de medición > Crear. Son privados para tu organización. Se deben actualizar con regularidad para evitar el SPAM excesivo.

`api_secret`

Obligatorio. El Secreto de la API de la IU de Google Analytics

Se encuentra en Administrador > Flujos de datos > Elige tu flujo > Protocolo de medición > Crear.

Son privados para tu organización. Se deben actualizar con regularidad para evitar el SPAM excesivo.

Cuerpo de POST JSON

Clave	Tipo	Descripción
`user_id`	`string`	Opcional. Es un identificador único para un usuario. Consulta User-ID para el análisis multiplataforma para obtener más información sobre este identificador. Solo puede incluir caracteres UTF-8.
`timestamp_micros`	`number`	Opcional. Una marca de tiempo Unix, microsegundos, no milisegundos. Representa la hora del evento. Se debe configurar solo para registrar eventos que ocurrieron en el pasado. Se puede anular con `user_property` o marcas de tiempo del evento. Los eventos se pueden retrotraer hasta 3 días calendario según la zona horaria de la propiedad.
`user_properties`	`object`	Opcional. Las propiedades del usuario para la medición
`user_data`	`object`	Opcional. Datos proporcionados por el usuario
`consent`	`object`	Opcional. Configuración de consentimiento para la solicitud. Consulta la sección de consentimiento para obtener más información.
`non_personalized_ads`	`boolean`	Obsoleto: Usa el campo `ad_personalization` de `consent` en su lugar. Opcional. Se establece en `true` para indicar que los datos del usuario no se deben usar para los anuncios personalizados.
`user_location`	`object`	Opcional. Establece la información geográfica de la solicitud en un formato estructurado.
`ip_override`	`string`	Opcional. Es la dirección IP que Google Analytics usa para obtener la información geográfica de la solicitud.
`device`	`object`	Opcional. Establece la información del dispositivo para la solicitud en un formato estructurado.
`events[]`	`array`	Obligatorio. Un array de `event` elementos. Se pueden enviar hasta 25 eventos por solicitud. Consulta la referencia de eventos para ver todos los eventos válidos.
`events[].name`	`string`	Obligatorio. Nombre del evento. Consulta Eventos para ver todas las opciones.
`events[].params`	`object`	Opcional. Parámetros del evento. Consulta Eventos para ver los parámetros sugeridos para cada evento.

Consentimiento

El atributo consent configura los tipos y estados de consentimiento. Si no especificas consent, Google Analytics usa la configuración de consentimiento de las interacciones en línea correspondientes para el cliente o la instancia de la aplicación.

Clave Tipo Descripción

Clave	Tipo	Descripción
`ad_user_data`	`string`	Opcional. Consentimiento para enviar a Google los datos del usuario de los eventos y las propiedades del usuario de la solicitud con fines publicitarios. `GRANTED` o `DENIED`
`ad_personalization`	`string`	Opcional. Consentimiento para la publicidad personalizada del usuario. `GRANTED` o `DENIED`

`ad_user_data`

string

Opcional. Consentimiento para enviar a Google los datos del usuario de los eventos y las propiedades del usuario de la solicitud con fines publicitarios.

GRANTED o DENIED

`ad_personalization`

string

Opcional. Consentimiento para la publicidad personalizada del usuario.

GRANTED o DENIED

Información geográfica

Los atributos user_location y ip_override proporcionan información geográfica. user_location tiene prioridad sobre ip_override.

Esta es la estructura del campo user_location. Proporciona tantos atributos como sea posible. Recomendamos country_id y region_id como mínimo.

Clave	Tipo	Descripción
`city`	`string`	Opcional. El nombre de la ciudad. Si la ciudad está en EE.UU., también establece `country_id` y `region_id` para que Google Analytics pueda asignar correctamente el nombre de la ciudad a un ID de ciudad.
`region_id`	`string`	Opcional. El país y la subdivisión ISO 3166 Por ejemplo, `US-CA`, `US-AR`, `CA-BC`, `GB-LND`, `CN-HK`.
`country_id`	`string`	Opcional. Es el país en formato ISO 3166-1 alpha-2. Por ejemplo, `US`, `AU`, `ES`, `FR`.
`subcontinent_id`	`string`	Opcional. El subcontinente en formato UN M49 Por ejemplo, `011`, `021`, `030`, `039`.
`continent_id`	`string`	Opcional. El continente en formato UN M49. Por ejemplo, `002`, `019`, `142`, `150`.

Este es un user_location de muestra:

"user_location:" {
  "city:" "Mountain View",
  "region_id:" "US-CA",
  "country_id:" "US",
  "subcontinent_id:" "021",
  "continent_id:" "019"
}

ip_override es una alternativa a user_location. Si, en cambio, envías ip_override, Google Analytics obtiene información geográfica de la dirección IP. Si envías user_location, Google Analytics ignora ip_override.

Si no envías user_location o ip_override, Google Analytics obtiene información geográfica de los eventos de etiquetado con client_id.

Google Analytics aplica la configuración de datos de ubicación detallados de la propiedad a la solicitud, independientemente de la información geográfica que se envíe.

Información del dispositivo

Para enviar información del dispositivo, usa el campo device. Esta es la estructura del campo device. Proporciona tantos atributos como sea posible. Recomendamos category como mínimo.

Clave	Tipo	Descripción
`category`	`string`	Opcional. Es la categoría del dispositivo. Por ejemplo, `desktop`, `tablet`, `mobile`, `smart TV`.
`language`	`string`	Opcional. Es el idioma en formato ISO 639-1. Por ejemplo, `en`, `en-US`.
`screen_resolution`	`string`	Opcional. Es la resolución del dispositivo, con el formato `WIDTHxHEIGHT`. Por ejemplo, `1280x2856`, `1080x2340`.
`operating_system`	`string`	Opcional. El sistema operativo o la plataforma Por ejemplo, `MacOS`.
`operating_system_version`	`string`	Opcional. Es la versión del sistema operativo o la plataforma. Por ejemplo, `13.5`.
`model`	`string`	Opcional. Es el modelo del dispositivo. Por ejemplo, `Pixel 9 Pro`, `Samsung Galaxy S24`.
`brand`	`string`	Opcional. Es la marca del dispositivo. Por ejemplo, `Google`, `Samsung`.
`browser`	`string`	Opcional. La marca o el tipo de navegador Por ejemplo, `Chrome`, `Firefox`.
`browser_version`	`string`	Opcional. Es la versión del navegador. Por ejemplo, `136.0.7103.60`, `5.0`.

En el siguiente fragmento, se muestra un ejemplo de la configuración de device:

"device:" {
  "category": "mobile",
  "language": "en",
  "screen_resolution": "1280x2856",
  "operating_system": "Android",
  "operating_system_version": "14",
  "model": "Pixel 9 Pro",
  "brand": "Google",
  "browser": "Chrome",
  "browser_version": "136.0.7103.60"
}

Independientemente de si especificas , Google Analytics aplica la configuración de datos de dispositivos detallados de la propiedad a la solicitud.

Custom parameters

Puedes incluir parámetros personalizados centrados en el usuario, en el evento y en el artículo en una carga útil de Protocolo de medición.

Se pueden incluir parámetros personalizados centrados en el usuario en user_properties.
Se pueden incluir parámetros personalizados centrados en el evento en events[].params.
Los parámetros personalizados centrados en el artículo se pueden incluir en items.

Valores recomendados para ciertos eventos

Algunos eventos tienen parámetros recomendados. Consulta Eventos para ver los parámetros recomendados para todos los eventos compatibles.

Nombres reservados

Algunos nombres de eventos, parámetros y propiedades del usuario están reservados y no se pueden usar:

Nombres de eventos reservados

Los siguientes nombres de eventos están reservados y no se pueden utilizar:

ad_activeview
ad_click
ad_exposure
ad_query
ad_reward
adunit_exposure
app_clear_data
app_exception
app_install
app_remove
app_store_refund
app_update
app_upgrade
dynamic_link_app_open
dynamic_link_app_update
dynamic_link_first_open
error
firebase_campaign
firebase_in_app_message_action
firebase_in_app_message_dismiss
firebase_in_app_message_impression
first_open
first_visit
in_app_purchase
notification_dismiss
notification_foreground
notification_open
notification_receive
notification_send
os_update
session_start
user_engagement

Nombres de parámetros reservados

Los siguientes nombres de parámetros están reservados y no se pueden utilizar:

firebase_conversion

Los nombres de los parámetros no pueden comenzar con lo siguiente:

_ (underscore)
firebase_
ga_
google_
gtag.

Nombres de propiedades del usuario reservados

Los siguientes nombres de propiedades del usuario están reservados y no se pueden utilizar:

first_open_time
first_visit_time
last_deep_link_referrer
user_id
first_open_after_install

Además, los nombres de propiedades del usuario no pueden comenzar con lo siguiente:

_ (underscore)
firebase_
ga_
google_

Referencia del Protocolo de medición Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Transporte

Carga útil

Parámetros de consulta

api_secret

Cuerpo de POST JSON

user_id

timestamp_micros

user_properties

user_data

consent

non_personalized_ads

user_location

ip_override

device

events[]

events[].name

events[].params

Consentimiento

ad_user_data

ad_personalization

Información geográfica

city

region_id

country_id

subcontinent_id

continent_id

Información del dispositivo

category

language

screen_resolution

operating_system

operating_system_version

model

brand

browser

browser_version

Custom parameters

Valores recomendados para ciertos eventos

Nombres reservados

Nombres de eventos reservados

Nombres de parámetros reservados

Nombres de propiedades del usuario reservados

Referencia del Protocolo de medición

`api_secret`

`user_id`

`timestamp_micros`

`user_properties`

`user_data`

`consent`

`non_personalized_ads`

`user_location`

`ip_override`

`device`

`events[]`

`events[].name`

`events[].params`

`ad_user_data`

`ad_personalization`

`city`

`region_id`

`country_id`

`subcontinent_id`

`continent_id`

`category`

`language`

`screen_resolution`

`operating_system`

`operating_system_version`

`model`

`brand`

`browser`

`browser_version`