Prova il server MCP per Google Analytics. Installa da
GitHub e consulta l'
annuncio per maggiori dettagli.
Dimensioni e metriche in tempo reale
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Le dimensioni e le metriche supportate nelle query al metodo in tempo reale dell'API di dati di Analytics. I metodi di reporting principali (ad esempio RunReport) accettano un insieme diverso di dimensioni e metriche rispetto al metodo in tempo reale.
Dimensioni
Le seguenti dimensioni possono essere richieste nei report per qualsiasi proprietà. Specifica
il "Nome API" nel campo name di una risorsa Dimension
per una colonna della dimensione nella risposta del report.
| Nome API |
Nome dell'UI |
Descrizione |
appVersion |
Versione dell'app |
Il nome della versione dell'app (Android) o la versione breve del bundle (iOS). |
audienceId |
ID pubblico |
L'identificatore numerico di un segmento di pubblico. Gli utenti vengono inclusi nei segmenti di pubblico a cui appartenevano durante l'intervallo di date del report. Il comportamento degli utenti correnti non influisce sull'appartenenza storica ai segmenti di pubblico nei report. |
audienceName |
Nome segmento di pubblico |
Il nome di un segmento di pubblico. Gli utenti vengono inclusi nei segmenti di pubblico a cui appartenevano durante l'intervallo di date del report. Il comportamento degli utenti correnti non influisce sull'appartenenza storica ai segmenti di pubblico nei report. |
audienceResourceName |
Nome risorsa pubblico |
Il nome risorsa di questo segmento di pubblico. I nomi delle risorse contengono sia identificatori di raccolta che di risorsa per identificare in modo univoco una risorsa. Per saperne di più, consulta Nomi delle risorse. |
city |
Città |
La città in cui ha avuto origine l'attività dell'utente. |
cityId |
ID città |
L'ID geografico della città in cui ha avuto origine l'attività utente, derivato dal suo indirizzo IP. |
country |
Paese |
Il paese in cui ha avuto origine l'attività dell'utente. |
countryId |
ID paese |
L'ID geografico del paese in cui ha avuto origine l'attività dell'utente, derivato dal suo indirizzo IP. Formattato secondo lo standard ISO 3166-1 alpha-2. |
deviceCategory |
Categoria dispositivo |
Il tipo di dispositivo: desktop, tablet o smartphone. |
eventName |
Nome evento |
Il nome dell'evento. |
minutesAgo |
Minuti trascorsi in tempo reale |
Il numero di minuti fa in cui è stato raccolto un evento. 00 è il minuto corrente, mentre 01 indica il minuto precedente. |
platform |
Piattaforma |
La piattaforma su cui sono stati consultati il tuo sito web o la tua app, ad esempio Web, iOS o Android. Per determinare il tipo di stream in un report, utilizza sia la piattaforma sia streamId. |
streamId |
ID stream |
L'identificatore numerico dello stream di dati per la tua app o il tuo sito web. |
streamName |
Nome flusso |
Il nome dello stream di dati per la tua app o il tuo sito web. |
unifiedScreenName |
Titolo pagina e nome schermata |
Il titolo della pagina (web) o il nome della schermata (app) in cui è stato registrato l'evento. |
Dimensioni personalizzate
L'API Realtime Data può creare report sulle dimensioni personalizzate basate sugli utenti. Consulta
Proprietà utente personalizzate per scoprire
di più sulle dimensioni personalizzate. Le dimensioni personalizzate vengono specificate in una richiesta di report API
in base al nome e all'ambito del parametro della dimensione. Ad esempio, includi
"customUser:last_level" in una richiesta dell'API Data per creare un report per la
dimensione personalizzata con ambito a livello di utente con il nome del parametro "last_level". Questa richiesta API
non andrà a buon fine se la proprietà non ha registrato questa dimensione personalizzata
ambito utente.
Di seguito è riportata la sintassi generale per le dimensioni personalizzate. Puoi eseguire query sul
metodo dell'API Metadata per elencare tutte le
dimensioni personalizzate per una proprietà.
| Nome API generico |
Descrizione |
customUser:parameter_name |
Dimensione personalizzata con ambito utente per parameter_name. |
Le dimensioni personalizzate basate sugli eventi non sono supportate nell'API Realtime.
Metriche
Le seguenti metriche possono essere richieste nei report per qualsiasi proprietà. Specifica il
"Nome API" nel campo di una risorsa Metric per
una colonna della metrica nella risposta del report.name
| Nome API |
Nome dell'UI |
Descrizione |
activeUsers |
Utenti attivi |
Il numero di utenti distinti che hanno visitato il tuo sito o la tua app. |
eventCount |
Conteggio eventi |
Il conteggio degli eventi. |
keyEvents |
Eventi chiave |
Il conteggio degli eventi chiave. Se contrassegni un evento come evento chiave, questo influisce sui report dal momento della creazione. I dati storici non vengono modificati. Puoi contrassegnare qualsiasi evento come evento chiave in Google Analytics. Alcuni, ad esempio first_open o purchase, sono contrassegnati come eventi chiave per impostazione predefinita. |
screenPageViews |
Visualizzazioni |
Il numero di schermate di app o pagine web visualizzate dagli utenti. Le visualizzazioni ripetute di una stessa pagina o schermata vengono conteggiate. (eventi screen_view + eventi page_view). |
Le metriche personalizzate basate sugli eventi non sono supportate nell'API Realtime.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-29 UTC.
[null,null,["Ultimo aggiornamento 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."]]
