Le dimensioni e le metriche supportate nelle query al metodo Realtime dell'API di dati di Analytics. I
metodi di reporting principali (RunReport
ad esempio) accettano un insieme di dimensioni e metriche
diverso dal metodo Realtime.
Dimensioni
Nei report per qualsiasi proprietà è possibile richiedere le seguenti dimensioni. Specifica
il "Nome API" nel campo name
di una risorsa Dimensionper una colonna della dimensione nella risposta del report.
| Nome API | Nome 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 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 della risorsa di questo segmento di pubblico. I nomi delle risorse contengono sia gli identificatori di raccolta sia quelli delle risorse 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à dell'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 in base allo 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 trascorsi da quando è stato raccolto un evento. 00 indica 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 di dati in tempo reale può creare report sulle dimensioni personalizzate con ambito utente. Per saperne di più sulle dimensioni personalizzate, consulta
Proprietà utente personalizzate. Le dimensioni personalizzate vengono specificate in una richiesta di report API in base al nome del parametro e all'ambito della dimensione. Ad esempio, includi
"customUser:last_level" in una richiesta dell'API di dati per creare un report per la
dimensione personalizzata con ambito utente con nome del parametro "last_level". Questa richiesta API non andrà a buon fine se la proprietà non ha registrato questa dimensione personalizzata con ambito utente.
Di seguito è riportata la sintassi generale per le dimensioni personalizzate. Puoi eseguire una 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 con ambito evento non sono supportate nell'API in tempo reale.
Metriche
Nei report per qualsiasi proprietà è possibile richiedere le seguenti metriche. Specifica il
"Nome API" nel campo name di una risorsa Metric per
una colonna della metrica nella risposta del report.
| Nome API | Nome 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 con ambito evento non sono supportate nell'API in tempo reale.