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.