Prueba el servidor de MCP para Google Analytics. Instala desde
GitHub y consulta el
anuncio para obtener más detalles.
Dimensiones y métricas en tiempo real
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Son las dimensiones y métricas admitidas en las consultas al método Realtime de la API de Analytics Data. Los métodos de Core Reporting (RunReport, por ejemplo) aceptan un conjunto diferente de dimensiones y métricas que el método de Realtime.
Dimensiones
Las siguientes dimensiones se pueden solicitar en los informes de cualquier propiedad. Especifica el "Nombre de la API" en el campo name de un recurso Dimension para una columna de la dimensión en la respuesta del informe.
| Nombre de la API |
Nombre de la IU |
Descripción |
appVersion |
Versión de la app |
Indica el nombre de la versión de la aplicación (para Android) o la versión abreviada del paquete (para iOS). |
audienceId |
ID de público |
Es el identificador numérico de un público. Los usuarios se registran en los públicos a los que pertenecían durante el período del informe. El comportamiento actual de los usuarios no afecta la membresía histórica del público en los informes. |
audienceName |
Nombre del público |
Es el nombre específico de un público. Los usuarios se registran en los públicos a los que pertenecían durante el período del informe. El comportamiento actual de los usuarios no afecta la membresía histórica del público en los informes. |
audienceResourceName |
Nombre del recurso del público |
Es el nombre del recurso de este público. Los nombres de recursos contienen identificadores de colección y de recursos para identificar de forma única un recurso. Para obtener más información, consulta Nombres de recursos. |
city |
Ciudad |
Indica la ciudad de donde proviene la actividad del usuario. |
cityId |
ID de la ciudad |
Es el ID geográfico de la ciudad de donde proviene la actividad del usuario, derivado de su dirección IP. |
country |
País |
Indica el país de donde proviene la actividad del usuario. |
countryId |
ID del país |
Es el ID geográfico del país desde el que se originó la actividad del usuario, derivado de su dirección IP. Se da formato según el estándar ISO 3166-1 alfa-2. |
deviceCategory |
Categoría del dispositivo |
Indica el tipo de dispositivo: computadora de escritorio, tablet o dispositivo móvil. |
eventName |
Nombre del evento |
El nombre del evento |
minutesAgo |
Hace unos minutos en tiempo real |
Cantidad de minutos que pasaron desde que se recopiló un evento. El 00 es el minuto actual y el 01 significa el minuto anterior. |
platform |
Plataforma |
La plataforma en la que se ejecutó su aplicación o sitio web; por ejemplo, en la Web, iOS o Android. Para determinar el tipo de una transmisión en un informe, usa la plataforma y el streamId. |
streamId |
ID de flujo |
Es el identificador numérico del flujo de datos de tu aplicación o sitio web. |
streamName |
Nombre de la transmisión |
Es el nombre del flujo de datos de tu aplicación o sitio web. |
unifiedScreenName |
Título de la página y nombre de pantalla |
Es el título de la página (Web) o el nombre de la pantalla (aplicación) en la que se registró el evento. |
Dimensiones personalizadas
La API de Realtime Data puede crear informes sobre dimensiones personalizadas centradas en el usuario. Consulta Propiedades del usuario personalizadas para obtener más información sobre las dimensiones personalizadas. Las dimensiones personalizadas se especifican en una solicitud de informe de la API por el nombre y el alcance del parámetro de la dimensión. Por ejemplo, incluye "customUser:last_level" en una solicitud de la API de Data para crear un informe para la dimensión personalizada con alcance del usuario y nombre del parámetro "last_level". Esta solicitud a la API fallará si la propiedad no registró esta dimensión personalizada centrada en el usuario.
A continuación, se muestra la sintaxis general de las dimensiones personalizadas. Puedes consultar el método de la API de Metadata para enumerar todas las dimensiones personalizadas de una propiedad.
| Nombre genérico de la API |
Descripción |
customUser:parameter_name |
Dimensión personalizada centrada en el usuario para parameter_name. |
Las dimensiones personalizadas centradas en el evento no se admiten en la API de Realtime.
Métricas
Las siguientes métricas se pueden solicitar en los informes de cualquier propiedad. Especifica el "Nombre de la API" en el campo name de un recurso Metric para una columna de la métrica en la respuesta del informe.
| Nombre de la API |
Nombre de la IU |
Descripción |
activeUsers |
Usuarios activos |
Indica la cantidad de usuarios distintos que visitaron su sitio o usaron su aplicación. |
eventCount |
Recuento de eventos |
Es el recuento de eventos. |
keyEvents |
Eventos clave |
Es el recuento de eventos clave. Marcar un evento como evento clave afecta los informes desde el momento en que realizas esta acción, pero no se modifican los datos históricos. Puedes marcar cualquier evento como clave en Google Analytics, y algunos eventos (como first_open o purchase) se marcan como eventos clave de forma predeterminada. |
screenPageViews |
Vistas |
Es la cantidad de pantallas de la app o páginas web que vieron los usuarios. Se registran las vistas repetidas de una página o pantalla individual. (eventos screen_view + page_view). |
Las métricas personalizadas centradas en el evento no se admiten en la API de Realtime.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-29 (UTC)
[null,null,["Última actualización: 2025-07-29 (UTC)"],[[["\u003cp\u003eThe Realtime reporting method of the Analytics Data API allows you to query specific dimensions and metrics to analyze real-time user behavior on your app or website.\u003c/p\u003e\n"],["\u003cp\u003eSupported dimensions include user demographics (like city and country), device information, app version, audience data, event details, and user-scoped custom dimensions.\u003c/p\u003e\n"],["\u003cp\u003eYou can use metrics like \u003ccode\u003eactiveUsers\u003c/code\u003e, \u003ccode\u003eeventCount\u003c/code\u003e, \u003ccode\u003escreenPageViews\u003c/code\u003e, and \u003ccode\u003ekeyEvents\u003c/code\u003e to understand real-time user engagement.\u003c/p\u003e\n"],["\u003cp\u003eUnlike Core Reporting methods, the Realtime method uses a different set of dimensions and metrics and doesn't support event-scoped custom dimensions or metrics.\u003c/p\u003e\n"]]],["The Realtime Analytics Data API supports specific dimensions and metrics for querying. Dimensions include `appVersion`, `audienceId/Name/ResourceName`, geographic data (`city/Id`, `country/Id`), `deviceCategory`, `eventName`, `minutesAgo`, `platform`, `streamId/Name`, and `unifiedScreenName`. User-scoped custom dimensions are supported using the `customUser:parameter_name` format. Supported metrics are `activeUsers`, `eventCount`, `keyEvents`, and `screenPageViews`. Event-scoped custom dimensions and metrics are not supported in the Realtime API.\n"],null,["# Realtime Dimensions & Metrics\n\nThe dimensions and metrics supported in queries to the [Realtime method](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runRealtimeReport) of the Analytics Data API. The\nCore Reporting methods ([`RunReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport)\nfor example) accept a different set of [Dimensions \\& Metrics](/analytics/devguides/reporting/data/v1/api-schema)\nthan the Realtime method.\n\nDimensions\n----------\n\nThe following dimensions can be requested in reports for any property. Specify\nthe \"API Name\" in a [`Dimension`](/analytics/devguides/reporting/data/v1/rest/v1beta/Dimension) resource's `name`\nfield for a column of the dimension in the report response.\n\n| API Name | UI Name | Description |\n|------------------------|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `appVersion` | App version | The app's versionName (Android) or short bundle version (iOS). |\n| `audienceId` | Audience ID | The numeric identifier of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. |\n| `audienceName` | Audience name | The given name of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. |\n| `audienceResourceName` | Audience resource name | The resource name of this audience. Resource names contain both collection \\& resource identifiers to uniquely identify a resource; to learn more, see [Resource names](//google.aip.dev/122). |\n| `city` | City | The city from which the user activity originated. |\n| `cityId` | City ID | The geographic ID of the city from which the user activity originated, derived from their IP address. |\n| `country` | Country | The country from which the user activity originated. |\n| `countryId` | Country ID | The geographic ID of the country from which the user activity originated, derived from their IP address. Formatted according to ISO 3166-1 alpha-2 standard. |\n| `deviceCategory` | Device category | The type of device: Desktop, Tablet, or Mobile. |\n| `eventName` | Event name | The name of the event. |\n| `minutesAgo` | Realtime minutes ago | The number of minutes ago that an event was collected. 00 is the current minute, and 01 means the previous minute. |\n| `platform` | Platform | The platform on which your app or website ran; for example, web, iOS, or Android. To determine a stream's type in a report, use both platform and streamId. |\n| `streamId` | Stream ID | The numeric data stream identifier for your app or website. |\n| `streamName` | Stream name | The data stream name for your app or website. |\n| `unifiedScreenName` | Page title and screen name | The page title (web) or screen name (app) on which the event was logged. |\n\n### Custom Dimensions\n\nThe Realtime Data API can create reports on User scoped Custom Dimensions. See\n[Custom user properties](//support.google.com/analytics/answer/9269570) to learn\nmore about custom dimensions. Custom dimensions are specified in an API report\nrequest by the dimension's parameter name and scope. For example, include\n`\"customUser:last_level\"` in a Data API request to create a report for the\nUser-scoped Custom Dimension with parameter name `\"last_level\"`. This API\nrequest will fail if the property has not registered this User-scoped Custom\nDimension.\n\nThe following are the general syntax for Custom Dimensions. You can query the\n[Metadata API method](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/getMetadata) to list all\nCustom Dimensions for a Property.\n\n| Generic API Name | Description |\n|-----------------------------|----------------------------------------------------|\n| `customUser:parameter_name` | User-scoped Custom Dimension for `parameter_name`. |\n\nEvent-scoped custom dimensions aren't supported in the Realtime API.\n\nMetrics\n-------\n\nThe following metrics can be requested in reports for any property. Specify the\n\"API Name\" in a [`Metric`](/analytics/devguides/reporting/data/v1/rest/v1beta/Metric) resource's `name` field for\na column of the metric in the report response.\n\n| API Name | UI Name | Description |\n|-------------------|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `activeUsers` | Active users | The number of distinct users who visited your site or app. |\n| `eventCount` | Event count | The count of events. |\n| `keyEvents` | Key events | The count of key events. Marking an event as a key event affects reports from time of creation. It doesn't change historic data. You can mark any event as key in Google Analytics, and some events (such as `first_open` or `purchase`) are marked as key events by default. |\n| `screenPageViews` | Views | The number of app screens or web pages your users viewed. Repeated views of a single page or screen are counted. (screen_view + page_view events). |\n\nEvent-scoped custom metrics aren't supported in the Realtime API."]]
