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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Ú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."]]
