Dimensões e métricas em tempo real

As dimensões e métricas compatíveis com consultas ao método Realtime da API Data do Google Analytics. Os métodos de relatório principal (RunReport, por exemplo) aceitam um conjunto diferente de dimensões e métricas do que o método em tempo real.

Dimensões

As dimensões a seguir podem ser solicitadas em relatórios de qualquer propriedade. Especifique o "Nome da API" no campo name de um recurso Dimension 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 Código 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 recurso para identificar exclusivamente um recurso. 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 de origem da atividade do usuário, 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 de origem da atividade do usuário, 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 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 um stream em um relatório, use "platform" e "streamId".
streamId ID do stream É o identificador numérico de 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 do usuário personalizadas para saber mais sobre as 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 da API Data para criar um relatório para a dimensão personalizada no escopo do usuário com o nome de 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.

Confira a seguir a sintaxe geral das dimensões personalizadas. Você pode consultar o Método da API de metadados para listar todas as dimensões personalizadas de uma propriedade.

Nome genérico da API 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 compatíveis com a Realtime API.

Métricas

As métricas a seguir podem ser solicitadas em relatórios de qualquer propriedade. Especifique o "Nome da API" no campo name de um recurso Metric 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 principal afeta os relatórios desde o momento da criação deles. 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 acessaram. 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 compatíveis com a API Realtime.