Le dimensioni e le metriche supportate nelle query al metodo in tempo reale dell'API di dati Analytics. I metodi di reporting principali (RunReport, ad esempio) 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
"Nome API" nel campo name
Dimension di una risorsa per una colonna della dimensione nella risposta del report.
| Nome API | Nome dell'interfaccia utente | 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 della risorsa di questo segmento di pubblico. I nomi delle risorse contengono sia gli identificatori della raccolta sia quelli della 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, dedotto 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, dedotto 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 prima della raccolta di un evento. 00 indica il minuto corrente e 01 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 uno stream in un report, utilizza sia platform 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. Per scoprire di più sulle dimensioni personalizzate, consulta Proprietà utente personalizzate. Le dimensioni personalizzate vengono specificate in una richiesta di report dell'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 basata sugli utenti con il nome del parametro "last_level". Questa richiesta
dell'API non andrà a buon fine se la proprietà non ha registrato questa dimensione personalizzata basata sugli utenti.
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 basata sugli utenti 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 name di una risorsa Metric per una colonna della metrica nella risposta del report.
| Nome API | Nome dell'interfaccia utente | 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 in tempo reale.