As dimensões e métricas aceitas em consultas ao método Realtime da API Google Analytics Data. Os
métodos de relatórios principais (RunReport
por exemplo) aceitam um conjunto diferente de dimensões e métricas
do método Realtime.
Dimensões
As dimensões a seguir podem ser solicitadas em relatórios de qualquer propriedade. Especifique
o "Nome da API" em um recurso Dimension's campo name
para uma coluna da dimensão na resposta do relatório.
| Nome da API | Nome da interface | Descrição |
|---|---|---|
appVersion |
Versão do app | O nome da versão (Android) ou versão abreviada do pacote (iOS) do aplicativo. |
audienceId |
ID do público-alvo | O identificador numérico de um público-alvo. Os usuários são informados nos públicos-alvo a que pertenciam durante o período do relatório. O comportamento atual do usuário não afeta a participação do público-alvo histórico nos relatórios. |
audienceName |
Nome do público-alvo | O nome de um público-alvo. Os usuários são informados nos públicos-alvo a que pertenciam durante o período do relatório. O comportamento atual do usuário não afeta a participação do público-alvo histórico nos relatórios. |
audienceResourceName |
Nome do recurso de público-alvo | O nome do recurso desse público-alvo. Os nomes de recursos contêm identificadores de coleção e de recursos para identificar um recurso de maneira exclusiva. Para saber mais, consulte Nomes de recursos. |
city |
Cidade | A cidade em que a atividade do usuário teve origem. |
cityId |
ID da cidade | O ID geográfico da cidade em que a atividade do usuário teve origem, derivado do endereço IP. |
country |
País | O país em que a atividade do usuário teve origem. |
countryId |
ID do país | O ID geográfico do país em que a atividade do usuário teve origem, derivado do endereço IP. Formatado de acordo com o padrão ISO 3166-1 alfa-2. |
deviceCategory |
Categoria do dispositivo | O tipo de dispositivo: computador, tablet ou celular. |
eventName |
Nome do evento | O nome do evento. |
minutesAgo |
Minutos atrás em tempo real | O número de minutos atrás em que um evento foi coletado. 00 é o minuto atual, e 01 significa o minuto anterior. |
platform |
Plataforma | A plataforma em que seu app ou site foi executado, por exemplo, Web, iOS ou Android. Para determinar o tipo de stream em um relatório, use a plataforma e o streamId. |
streamId |
ID do stream | O identificador numérico do fluxo de dados do seu app ou site. |
streamName |
Nome do fluxo | O nome do fluxo de dados do seu app ou site. |
unifiedScreenName |
Título da página e nome da tela | O título da página (Web) ou o nome da tela (app) em que o evento foi registrado. |
Dimensões personalizadas
A API Realtime Data pode criar relatórios sobre dimensões personalizadas no escopo do usuário. Consulte
Propriedades personalizadas do usuário para saber
mais sobre dimensões personalizadas. As dimensões personalizadas são especificadas em uma solicitação de relatório da API pelo nome e escopo do parâmetro da dimensão. Por exemplo, inclua
"customUser:last_level" em uma solicitação de API de dados para criar um relatório da
dimensão personalizada no escopo do usuário com o nome do parâmetro "last_level". Essa solicitação de API vai falhar se a propriedade não tiver registrado essa dimensão personalizada no escopo do usuário.
A seguir, confira a sintaxe geral das dimensões personalizadas. Você pode consultar o método da API Metadata para listar todas as dimensões personalizadas de uma propriedade.
| Nome da API genérico | Descrição |
|---|---|
customUser:parameter_name |
Dimensão personalizada no escopo do usuário para parameter_name. |
As dimensões personalizadas no escopo do evento não são aceitas na API Realtime.
Métricas
As métricas a seguir podem ser solicitadas em relatórios de qualquer propriedade. Especifique o
"Nome da API" no Metric campo name para
uma coluna da métrica na resposta do relatório.
| Nome da API | Nome da interface | Descrição |
|---|---|---|
activeUsers |
Usuários ativos | Número de usuários únicos que acessaram seu site ou app. |
eventCount |
Contagem de eventos | A contagem de eventos. |
keyEvents |
Eventos principais | A contagem de eventos principais. Marcar um evento como evento principal afeta os relatórios desde o momento da criação. Isso não muda os dados históricos. Você pode marcar qualquer evento como principal no Google Analytics, e alguns deles (como first_open ou purchase) são classificados assim por padrão. |
screenPageViews |
Visualizações | É o número de telas do app ou páginas da Web que os usuários visualizaram. Visualizações repetidas de uma única página ou tela são consideradas. (eventos screen_view + page_view). |
As métricas personalizadas no escopo do evento não são aceitas na API Realtime.