Este guia explica informações importantes sobre os dados que você vê nos relatórios gerados usando a API Google Analytics Data. Os usuários geralmente encontram discrepâncias entre os dados retornados pela API (especificamente o método runReport) e os dados mostrados na interface do Google Analytics.
Amostragem e agregação
O método runReport da API Google Analytics Data pode retornar dados de amostra,
especialmente para conjuntos de dados grandes ou consultas complexas. Embora a
interface do Google Analytics também aplique amostragem, os limites e algoritmos
específicos podem ser diferentes, levando a pequenas diferenças nos valores informados.
Para entender se os resultados do relatório são baseados em um subconjunto dos dados disponíveis, inspecione o campo samplingMetadatas do objeto ResponseMetaData. Se os resultados do relatório forem amostrados, esse campo vai descrever a porcentagem de eventos usados no relatório.
Alguns métodos de relatórios da API Google Analytics Data permitem especificar o nível de amostragem que você quer. Use o campo
samplingLevel
do método properties.reportTasks.create
para controlar o nível de amostragem do relatório.
Esse recurso dá às propriedades do Google Analytics 360 acesso a limites de amostragem mais altos de 1 bilhão de eventos. Além disso, os limites de amostragem podem ser definidos como UNSAMPLED
para usar resultados não amostrados em grandes contagens de eventos.
Para mais informações, consulte Sobre a amostragem de dados.
Aproximação da contagem única
A API Google Analytics Data usa o algoritmo HyperLogLog++ (HLL++) para estimar contagens exclusivas de métricas como "Usuários ativos" e "Sessões". Essa abordagem é usada na API e na interface do Google Analytics para melhorar o desempenho e gerenciar grandes conjuntos de dados de forma eficiente, o que significa que os resultados são aproximações, e não contagens exatas.
Para mais contexto, consulte os seguintes recursos: Estimativa da contagem única no Google Analytics e Diferenças nas contagens de usuários.
Limites mínimos de dados
O Google Analytics pode aplicar limites mínimos de dados aos relatórios para evitar a identificação de usuários individuais com base em informações demográficas, interesses ou outros indicadores presentes nos dados.
Se uma linha do relatório tiver um número pequeno de usuários, ela poderá ser excluída dos resultados. Isso é mais comum em relatórios que incluem dimensões de alta cardinalidade ou personalizadas.
Para entender se esse relatório está sujeito à aplicação de limites, inspecione o campo subjectToThresholding do objeto ResponseMetaData.
Saiba mais em Limites mínimos de dados.
A linha (other)
Se uma dimensão tiver alta cardinalidade, o Google Analytics poderá agrupar os valores menos comuns em uma linha rotulada como (other). Isso é mais comum em relatórios que incluem dimensões com mais de 500 valores exclusivos por dia.
Ao usar filtros com a API Data, observe que eles não analisam a linha (other) e são aplicados depois que os dados são agregados e a linha (other) é gerada.
Para entender se um relatório contém dados agrupados na linha (other),
inspecione o campo
dataLossFromOtherRow
do objeto ResponseMetaData.
Para mais informações, consulte Linha (other) no Google Analytics.
Identidade do relatório
A identidade do relatório decide como os usuários são deduplicados nos relatórios. Diferentes configurações de identidade (como "Combinada" ou "Com base no dispositivo") podem resultar em contagens de usuários diferentes para o mesmo período.
A interface do Google Analytics e a API Data usam a mesma configuração de identidade do relatório para sua propriedade. Se essa configuração for alterada, ela vai afetar os relatórios na interface e na API. Se a configuração for alterada entre a geração de um relatório na interface e a obtenção dos dados do relatório pela API, as contagens de usuários poderão ser diferentes entre os dois relatórios para o mesmo período.
Especificidade da consulta
Para minimizar as discrepâncias, verifique se os seguintes parâmetros na sua solicitação de API correspondem exatamente às configurações no relatório da interface do Google Analytics:
- Períodos: verifique se as datas de início e término são idênticas.
- Dimensões e métricas: verifique se as dimensões e métricas na sua solicitação de API são as mesmas do relatório da interface do Google Analytics.
- Filtros: verifique se os filtros de dimensão ou métrica aplicados na solicitação de API correspondem aos usados na interface.
Adicionar dimensões a um relatório pode resultar em menos eventos usados nos cálculos. Somente os eventos que contêm dados para as dimensões solicitadas são incluídos em um relatório. Como resultado, adicionar dimensões a uma consulta pode alterar os valores agregados das métricas em um relatório.
Atualização de dados
O Google Analytics leva tempo para processar e agregar dados de eventos. Ao trabalhar com dados muito recentes, você pode notar pequenas diferenças entre os relatórios se houver um atraso entre as recuperações de dados. Por exemplo, se você visualizar um relatório na interface e, em seguida, consultar a API para o mesmo relatório minutos depois, os dados podem ter mudado devido ao processamento e à agregação em andamento.
Para mais informações, consulte Atualização de dados.
Alternativas de dados sem amostra
Se o caso de uso exigir dados completos, não amostrados e no nível do evento, use as seguintes alternativas:
BigQuery Export: BigQuery Export para o Google Analytics
é o método recomendado para análise avançada de dados de eventos brutos.
Analytics 360: as propriedades com uma licença do Analytics 360 têm limites de amostragem mais altos e acesso a recursos de relatórios mais detalhados.