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.