Dimensioni e metriche in tempo reale

Le dimensioni e le metriche supportate nelle query al metodo in tempo reale dell'API di dati di Analytics. I metodi di generazione di report principali (ad esempio RunReport) accettano un insieme di dimensioni e metriche diverso dal 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.
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, ottenuto in base al 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 dall'indirizzo IP. Formattata 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 precedenti alla raccolta di un evento. 00 indica il minuto attuale, 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 il tipo platform sia l'ID stream.
streamId ID stream L'identificatore dello stream di dati numerico 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) su cui è stato registrato l'evento.

Dimensioni personalizzate

L'API Realtime Data può creare report sulle dimensioni personalizzate con ambito utente. Per scoprire di più sulle dimensioni personalizzate, consulta Proprietà utente 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 sugli utenti con nome parametro "last_level". Questa richiesta 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 una query sul metodo dell'API metadata per elencare tutte le dimensioni personalizzate di una proprietà.

Nome API generico Descrizione
customUser:nome_parametro 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.
conversioni Conversioni Il conteggio degli eventi di conversione. Gli eventi vengono contrassegnati come conversioni al momento della raccolta; le modifiche al contrassegno di conversione di un evento vengono applicate in seguito. Puoi contrassegnare qualsiasi evento come conversione in Google Analytics e alcuni eventi (ad es. first_open e purchase) sono contrassegnati come conversioni per impostazione predefinita. Per saperne di più, consulta Informazioni sulle conversioni.
eventCount Conteggio eventi Il conteggio degli eventi.
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.