Dimensões e métricas em tempo real
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
As dimensões e métricas compatíveis com consultas ao método em tempo real da API Analytics Data. Os métodos do Core Reporting (RunReport, por exemplo) aceitam um conjunto diferente de dimensões e métricas do método em tempo real.
Dimensões
As dimensões a seguir podem ser solicitadas em relatórios de qualquer propriedade. Especifique o "Nome da API" no campo name de um recurso Dimension para uma coluna da dimensão na resposta do relatório.
| Nome da API |
Nome da interface |
Descrição |
appVersion |
Versão do app |
O nome da versão (Android) ou versão abreviada do pacote (iOS) do aplicativo. |
audienceId |
Código do público-alvo |
O identificador numérico de um público-alvo. Os usuários são informados nos públicos-alvo a que pertenciam durante o período do relatório. O comportamento atual do usuário não afeta a participação do público-alvo histórico nos relatórios. |
audienceName |
Nome do público-alvo |
O nome de um público-alvo. Os usuários são informados nos públicos-alvo a que pertenciam durante o período do relatório. O comportamento atual do usuário não afeta a participação do público-alvo histórico nos relatórios. |
audienceResourceName |
Nome do recurso de público-alvo |
O nome do recurso desse público-alvo. Os nomes de recursos contêm identificadores de coleção e de recurso para identificar um recurso de forma exclusiva. Para saber mais, consulte Nomes de recursos. |
city |
Cidade |
A cidade em que a atividade do usuário teve origem. |
cityId |
ID da cidade |
O ID geográfico da cidade de origem da atividade do usuário, derivado do endereço IP dele. |
country |
País |
O país em que a atividade do usuário teve origem. |
countryId |
ID do país |
O ID geográfico do país em que a atividade do usuário teve origem, derivado do endereço IP. Formatado de acordo com o padrão ISO 3166-1 alfa-2. |
deviceCategory |
Categoria do dispositivo |
O tipo de dispositivo: computador, tablet ou celular. |
eventName |
Nome do evento |
O nome do evento. |
minutesAgo |
Minutos atrás em tempo real |
O número de minutos atrás em que um evento foi coletado. 00 é o minuto atual, e 01 significa o minuto anterior. |
platform |
Plataforma |
A plataforma em que seu app ou site foi executado, por exemplo, Web, iOS ou Android. Para determinar o tipo de um fluxo em um relatório, use a plataforma e o streamId. |
streamId |
ID do stream |
O identificador numérico do fluxo de dados do seu app ou site. |
streamName |
Nome do fluxo |
O nome do fluxo de dados do seu app ou site. |
unifiedScreenName |
Título da página e nome da tela |
O título da página (Web) ou o nome da tela (app) em que o evento foi registrado. |
Dimensões personalizadas
A API Realtime Data pode criar relatórios sobre dimensões personalizadas no escopo do usuário. Consulte Propriedades do usuário personalizadas para saber mais sobre dimensões personalizadas. As dimensões personalizadas são especificadas em uma solicitação de relatório da API pelo nome do parâmetro e escopo da dimensão. Por exemplo, inclua "customUser:last_level" em uma solicitação da API de dados para criar um relatório da dimensão personalizada no escopo do usuário com o nome do parâmetro "last_level". Essa solicitação de API vai falhar se a propriedade não tiver registrado essa dimensão personalizada no escopo do usuário.
Confira a sintaxe geral para dimensões personalizadas. Você pode consultar o método da API Metadata para listar todas as dimensões personalizadas de uma propriedade.
| Nome genérico da API |
Descrição |
customUser:parameter_name |
Dimensão personalizada no escopo do usuário para parameter_name. |
As dimensões personalizadas no escopo do evento não são compatíveis com a API Realtime.
Métricas
As métricas a seguir podem ser solicitadas em relatórios de qualquer propriedade. Especifique o "Nome da API" no campo name de um recurso Metric para uma coluna da métrica na resposta do relatório.
| Nome da API |
Nome da interface |
Descrição |
activeUsers |
Usuários ativos |
Número de usuários únicos que acessaram seu site ou app. |
eventCount |
Contagem de eventos |
A contagem de eventos. |
keyEvents |
Eventos principais |
A contagem de eventos principais. Marcar um evento como principal afeta os relatórios desde o momento da criação deles. Isso não muda os dados históricos. Você pode marcar qualquer evento como principal no Google Analytics, e alguns deles (como first_open ou purchase) são classificados assim por padrão. |
screenPageViews |
Visualizações |
É o número de telas do app ou páginas da Web que os usuários visualizaram. Visualizações repetidas de uma única página ou tela são consideradas. (eventos screen_view + page_view). |
As métricas personalizadas no escopo do evento não são compatíveis com a API Realtime.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-29 UTC.
[null,null,["Última atualização 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."]]
