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.