Le dimensioni e le metriche supportate nelle query al metodo in tempo reale dell'API di dati Analytics. I metodi di reporting principali (ad esempio RunReport) accettano un insieme di dimensioni e metriche diverso 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 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 della risorsa di questo segmento di pubblico. I nomi delle risorse contengono sia gli identificatori delle raccolte 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à utente, recuperato 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à utente, recuperato 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 trascorsi dalla raccolta di un evento. 00 è il minuto corrente e 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 platform che 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 della 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 API di dati per creare un report per la dimensione personalizzata basata sull'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 con ambito utente.
Di seguito è riportata la sintassi generale per le dimensioni personalizzate. Puoi eseguire una query sul metodo API Metadata per elencare tutte le dimensioni personalizzate di 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 UI | Descrizione |
|---|---|---|
activeUsers |
Utenti attivi | Il numero di utenti distinti che hanno visitato il tuo sito o la tua app. |
eventCount |
Conteggio eventi | Il numero di 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 Realtime.