Registro de alterações da API de relatórios do Google Analytics

Periodicamente, atualizamos a API de relatórios do Google Analytics para oferecer novos recursos e corrigir defeitos identificados nas versões anteriores. Na maioria dos casos, essas alterações ficam evidentes para os desenvolvedores de API. No entanto, às vezes, precisamos fazer alterações que exigem que os desenvolvedores modifiquem os aplicativos existentes.

Esta página documenta todas as alterações realizadas na API de relatórios do Google Analytics que podem afetar seu aplicativo. Recomendamos que os desenvolvedores de API consultem regularmente esta lista para se manterem informados sobre novos comunicados. Você também pode se inscrever para receber as alterações por meio dos feeds listados na seção Inscrever-se abaixo.

Inscrever-se nos registros de alterações relacionados

Inclui todas as APIs de coleta, configuração e relatórios.

Inclui as APIs de relatórios principais, de relatórios de funis multicanal e de relatórios em tempo real.

Esta é a versão inicial da API User Activity.

  • Com a API User Activity, você pode recuperar todos os dados associados a um único ID do cliente ou do usuário em um determinado período. O objetivo principal é permitir que os proprietários deem acesso automático às informações de um usuário diretamente a ele. Acesse o guia da API User Activity para mais detalhes.

Esta versão aumenta o número máximo de linhas retornadas no conjunto de resultados da API Reporting v4 do Google Analytics.

O número máximo de linhas retornadas no objeto ReportData da API Reporting v4 do Analytics aumentou de 10.000 para 100.000.

Nesta versão, adicionamos uma prévia do sistema de cota com base em recursos à API Reporting v4 do Google Analytics, que permite o uso de limites de amostragem mais altos para clientes do Analytics 360 (Premium).

Nesta versão, descontinuamos o recurso de produtos relacionados e as dimensões e métricas associadas. Leia a Referência das dimensões e métricas (em inglês) para conferir todas as definições. Consulte a política de suspensão de uso de dados para ver detalhes sobre a remoção de informações:

Nesta versão, suspendemos o uso das seguintes dimensões e métricas:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

Nesta versão, adicionamos uma nova dimensão à API. Leia a referência das dimensões e métricas para ver todas as definições. Também removemos várias dimensões e métricas descontinuadas. Leia a política sobre descontinuação de dados das APIs do Google Analytics para entender o processo de remoção de dados.

Tempo

  • Nova dimensão ga:dateHourMinute, que combina ga:date, ga:hour e ga:minute.

Remoção de dados

Nesta versão, removemos as seguintes dimensões e métricas obsoletas:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

Nesta versão, atualizamos as métricas e dimensões existentes na API. Leia a referência das dimensões e métricas para ver todas as definições.

Métricas do usuário

O cálculo das métricas Usuários e Usuários ativos foi atualizado para oferecer uma contagem mais eficiente. Talvez você veja uma pequena alteração nas suas métricas. Para mais informações, consulte Como os usuários são identificados nas métricas de usuários.

Métricas do usuário afetadas pela atualização do cálculo:

  • ga:users – Número total de usuários no período solicitado.
  • ga:1dayusers – Número total de usuários ativos em um dia para cada dia do período solicitado.
  • ga:7dayusers – Número total de usuários ativos por sete dias para cada dia do período solicitado.
  • ga:14dayusers – Número total de usuários ativos por 14 dias para cada dia do período solicitado.
  • ga:30dayusers – Número total de usuários ativos por 30 dias para cada dia do período solicitado.

Eventos únicos

Estamos chegando ao fim do período de descontinuação de ga:uniqueEvents. Depois de 26 de março de 2017, a definição de ga:uniqueEvents será atualizada, e a métrica ga:uniqueEventsTemporary privada vai ser removida da API. Para mais informações, consulte a documentação de ajuda sobre eventos únicos.

Nesta versão, adicionamos uma nova dimensão à API, aprimoramos as mensagens de erro e começamos a aplicar as mudanças anunciadas às dimensões e métricas do Google AdSense.

Dimensões do usuário

  • Dimensão ga:userBucket – a dimensão "Grupo de usuários" (valores de 1 a 100) indica a que grupo o usuário foi atribuído. Consulte o artigo Testar campanhas de remarketing para mais detalhes.

Mensagens de erro

Nos casos em que a API retornava as mensagens de erro Unknown dimension(s): ou Unknown metric(s): incorretamente ao solicitar dados com condições que não foram atendidas, ela agora retorna Restricted metric(s): ... can only be queried under certain conditions.

Dimensões e métricas do Google AdSense

Não será mais possível consultar dimensões e métricas do Google AdSense nas vistas não associadas a ele. Se você fizer isso, um erro será mostrado.

Nesta versão, corrigimos um bug nas dimensões e métricas do Google AdSense e anunciamos uma mudança futura nelas.

Dimensões e métricas do Google AdSense

Nesta versão, corrigimos um problema que surgiu em 07/01/2017, em que a consulta das dimensões e métricas do Google AdSense retornava o erro "Métrica desconhecida" para vistas não associadas ao AdSense.

Mudanças futuras

A partir de 31/01/2017, não será mais possível consultar as dimensões e métricas do AdSense nas vistas não associadas ao produto. Se você fizer isso, um erro será mostrado.

Nesta versão, incluímos a métrica a seguir na API. Leia a referência das dimensões e métricas para ver todas as definições.

Métricas calculadas

Nesta versão, adicionamos suporte às métricas calculadas.

  • Métrica ga:calcMetric_ – valor da métrica calculada pedida, em que é o nome definido pelo usuário para ela. O tipo de dados de ga:calcMetric_ pode ser FLOAT, INTEGER, CURRENCY, TIME ou PERCENT. Para mais detalhes, consulte Sobre as métricas calculadas.

Nesta versão, adicionamos uma nova métrica à API e também suspendemos o uso de uma métrica. Leia a referência das dimensões e métricas para ver todas as definições.

Acompanhamento de eventos

A definição de ga:uniqueEvents será alterada para refletir o número de eventos únicos com mais precisão. Para aplicar essa mudança, vamos descontinuar a métrica ga:uniqueEvents atual de acordo com nossa política de descontinuação de dados. Se você quiser testar a nova definição, consulte a métrica ga:uniqueEventsTemporary privada, que calcula o número de eventos únicos com mais precisão. Também adicionaremos uma nova métrica ga:uniqueDimensionCombinations que mantém a definição atual de ga:uniqueEvents. Após o período adequado de aproximadamente seis meses, a métrica privada ga:uniqueEventsTemporary será removida, e a original ga:uniqueEvents vai representar corretamente o número de eventos únicos. Para mais informações, consulte a documentação de ajuda sobre eventos únicos.

Eventos únicos

  • Métrica ga:uniqueEvents – a definição de ga:uniqueEvents em breve vai mudar para refletir melhor o número de eventos únicos. Em vez disso, use ga:uniqueDimensionCombinations se quiser manter a definição atual. Para mais informações, consulte a documentação de ajuda sobre eventos únicos.
  • Métrica ga:uniqueDimensionCombinations – as combinações de dimensões exclusivas registram o número de combinações únicas de dimensões e valores para cada dimensão presente em um relatório. Assim, você pode criar dimensões combinadas (concatenadas) depois do processamento e gerar relatórios mais flexíveis sem precisar atualizar a implementação do acompanhamento nem usar outros espaços de dimensões personalizadas. Para mais informações, consulte a documentação de ajuda sobre eventos únicos.

Teste de transição – privado

  • Métrica ga:uniqueEventsTemporary – número de eventos únicos. Esta será a nova definição de ga:uniqueEvents. Você pode usar essa métrica para entender a nova definição antes da mudança. Essa métrica é privada e não será mostrada na referência das dimensões e métricas.

Nesta versão, adicionamos novas dimensões e métricas à API. Leia a referência das dimensões e métricas para ver todas as definições.

DoubleClick Bid Manager

  • Dimensão ga:dbmClickAdvertiser – nome do anunciante do DBM para o clique nessa plataforma correspondente à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmClickAdvertiserId – ID do anunciante do DBM para o clique nessa plataforma correspondente à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmClickCreativeId – ID do criativo do DBM para o clique nessa plataforma correspondente à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmClickExchange – nome da troca do DBM para o clique nessa plataforma correspondente à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmClickExchangeId – ID da troca do DBM para o clique nessa plataforma correspondente à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmClickInsertionOrder – nome do pedido de inserção do DBM para o clique nessa plataforma correspondente à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmClickInsertionOrderId – ID do pedido de inserção do DBM para o clique nessa plataforma referente à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmClickLineItem – nome do item de linha do DBM para o clique nessa plataforma correspondente à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmClickLineItemId – código do item de linha do DBM para o clique nessa plataforma correspondente à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmClickSite – nome do site do DBM em que o criativo dessa plataforma foi mostrado e clicado para o clique do DBM correspondente à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmClickSiteId – ID do site do DBM em que o criativo dessa plataforma foi mostrado e clicado para o clique do DBM correspondente à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmLastEventAdvertiser – nome do anunciante do DBM referente ao último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) e associado à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmLastEventAdvertiserId – ID do anunciante do DBM referente ao último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) e associado à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmLastEventCreativeId – ID do criativo do DBM referente ao último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) e associado à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmLastEventExchange – nome da troca do DBM referente ao último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) e associado à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmLastEventExchangeId – ID da troca do DBM referente ao último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) e associado à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmLastEventInsertionOrder – nome do pedido de inserção do DBM referente ao último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) e associado à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmLastEventInsertionOrderId – ID do pedido de inserção do DBM referente ao último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) e associado à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmLastEventLineItem – nome do item de linha do DBM referente ao último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) e associado à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmLastEventLineItemId – ID do item de linha do DBM referente ao último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) e associado à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmLastEventSite – nome do site do DBM em que o criativo dessa plataforma foi mostrado e clicado para o último evento do DBM (na janela de lookback) e que está associado à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dbmLastEventSiteId – ID do site do DBM em que o criativo dessa plataforma foi mostrado e clicado para o último evento do DBM (na janela de lookback) e que está associado à sessão do Google Analytics (somente Analytics 360; requer integração com o DBM).
  • Métrica ga:dbmCPA – eCPA da receita do DBM (somente Analytics 360; requer integração com o DBM).
  • Métrica ga:dbmCPC – eCPC da receita do DBM (somente Analytics 360; requer integração com o DBM).
  • Métrica ga:dbmCPM – eCPM da receita do DBM (somente Analytics 360; requer integração com o DBM).
  • Métrica ga:dbmCTR – CTR do DBM (somente Analytics 360; requer integração com o DBM).
  • Métrica ga:dbmClicks – Total de cliques do DBM (somente Analytics 360; requer integração com o DBM).
  • Métrica ga:dbmConversions – Total de conversões do DBM (somente Analytics 360; requer integração com o DBM).
  • Métrica ga:dbmCost – Custo do DBM (somente Analytics 360; requer integração com o DBM).
  • Métrica ga:dbmImpressions – Total de impressões do DBM (somente Analytics 360; requer integração com o DBM).
  • Métrica ga:dbmROAS – ROAS do DBM (somente Analytics 360; requer integração com o DBM).
  • Dimensão ga:dsAdGroup – grupo de anúncios do DS (somente Analytics 360; requer integração com o DS).
  • Dimensão ga:dsAdGroupId – ID do grupo de anúncios do DS (somente Analytics 360; requer integração com o DS).
  • Dimensão ga:dsAdvertiser – Anunciante do DS (somente Analytics 360; requer integração com o DS).
  • Dimensão ga:dsAdvertiserId – ID do anunciante do DS (somente Analytics 360; requer integração com o DS).
  • Dimensão ga:dsAgency – Agência do DS (somente Analytics 360; requer integração com o DS).
  • Dimensão ga:dsAgencyId – ID da agência do DS (somente Analytics 360; requer integração com o DS).
  • Dimensão ga:dsCampaign – Campanha do DS (somente Analytics 360; requer integração com o DS).
  • Dimensão ga:dsCampaignId – ID da campanha do DS (somente Analytics 360; requer integração com o DS).
  • Dimensão ga:dsEngineAccount – Conta de mecanismo do DS (somente Analytics 360; requer integração com o DS).
  • Dimensão ga:dsEngineAccountId – ID da conta de mecanismo do DS (somente Analytics 360; requer integração com o DS).
  • Dimensão ga:dsKeyword – Palavra-chave do DS (somente Analytics 360; requer integração com o DS).
  • Dimensão ga:dsKeywordId – ID de palavra-chave do DS (somente Analytics 360; requer integração com o DS).
  • ga:dsCPC – Custo por clique para o anunciante do DS (somente Analytics 360; requer integração com o DS).
  • ga:dsCTR – Taxa de cliques do DS (somente Analytics 360; requer integração com o DS).
  • ga:dsClicks – Cliques do DS (somente Analytics 360; requer integração com o DS).
  • ga:dsCost – Custo do DS (somente Analytics 360; requer integração com o DS).
  • ga:dsImpressions – Impressões do DS (somente Analytics 360; requer integração com o DS).
  • ga:dsProfit – Lucro do DS (somente Analytics 360; requer integração com o DS).
  • ga:dsReturnOnAdSpend – retorno do investimento em publicidade do DS (somente Analytics 360; requer integração com o DS).
  • ga:dsRevenuePerClick – receita por clique do DS (somente Analytics 360; requer integração com o DS).

Nesta versão, adicionamos uma nova dimensão à API e também incluímos algumas restrições na combinação de dimensões que podem ser consultadas juntas. Leia a referência das dimensões e métricas para ver todas as definições.

Rede geográfica

  • Dimensão ga:continentId – ID do continente dos usuários, derivado dos endereços IP ou dos IDs de áreas geográficas.

Restrições

As seguintes dimensões nos grupos abaixo não podem ser consultadas com as dimensões em outros grupos:

  • Grupo de informações de visitas no Google Shopping
    • ga:checkoutOptions
    • ga:shoppingStage
  • Grupo experimental do GWO
    • ga:experimentVariant
    • ga:experimentId
  • Grupo de interesse
    • ga:interestOtherCategory
  • Grupo de interesse no mercado
    • ga:interestInMarketCategory
  • Grupo de promoção interna:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • Grupo de interesse em branding:
    • ga:interestAffinityCategory

Esta versão inclui novos limites e cotas. Veja a documentação de limites e cotas para mais detalhes.

Como informar erros

Nesta versão, começamos a impor limites a solicitações de relatórios com falha (5XX).

  • 10 solicitações com falha por projeto, perfil e hora
  • 50 solicitações com falha por projeto, perfil e dia

Limites de tabela dinâmica

Nesta versão, começamos a impor limites a solicitações de tabela dinâmica:

  • Uma solicitação de relatório agora pode ter no máximo duas tabelas dinâmicas.
  • Uma tabela dinâmica pode ter até quatro dimensões.
  • As dimensões de tabela dinâmica fazem parte da restrição que se aplica ao número total permitido na solicitação.
  • As metrics de tabela dinâmica fazem parte da restrição do número total de métricas aceitas na solicitação.

Nesta versão, adicionamos novas dimensões e métricas à API. Leia a referência das dimensões e métricas para ver todas as definições.

Rede geográfica

  • Dimensão ga:metroId – código de três dígitos da Área designada do mercado (DMA) que gerou o tráfego, derivado dos endereços IP ou dos IDs de áreas geográficas dos usuários.

DoubleClick for Publishers

  • Métrica ga:dfpImpressions – uma impressão de anúncio do DFP é registrada sempre que um anúncio individual é exibido no site. Por exemplo, se uma página com dois blocos de anúncios for vista uma vez, vamos mostrar duas impressões: uma com a opção "Vinculação do DFP" ativada e outra com "Ocultar receita do DFP" desativada.
  • Métrica ga:dfpCoverage – cobertura é a porcentagem de solicitações que retornaram pelo menos um anúncio. Geralmente, ela ajuda a identificar sites em que a conta do DFP não consegue oferecer anúncios segmentados. (Impressões de anúncios / total de solicitações de anúncios) * 100 ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:dfpMonetizedPageviews – calcula o número total de visualizações de página na propriedade que foram exibidas com um anúncio da conta vinculada do DFP. Uma única página pode ter vários blocos de anúncios ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:dfpImpressionsPerSession – proporção de impressões de anúncios do DFP para sessões do Google Analytics (Impressões de anúncios / sessões do Analytics; "Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:dfpViewableImpressionsPercent – porcentagem de impressões de anúncios visíveis. Uma impressão é considerada visível quando aparece nos navegadores dos usuários e pode ser vista ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:dfpClicks – número de cliques nos anúncios do DFP no site ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:dfpCTR – porcentagem de visualizações de página que resultaram em um clique em um anúncio do DFP ("Vinculação do DFP" ativada e "Ocultar receita do DFP" não ativada).
  • Métrica ga:dfpRevenue – uma estimativa da receita de publicidade total com base nas impressões veiculadas ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:dfpRevenuePer1000Sessions – receita total estimada dos anúncios do DFP por mil sessões do Google Analytics. Ela se baseia em sessões do site, não em impressões de anúncios ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:dfpECPM – custo efetivo por mil visualizações de página. É a receita do DFP por mil visualizações de página ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:backfillImpressions – impressões de preenchimento são a soma de todas as impressões de anúncios do Google AdSense ou Ad Exchange veiculadas como preenchimento pelo DFP. Uma impressão de anúncio é registrada sempre que um anúncio individual é exibido no site. Por exemplo, se uma página com dois blocos de anúncios for vista uma vez, vamos mostrar duas impressões: uma com a opção "Vinculação do DFP" ativada e outra com "Ocultar receita do DFP" desativada.
  • Métrica ga:backfillCoverage – cobertura de preenchimento é a porcentagem de solicitações de anúncios de preenchimento que retornaram pelo menos um anúncio. Geralmente, ela ajuda a identificar sites em que a conta do editor não conseguiu oferecer anúncios segmentados. (Impressões de anúncios / total de solicitações de anúncios) * 100. Se o Google AdSense e o Ad Exchange oferecerem anúncios desse tipo, ela vai ser a média ponderada das duas contas de preenchimento ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:backfillMonetizedPageviews – número total de visualizações de página na propriedade que foram mostradas com pelo menos um anúncio das contas de preenchimento vinculadas. Uma única visualização monetizada pode incluir várias impressões ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:backfillImpressionsPerSession – proporção de impressões de anúncios de preenchimento para sessões do Google Analytics (impressões de anúncios / sessões do Analytics). Se o Google AdSense e o Ad Exchange oferecerem anúncios de preenchimento, ela será a soma das duas contas de preenchimento ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:backfillViewableImpressionsPercent – porcentagem de impressões de anúncios de preenchimento que estavam visíveis. Uma impressão é considerada visível quando aparece nos navegadores dos usuários e pode ser vista. Se o Google AdSense e o Ad Exchange oferecerem anúncios desse tipo, essa métrica vai ser a média ponderada das duas contas de preenchimento ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:backfillClicks – número de cliques nos anúncios de preenchimento no site. Se o Google AdSense e o Ad Exchange oferecerem anúncios desse tipo, ela vai ser a soma das duas contas de preenchimento ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:backfillCTR – porcentagem de impressões de preenchimento que resultaram em um clique em um anúncio. Se o Google AdSense e o Ad Exchange oferecerem anúncios desse tipo, essa métrica vai ser a média ponderada das duas contas de preenchimento ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:backfillRevenue – receita total estimada dos anúncios de preenchimento. Se o Google AdSense e o Ad Exchange oferecerem anúncios desse tipo, ela vai ser a soma das duas contas de preenchimento ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:backfillRevenuePer1000Sessions – receita total estimada dos anúncios de preenchimento por mil sessões do Google Analytics. Essa métrica se baseia nas sessões do site, e não nas impressões de anúncios. Se o Google AdSense e o Ad Exchange oferecerem anúncios de preenchimento, ela será a soma das duas contas de preenchimento ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:backfillECPM – custo efetivo por mil visualizações de página. É a receita do preenchimento do DFP por mil visualizações de página. Se o Google AdSense e o Ad Exchange oferecerem anúncios de preenchimento, ela será a soma das duas contas de preenchimento ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).

Este lançamento traz uma nova versão da API, a API Reporting v4 do Google Analytics. Ela é o método programático mais avançado para acessar dados de relatórios no Google Analytics.

Principais recursos

O Google Analytics foi criado em uma infraestrutura eficiente de geração de dados. Com a API, os desenvolvedores podem acessar toda a capacidade do Google Analytics. Estes são alguns dos principais recursos da API Reporting v4:

  • Expressões de métricas: a API permite solicitar expressões matemáticas, além das métricas integradas. Por exemplo, conclusões de meta por número de sessões podem ser apresentadas na solicitação como ga:goal1completions/ga:sessions.
  • Diversos períodos: é possível solicitar dois períodos e comparar os dados deles em uma única solicitação.
  • Coortes e valor da vida útil: a API tem um vocabulário avançado para solicitar relatórios de coortes e valor da vida útil.
  • Vários segmentos: agora você pode solicitar vários segmentos em uma única solicitação.

Vamos começar

Consulte a documentação do desenvolvedor para ver todos os detalhes sobre como usar a API.

Política de cotas

A API Reporting v4 do Google Analytics tem cotas e limites próprios. Como ela acabou de ser lançada, esses valores estão sujeitos a mudanças.

Migração

Além do guia de migração, também disponibilizamos uma biblioteca de compatibilidade de Python no GitHub (em inglês).

Dimensões e métricas

Nesta versão, também adicionamos um conjunto de dimensões e métricas específicas para a API Reporting v4 do Google Analytics. Consulte Explorador de dimensões e métricas para ver todas as definições.

  • Dimensão ga:cohort – Nome da coorte a que um usuário pertence com base na definição de coortes. Dependendo de como os coortes são definidos, um usuário pode pertencer a vários coortes e segmentos.

  • Dimensão ga:cohortNthDay – Ajuste de dia com base no valor zero relativo à data de definição do coorte. Por exemplo, se um coorte for definido com a primeira data de acesso como 01/09/2015, o valor ga:cohortNthDay da data 04/09/2015 será três.

  • ga:cohortNthMonth – Ajuste de mês com base no valor zero relativo à data de definição do coorte.

  • Dimensão ga:cohortNthWeek – ajuste de semana com base no valor zero em relação à data de definição da coorte.

  • Dimensão ga:acquisitionTrafficChannel – canal de tráfego de origem da aquisição do usuário. Ele é extraído da primeira sessão do usuário. O canal é computado com base nas regras padrão de agrupamento de canais (no nível da vista, se disponível) durante a aquisição.

  • Dimensão ga:acquisitionSource – a origem de aquisição do usuário. Derivada da primeira sessão do usuário.

  • Dimensão ga:acquisitionMedium – a mídia de aquisição do usuário. Derivada da primeira sessão do usuário.

  • Dimensão ga:acquisitionSourceMedium – O valor combinado de ga:userAcquisitionSource e ga:acquisitionMedium.

  • Dimensão ga:acquisitionCampaign – A campanha de aquisição do usuário. Derivada da primeira sessão do usuário.

  • Métrica ga:cohortActiveUsers – é relevante no contexto das dimensões de ajuste com base no valor zero (ga:cohortNthDay, ga:cohortNthWeek ou ga:cohortNthMonth). Indica o número de usuários que estão ativos na janela correspondente à coorte no nº dia/semana/mês. Por exemplo, para ga:cohortNthWeek = 1, ela representa o número de usuários (no coorte) que estão ativos na segunda semana. Se uma solicitação não tiver ga:cohortNthDay, ga:cohortNthWeek ou ga:cohortNthMonth, a métrica terá o mesmo valor que ga:cohortTotalUsers.

  • Métrica ga:cohortTotalUsers – Número de usuários que pertencem ao coorte, também conhecida como tamanho de coorte.

  • Métrica ga:cohortAppviewsPerUser – Exibições do app por usuário em um coorte.

  • Métrica ga:cohortGoalCompletionsPerUser – conclusões de meta por usuário em uma coorte.

  • Métrica ga:cohortPageviewsPerUser – visualizações de página por usuário em uma coorte.

  • Métrica ga:cohortRetentionRate – taxa de retenção da coorte.

  • Métrica ga:cohortRevenuePerUser – Receita por usuário em um coorte.

  • Métrica ga:cohortVisitDurationPerUser – Duração da sessão por usuário em um coorte.

  • Métrica ga:cohortSessionsPerUser – Sessões por usuário em um coorte.

  • Métrica ga:cohortTotalUsersWithLifetimeCriteria – relevante para solicitações que têm as dimensões ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium ou ga:acquisitionCampaign. Ela representa o número de usuários nas coortes que foram adquiridos pelo canal, origem, mídia ou campanha atuais. Por exemplo, para ga:acquisitionTrafficChannel=Direct, essa métrica representa o número de usuários no coorte que foram adquiridos diretamente. Se nenhuma das dimensões mencionadas estiver presente, o valor será ga:cohortTotalUsers.

  • Métrica ga:cohortAppviewsPerUserWithLifetimeCriteria – vistas do app por usuário para a dimensão de aquisição em uma coorte.

  • Métrica ga:cohortGoalCompletionsPerUserWithLifetimeCriteria – conclusões de meta por usuário para a dimensão de aquisição em uma coorte.

  • Métrica ga:cohortPageviewsPerUserWithLifetimeCriteria – visualizações de página por usuário para a dimensão de aquisição em uma coorte.

  • Métrica ga:cohortRevenuePerUserWithLifetimeCriteria – receita por usuário para a dimensão de aquisição em uma coorte.

  • Métrica ga:cohortSessionsPerUserWithLifetimeCriteria – duração da sessão por usuário para a dimensão de aquisição em uma coorte.

As dimensões e métricas do hub de dados de redes sociais foram descontinuadas e, a partir de 30 de abril de 2016, só vão informar dados históricos. Novas informações não serão mais mostradas após essa data. De acordo com a política sobre descontinuação de dados, essas dimensões e métricas serão removidas após 30 de setembro de 2016.

Leia a referência das dimensões e métricas para ver todas as definições.

Atividades em redes sociais

Essas dimensões e métricas foram descontinuadas e vão ser removidas após 30 de setembro de 2016. Consulte a política de descontinuação de dados para ver mais detalhes:

  • Dimensão ga:socialActivityEndorsingUrl – em uma atividade do hub de dados de redes sociais, ela representa o URL da ação (por exemplo, da postagem do Google+, do comentário do blog etc.).
  • Dimensão ga:socialActivityDisplayName – em uma Atividade do hub de dados de redes sociais, ela representa o título da ação postada pelos usuários.
  • Dimensão ga:socialActivityPost – em uma Atividade do hub de dados de redes sociais, ela representa o conteúdo da ação (por exemplo, de uma mensagem no Google+) postada pelos usuários.
  • Dimensão ga:socialActivityTimestamp – em uma Atividade do hub de dados de redes sociais, ela representa o momento em que a ação ocorreu.
  • Dimensão ga:socialActivityUserHandle – em uma atividade do hub de dados de redes sociais, ela representa o identificador da rede social (por exemplo, nome ou ID) de usuários que iniciaram a ação.
  • Dimensão ga:socialActivityUserPhotoUrl – em uma atividade do hub de dados de redes sociais, ela representa o URL da foto associada aos perfis dos usuários.
  • Dimensão ga:socialActivityUserProfileUrl – em uma atividade do hub de dados de redes sociais, ela representa o URL dos perfis dos usuários associados.
  • Dimensão ga:socialActivityTagsSummary – em uma atividade do hub de dados de redes sociais, ela representa um conjunto de tags separadas por vírgula associadas à ação.
  • Dimensão ga:socialActivityAction – em uma atividade do hub de dados de redes sociais, ela representa o tipo de ação (por exemplo, voto, comentário, marcação com +1 etc.) associada à atividade.
  • Dimensão ga:socialActivityNetworkAction – em uma Atividade do hub de dados de redes sociais, ela representa o tipo de ação e a origem dela.
  • Dimensão ga:socialActivityContentUrl – em uma atividade do hub de dados de redes sociais, ela representa o URL compartilhado pelos usuários associados.
  • Métrica ga:socialActivities – número total de atividades em que um URL de conteúdo foi compartilhado ou mencionado em uma rede de parceiros de hub de dados de redes sociais.

Nesta versão, adicionamos uma nova dimensão à API Leia a referência das dimensões e métricas para ver todas as definições.

Plataforma ou dispositivo

  • Dimensão ga:browserSize – Tamanho da janela de visualização dos navegadores dos usuários. O tamanho do navegador, no escopo da sessão, captura as dimensões iniciais da janela de visualização em pixels e tem o formato largura X altura. Por exemplo: 1.920 x 960.

Nesta versão, adicionamos um novo parâmetro à API.

Incluir linhas vazias

  • Nesta versão, adicionamos o novo parâmetro opcional include-empty-rows. Quando ele é definido como false, as linhas sem dados são omitidas da resposta. O valor padrão é true, que é uma alteração não interruptiva e, por isso, não requer atualização de código. Consulte a documentação Referência da API Core Reporting para mais detalhes.

Nesta versão, adicionamos novas métricas à API. Leia a referência das dimensões e métricas para ver todas as definições.

Usuário

  • Métrica ga:1dayUsers – Número total de usuários ativos em um dia para cada dia do período solicitado. Pelo menos um dos parâmetros ga:nthDay, ga:date ou ga:day precisa ser especificado como uma dimensão para consultar essa métrica. Para a data definida, o valor retornado será o total de usuários únicos no período de um dia que termina na data especificada.
  • Métrica ga:7dayUsers – Número total de usuários ativos em sete dias para cada dia do período solicitado. Pelo menos um dos parâmetros ga:nthDay, ga:date ou ga:day precisa ser especificado como uma dimensão para consultar essa métrica. Para a data definida, o valor retornado será o total de usuários únicos no período de sete dias que termina na data especificada.
  • Métrica ga:14dayUsers – Número total de usuários ativos em 14 dias para cada dia do período solicitado. Pelo menos um dos parâmetros ga:nthDay, ga:date ou ga:day precisa ser especificado como uma dimensão para consultar essa métrica. Para a data definida, o valor retornado será o total de usuários únicos no período de 14 dias que termina na data especificada.
  • Métrica ga:30dayUsers – Número total de usuários ativos em 30 dias para cada dia do período solicitado. Pelo menos um dos parâmetros ga:nthDay, ga:date ou ga:day precisa ser especificado como uma dimensão para consultar essa métrica. Para a data definida, o valor retornado será o total de usuários únicos no período de 30 dias que termina na data em questão.

Nesta versão, adicionamos novas métricas à API. Leia a referência das dimensões e métricas para ver todas as definições.

DoubleClick Ad Exchange (AdX)

  • Métrica ga:adxCTR – Porcentagem de visualizações de página que resultaram em um clique em um anúncio do AdX.
  • Métrica ga:adxClicks – Número de vezes que os anúncios do AdX foram clicados no seu site.
  • Métrica ga:adxCoverage – cobertura é a porcentagem de solicitações que retornaram pelo menos um anúncio. Em geral, a cobertura ajuda a identificar os sites em que sua conta do AdX não consegue oferecer anúncios segmentados. (Impressões de anúncios / total de solicitações de anúncios) * 100
  • Métrica ga:adxECPM – custo efetivo por mil visualizações de página. É a receita do AdX a cada mil visualizações de página.
  • Métrica ga:adxImpressions – uma impressão do AdX é registrada sempre que um anúncio individual é mostrado no seu site. Por exemplo, se uma página com dois blocos for visualizada uma vez, vamos mostrar duas impressões.
  • Métrica ga:adxImpressionsPerSession – a proporção de impressões de anúncios do AdX para sessões do Google Analytics (impressões de anúncios / sessões do Analytics).
  • Métrica ga:adxMonetizedPageviews – As visualizações de página monetizadas contabilizam o número total de visualizações de página na propriedade que foram exibidas com um anúncio da sua conta do AdX vinculada. Observação: uma única página pode ter vários blocos de anúncios.
  • Métrica ga:adxRevenue – Receita total estimada dos anúncios do AdX.
  • Métrica ga:adxRevenuePer1000Sessions – Receita total estimada dos anúncios do AdX por mil sessões do Google Analytics. Essa métrica se baseia nas sessões do seu site, não em impressões.
  • Métrica ga:adxViewableImpressionsPercent – A porcentagem de impressões de anúncios que estavam visíveis. Uma impressão é considerada visível quando é exibida no navegador do usuário e pode ser vista.

Nesta versão, descontinuamos algumas dimensões ou métricas. Leia a referência das dimensões e métricas para ver todas as definições.

Dimensões descontinuadas

Estas dimensões foram descontinuadas. Consulte a política sobre descontinuação de dados para mais detalhes:

  • Dimensão ga:adSlotPosition – Em vez dela, use ga:adSlot.
  • Dimensão ga:nextPagePath – Em vez dela, use ga:pagePath.
  • Dimensão ga:nextContentGroupXX – em vez dela, use ga:contentGroupXX.

Nesta versão, adicionamos uma nova dimensão à API Leia a referência das dimensões e métricas para ver todas as definições.

Google AdWords

  • Dimensão ga:adQueryWordCount – número de palavras na consulta de pesquisa.

Nesta versão, adicionamos novas dimensões à API. Leia a referência das dimensões e métricas para ver todas as definições.

Plataforma ou dispositivo

  • Dimensão ga:dataSource – Origem de dados de um hit. Os hits enviados de ga.js e analytics.js são informados como “web”, e aqueles enviados dos SDKs para dispositivos móveis são informados como "app". Esses valores podem ser substituídos.
  • Dimensão ga:searchAfterDestinationPage – página que o usuário visitou depois de realizar uma pesquisa interna no seu site.

Nesta versão, adicionamos novas dimensões e métricas à API e descontinuamos duas métricas. Leia a referência das dimensões e métricas para ver todas as definições.

ECommerce

  • Métrica ga:transactionsPerUser – Número total de transações dividido pelo número total de usuários.
  • Métrica ga:revenuePerUser – receita total de vendas na transação, excluindo frete e tributos, dividida pelo número total de usuários.

Usuário

  • Métrica ga:sessionsPerUser – Número total de sessões dividido pelo número total de usuários.

Rede geográfica

  • Dimensão ga:cityId – IDs de cidade dos usuários derivados dos endereços IP ou dos IDs de áreas geográficas.
  • Dimensão ga:countryIsoCode – código ISO do país dos usuários derivado dos endereços IP ou dos códigos de regiões geográficas. Os valores são indicados como um código ISO 3166-1 alfa-2.
  • Dimensão ga:regionId – ID da região dos usuários derivado dos endereços IP ou dos IDs de áreas geográficas. Nos EUA, a região é um estado, como Nova York.
  • Dimensão ga:regionIsoCode – código ISO da região dos usuários derivado dos endereços IP ou dos códigos de regiões geográficas. Os valores são indicados como um código ISO-3166-2.
  • Dimensão ga:subContinentCode – código de subcontinente dos usuários derivado dos endereços IP ou dos códigos de regiões geográficas. Por exemplo, Polinésia ou Norte da Europa. Os valores são indicados como um código UN M.49.

DoubleClick Campaign Manager

  • Métrica ga:dcmROAS – retorno do investimento em publicidade (ROAS) do DCM (somente premium).

Métricas descontinuadas

Estas métricas foram descontinuadas. Consulte a política sobre descontinuação de dados para mais detalhes: + Métrica ga:dcmROI – use ga:dcmROAS. + Métrica ga:dcmMargen – use ga:dcmROAS.

Nesta versão, adicionamos uma nova métrica à API e suspendemos o uso de duas métricas existentes. Leia a referência das dimensões e métricas para ver todas as definições.

AdWords

  • Métrica ga:ROAS – Retorno do investimento em publicidade (ROAS) é a receita total da transação e o valor da meta dividido pelo custo de publicidade derivado.

Dimensões e métricas descontinuadas

Estas dimensões e métricas foram descontinuadas. Consulte a política de descontinuação de dados para mais detalhes: + Métrica ga:ROI – use ga:ROAS. + Métrica ga:margin – use ga:ROAS.

Nesta versão, adicionamos novas métricas à API. Leia a referência das dimensões e métricas para ver todas as definições.

AdSense

  • Métrica ga:adsenseCoverage – porcentagem de solicitações que retornaram pelo menos um anúncio.
  • Métrica ga:adsenseViewableImpressionPercent – porcentagem de impressões que estavam visíveis.

Nesta versão, adicionamos uma nova métrica de sessão, uma nova dimensão de origens de tráfego e novas dimensões e métricas do DoubleClick Campaign Manager.

Dimensões e métricas

Leia a referência das dimensões e métricas para ver todas as definições.

Sessão

  • Métrica ga:hits – Número total de hits enviados ao Google Analytics. Ela soma todos os tipos de hit (por exemplo, visualização de página, evento, tempo etc.)

Origens de tráfego

  • Dimensão ga:campaignCode – Quando você usa o acompanhamento de campanhas manual, ela é o valor do parâmetro "utm_id".

DoubleClick Campaign Manager

  • Dimensão ga:dcmClickAd – nome do anúncio do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickAdId – ID do anúncio do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickAdType – nome do tipo de anúncio do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickAdTypeId – ID do tipo de anúncio do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickAdvertiser – nome do anunciante do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickAdvertiserId – ID do anunciante do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickCampaign – Nome da campanha do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickCampaignId – ID da campanha do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickCreative – nome do criativo do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickCreativeId – ID do criativo do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickCreativeType – nome do tipo de criativo do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickCreativeTypeId – ID do tipo de criativo do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickCreativeVersion – Versão do criativo do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickRenderingId – ID da renderização do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickSite – nome do site em que o criativo do DCM foi mostrado e clicado para o clique correspondente à sessão do Google Analytics (somente Premium).
  • Dimensão ga:dcmClickSiteId – Código do site do DCM em que o criativo foi mostrado e clicado para o clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickSitePlacement – Nome do canal do site do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickSitePlacementId – ID do canal do site do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickSpotId – ID de configuração do Floodlight do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmFloodlightActivity – Nome da atividade do Floodlight do DCM associada à conversão do Floodlight (somente premium).
  • Dimensão ga:dcmFloodlightActivityAndGroup – Nome e grupo da atividade do Floodlight do DCM associada à conversão do Floodlight (somente premium).
  • Dimensão ga:dcmFloodlightActivityGroup – Nome do grupo de atividades do Floodlight do DCM associado à conversão do Floodlight (somente premium).
  • Dimensão ga:dcmFloodlightActivityGroupId – Código do grupo de atividades do Floodlight do DCM associado à conversão do Floodlight (somente premium).
  • Dimensão ga:dcmFloodlightActivityId – Código da atividade do Floodlight do DCM associada à conversão do Floodlight (somente premium).
  • Dimensão ga:dcmFloodlightAdvertiserId – Código do anunciante do Floodlight do DCM associado à conversão do Floodlight (somente premium).
  • Dimensão ga:dcmFloodlightSpotId – Código da configuração do Floodlight do DCM associada à conversão do Floodlight (somente premium).
  • Dimensão ga:dcmLastEventAd – Nome do anúncio do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventAdId – ID do anúncio do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventAdType – Nome do tipo de anúncio do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventAdTypeId – Código do tipo de anúncio do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventAdvertiser – nome do anunciante do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventAdvertiserId – ID do anunciante do DCM referente ao último evento (impressão ou clique na janela de lookback) dessa plataforma correspondente à sessão do Google Analytics (somente Premium).
  • Dimensão ga:dcmLastEventAttributionType – Há dois valores possíveis ("ClickThrough" e "ViewThrough"). Se o último evento do DCM associado à sessão do Google Analytics for um clique, o valor será "ClickThrough". Se o último evento for uma impressão de anúncio, o valor será "ViewThrough" (somente premium).
  • Dimensão ga:dcmLastEventCampaign – nome da campanha do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventCampaignId – ID da campanha do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventCreative – nome do criativo do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventCreativeId – ID do criativo do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventCreativeType – Nome do tipo de criativo do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventCreativeTypeId – Código do tipo de criativo do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventCreativeVersion – Versão do criativo do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventRenderingId – ID da renderização do DCM referente ao último evento (impressão ou clique na janela de lookback) dessa plataforma correspondente à sessão do Google Analytics (somente Premium).
  • Dimensão ga:dcmLastEventSite – nome do site em que o criativo do DCM foi mostrado e clicado no último evento (impressão ou clique na janela de lookback) dessa plataforma correspondente à sessão do Google Analytics (somente Premium).
  • Dimensão ga:dcmLastEventSiteId – ID do site do DCM em que o criativo foi mostrado e clicado no último evento (impressão ou clique na janela de lookback) dessa plataforma correspondente à sessão do Google Analytics (somente Premium).
  • Dimensão ga:dcmLastEventSitePlacement – Nome do canal do site do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventSitePlacementId – Código do canal do site do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventSpotId – Código da configuração do Floodlight do DCM do último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Métrica ga:dcmFloodlightQuantity – Número de conversões do Floodlight do DCM (somente premium).
  • Métrica dcmFloodlightRevenue – receita do Floodlight do DCM (somente Premium).

Nesta versão, adicionamos novas dimensões e métricas de agrupamento de conteúdo.

Dimensões e métricas

Leia a referência das dimensões e métricas para ver todas as definições.

Agrupamento de conteúdo

  • Dimensão ga:landingContentGroupXX – Primeiro grupo de conteúdo correspondente na sessão de um usuário.
  • Dimensão ga:nextContentGroupXX – grupo de conteúdo visitado posteriormente.
  • Dimensão ga:contentGroupXX – Grupo de conteúdo em uma propriedade. É um conjunto de conteúdo que oferece uma estrutura lógica que pode ser determinada pelo código de acompanhamento ou pela correspondência de título de página/URL regex ou regras predefinidas.
  • Dimensão ga:previousContentGroupXX – grupo de conteúdo que foi visitado anteriormente.
  • Métrica ga:contentGroupUniqueViewsXX – Número de páginas diferentes (exclusivas) em uma sessão para o grupo de conteúdo especificado. Essa opção considera o pagePath e o pageTitle para determinar a exclusividade.

Nesta versão, incluímos uma nova condição dateOfSession nos segmentos e adicionamos novas dimensões e métricas de e-commerce avançado.

Segmentos

Agora é possível usar uma nova condição dateOfSession que pode restringir um segmento a um grupo de usuários que iniciaram uma sessão em um determinado período. Consulte o guia para desenvolvedores sobre segmentos e veja mais detalhes.

Dimensões e métricas

Leia a Referência das dimensões e métricas para conferir todas as definições de e-commerce avançado.

E-commerce avançado

  • Dimensão ga:internalPromotionCreative – conteúdo do anúncio criado para uma promoção.
  • Dimensão ga:internalPromotionId – Código que você está usando para a promoção.
  • Dimensão ga:internalPromotionName – Nome da promoção.
  • Dimensão ga:internalPromotionPosition – Posição da promoção na página da Web ou na tela do aplicativo.
  • Dimensão ga:orderCouponCode – código do cupom no nível do pedido.
  • Dimensão ga:productBrand – nome da marca de venda do produto.
  • Dimensão ga:productCategoryHierarchy – categoria hierárquica a que o produto pertence (e-commerce avançado).
  • Dimensão ga:productCategoryLevelXX – Nível (1-5) na hierarquia de categoria de produtos, em ordem crescente.
  • Dimensão ga:productCouponCode – código do cupom no nível do produto.
  • Dimensão ga:productListName – Nome da lista de produtos em que o produto é exibido.
  • Dimensão ga:productListPosition – Posição do produto na lista de produtos.
  • Dimensão ga:productVariant – Variação específica de um produto, por exemplo, PP, P, M, G para o tamanho ou vermelho, azul, verde, preto para a cor.
  • Dimensão ga:checkoutOptions – Opções do usuário especificadas durante o processo de finalização de compra, por exemplo, FedEx, DHL, UPS para opções de entrega ou Visa, MasterCard, AmEx para opções de pagamento. Essa dimensão precisa ser utilizada com o estágio de compra.
  • Dimensão ga:shoppingStage – várias fases da experiência de compra que os usuários concluíram em uma sessão, por exemplo, PRODUCT_VIEW, ADD_TO_CART, CHECKOUT etc.
  • Métrica ga:internalPromotionCTR – número de vezes que os usuários clicaram para visualizar a promoção interna (nº de cliques / nº de vezes que a promoção foi mostrada).
  • Métrica ga:internalPromotionClicks – Número de cliques em uma promoção interna.
  • Métrica ga:internalPromotionViews – Número de visualizações de uma promoção interna.
  • Métrica ga:localProductRefundAmount – Valor de reembolso de um determinado produto na moeda local.
  • Métrica ga:localRefundAmount – Valor total do reembolso para a transação na moeda local.
  • Métrica ga:productAddsToCart – Número de vezes que o produto foi adicionado ao carrinho de compras.
  • Métrica ga:productCheckouts – número de vezes que o produto foi incluído no processo de finalização de compra.
  • Métrica ga:productDetailViews – número de vezes que os usuários viram a página de detalhes do produto.
  • Métrica ga:productListClicks – número de vezes que os usuários clicaram no produto quando ele apareceu na lista de produtos.
  • Métrica ga:productListViews – Número de vezes que o produto apareceu em uma lista de produtos.
  • Métrica ga:productListCTR – número de vezes que os usuários clicaram no item em uma lista de produtos.
  • Métrica ga:productRefunds – Número de vezes que um reembolso foi emitido para o produto.
  • Métrica ga:productRefundAmount – Valor total do reembolso associado ao produto.
  • Métrica ga:productRemovesFromCart – Número de vezes que o produto foi removido dos carrinhos de compras.
  • Métrica ga:productRevenuePerPurchase – receita média do produto por compra (normalmente usada com o código do cupom do produto).
  • Métrica ga:buyToDetailRate – compras exclusivas divididas pelas visualizações das páginas de detalhes do produto.
  • Métrica ga:cartToDetailRate – adições do produto divididas pelas visualizações dos detalhes dele.
  • Métrica ga:quantityAddedToCart – Número de unidades do produto adicionadas ao carrinho.
  • Métrica ga:quantityCheckedOut – Número de unidades do produto inclusas na finalização de compra.
  • Métrica ga:quantityRefunded – Número de unidades de produto reembolsadas.
  • Métrica ga:quantityRemovedFromCart – Número de unidades de produto removidas do carrinho.
  • Métrica ga:refundAmount – Valor da moeda reembolsado para uma transação.
  • Métrica ga:totalRefunds – número de reembolsos emitidos.

Nesta versão, corrigimos o bug nos nomes de cabeçalho de coluna e adicionamos novas dimensões e métricas.

Dimensões e métricas

Leia a referência das dimensões e métricas para ver todas as definições.

Sistema

  • Dimensão ga:sourcePropertyDisplayName – Nome de exibição da propriedade de origem das propriedades de visualização completa. Válida apenas para esse tipo de propriedade.
  • Dimensão ga:sourcePropertyTrackingId – ID de acompanhamento da propriedade de origem das propriedades de visualização completa. Válida apenas para esse tipo de propriedade.

Agrupamento de canais

  • Dimensão ga:channelGrouping – Agrupamento de canais padrão que é compartilhado dentro da vista (perfil).
  • Dimensão ga:correlationModelId – Código do modelo de correlação dos produtos relacionados.
  • Dimensão ga:queryProductId – ID do produto que está sendo consultado.
  • Dimensão ga:queryProductName – nome do produto que está sendo consultado.
  • Dimensão ga:queryProductVariation – variação do produto que está sendo consultada.
  • Dimensão ga:relatedProductId – ID do produto relacionado.
  • Dimensão ga:relatedProductName – nome do produto relacionado.
  • Dimensão ga:relatedProductVariation – variação do produto relacionado.
  • Métrica ga:correlationScore – Pontuação de correlação dos produtos relacionados.
  • Métrica ga:queryProductQuantity – quantidade do produto que está sendo consultado.
  • Métrica ga:relatedProductQuantity – Quantidade do produto relacionado.

Correção do nome da coluna do cabeçalho

  • Havia um bug na versão 16/04/2014 em que a consulta de uma dimensão ou métrica obsoleta retornava cabeçalhos de coluna com outros dados. Agora, a API retorna corretamente o mesmo nome de dimensão ou métrica usado na solicitação.

Nesta versão, adicionamos e renomeamos dimensões e métricas. Leia a referência das dimensões e métricas para ver todas as definições.

Novas dimensões e métricas

As seguintes dimensões foram adicionadas à API Core Reporting:

AdWords

  • Dimensão ga:isTrueViewVideoAd, Yes ou No – Indica se o anúncio é um anúncio em vídeo TrueView do Google AdWords.

Tempo

  • Dimensão ga:nthHour – índice para cada hora no período especificado. O índice da primeira hora do primeiro dia (ou seja, data de início) no período é 0, 1 para a próxima hora e assim por diante.

Renomeação de dimensões e métricas

Todas as dimensões e métricas com base em visitante e visita foram renomeadas para utilizar usuário e sessão, respectivamente.

As dimensões e métricas a seguir foram renomeadas. Consulte a política de descontinuação de dados para ver mais detalhes:

Público-alvo

  • Dimensão ga:visitorAgeBracket – Em vez dela, use ga:userAgeBracket.
  • Dimensão ga:visitorGender – Em vez dela, use ga:userGender.

e-commerce

  • Métrica ga:transactionRevenuePerVisit – Em vez dela, use ga:transactionRevenuePerSession.
  • Métrica ga:transactionsPerVisit – Em vez dela, use ga:transactionsPerSession.

Acompanhamento de eventos

  • Métrica ga:eventsPerVisitWithEvent – Em vez dela, use ga:eventsPerSessionWithEvent.
  • Métrica ga:visitsWithEvent – Em vez dela, use ga:sessionsWithEvent.

Conversões de meta

  • Métrica ga:goalValuePerVisit – Em vez dela, use ga:goalValuePerSession.
  • Métrica ga:percentVisitsWithSearch – Em vez dela, use ga:percentSessionsWithSearch.
  • Métrica ga:searchVisits – Em vez dela, use ga:searchSessions.

Acompanhamento de páginas

  • Métrica ga:pageviewsPerVisit – Em vez dela, use ga:pageviewsPerSession.

Sessão

  • Dimensão ga:visitLength – Em vez dela, use ga:sessionDurationBucket.
  • Métrica ga:avgTimeOnSite – Em vez dela, use ga:avgSessionDuration.
  • Métrica ga:timeOnSite – Em vez dela, use ga:sessionDuration.
  • Métrica ga:visitBounceRate – Em vez dela, use ga:bounceRate.
  • Métrica ga:visits – Em vez dela, use ga:sessions.

Interações em redes sociais

  • Dimensão ga:socialInteractionNetworkActionVisit – Em vez dela, use ga:socialInteractionNetworkActionSession.
  • Métrica ga:socialInteractionsPerVisit – Em vez dela, use ga:socialInteractionsPerSession.

Usuário

  • Dimensão ga:daysSinceLastVisit – Em vez dela, use ga:daysSinceLastSession.
  • Dimensão ga:visitCount – Em vez dela, use ga:sessionCount.
  • Dimensão ga:visitorType – Em vez dela, use ga:userType.
  • Dimensão ga:visitsToTransaction – Em vez dela, use ga:sessionsToTransaction.
  • Métrica ga:newVisits – Em vez dela, use ga:newUsers.
  • Métrica ga:percentNewVisits – Em vez dela, use ga:percentNewSessions.
  • Métrica ga:visitors – em vez dela, use ga:users.

Segmentos: API Core Reporting v2.4 e v3.0

Novos segmentos compatíveis com a API Core Reporting.

  • O parâmetro segment agora é compatível com segmentos de sequência e usuário. Os segmentos no nível do usuário e da sessão criados na interface da Web podem ser consultados com o parâmetro segment.
  • Uma nova sintaxe para segmentos dinâmicos está disponível para ser usada com o parâmetro segment. Consulte o guia para desenvolvedores sobre segmentos se quiser mais detalhes.
  • O prefixo dynamic:: foi descontinuado. É recomendável migrate o quanto antes.

Nesta versão, incluímos um novo formato de resposta de tabela de dados, adicionamos dimensões e métricas e removemos outras. Leia a Referência das dimensões e métricas para ver todas as definições.

Saída da tabela de dados

Para facilitar a renderização dos seus dados do Google Analytics usando as visualizações dos Gráficos Google, a API pode retornar um objeto de tabela de dados na resposta.

  • Adicionamos um parâmetro de consulta output opcional à API. Ele pode ser usado para selecionar o formato de saída dos dados do Google Analytics na resposta, que é JSON por padrão, e, se definido como datatable, uma propriedade dataTable que contém um objeto de tabela de dados será incluída na resposta. Esse objeto pode ser usado diretamente com o Gráficos Google. Consulte a Referência da API Core Reporting para mais detalhes.

Novas dimensões e métricas

As seguintes dimensões e métricas foram adicionadas à API Core Reporting:

Tempo

  • Dimensão ga:minute – retorna o minuto da hora. Os valores possíveis são entre 00 e 59.
  • Dimensão ga:nthMinute – índice para cada minuto no período especificado. O índice do primeiro minuto do primeiro dia (ou seja, data de início) no período é 0, 1 para o próximo minuto e assim por diante.

Público-alvo

  • Dimensão ga:visitorAgeBracket – Faixa etária do visitante.
  • Dimensão ga:visitorGender – Sexo do visitante.
  • Dimensão ga:interestAffinityCategory – Indica que os usuários têm mais chances de se interessarem em saber mais sobre a categoria especificada.
  • Dimensão ga:interestInMarketCategory – Indica que os usuários têm mais chances de estarem prontos para comprar produtos ou serviços na categoria especificada.
  • Dimensão ga:interestOtherCategory – Indica que os usuários têm mais chances de se interessarem em saber mais sobre a categoria especificada e de estarem prontos para comprar.

Dimensões e métricas permitidas nos segmentos

Essas dimensões e métricas agora podem ser usadas em segmentos:

  • Dimensão ga:sourceMedium – Valores combinados de ga:source e ga:medium.
  • Métrica ga:localItemRevenue – Receita do produto na moeda local.

Dimensões e métricas descontinuadas

Estas dimensões e métricas foram descontinuadas. Consulte a política sobre descontinuação de dados para mais detalhes:

  • Dimensão ga:isMobile – Em vez dela, use ga:deviceCategory (por exemplo, ga:deviceCategory==mobile).
  • Dimensão ga:isTablet – Em vez dela, use ga:deviceCategory (por exemplo, ga:deviceCategory==tablet).
  • Métrica ga:entranceBounceRate – em vez dela, use ga:visitBounceRate.

Nesta versão, adicionamos novas dimensões e métricas à API. Leia a referência das dimensões e métricas para ver todas as definições.

Google AdSense

  • Adicionamos acesso aos dados do Google AdSense:

    • Métrica ga:adsenseRevenue – receita total dos anúncios do Google AdSense.
    • Métrica ga:adsenseAdUnitsViewed – número de blocos de anúncios do Google AdSense vistos. Um bloco é um conjunto de anúncios exibido cuja exibição resulta de uma parte do código de anúncio do Google AdSense. Para mais detalhes, acesse https://support.google.com/adsense/answer/32715.
    • Métrica ga:adsenseAdsViewed – Número de anúncios do Google AdSense visualizados. Vários anúncios podem ser exibidos em um bloco.
    • Métrica ga:adsenseAdsClicks – Número de cliques nos anúncios do Google AdSense no seu site.
    • Métrica ga:adsensePageImpressions – Número de visualizações de página que resultaram na exibição de um anúncio do Google AdSense. Uma impressão de página pode ter vários blocos de anúncios.
    • Métrica ga:adsenseCTR – Porcentagem de impressões de página que resultaram em um clique em um anúncio do Google AdSense. (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • Métrica ga:adsenseECPM – Custo estimado por mil impressões de página. É sua receita do Google AdSense por mil impressões de página. (ga:adsenseRevenue/(ga:adsensePageImpressions/1000).
    • Métrica ga:adsenseExits – Número de sessões encerradas porque um usuário clicou em um anúncio do Google AdSense.

Tempo

  • Dimensão ga:isoYear – ano da visita no formato ISO. Para mais detalhes, acesse http://en.wikipedia.org/wiki/ISO_week_date. ga:isoYear só pode ser usado com ga:isoWeek, porque ga:week representa o calendário gregoriano.
  • Dimensão ga:isoYearIsoWeek – Valores combinados de ga:isoYear e ga:isoWeek.

Google AdWords

  • Estes dados aparecem nos relatórios do Google AdWords:

Novos recursos de controle de tamanho da amostra e datas relativas

Datas relativas
  • Adicionamos suporte para datas relativas à API Core Reporting. Agora, today, yesterday e NdaysAgo são valores válidos para os parâmetros de consulta start-date e end-date.
  • O uso desses valores determinará automaticamente o período com base na data atual no momento em que a consulta é feita e no fuso horário da vista (perfil) especificada na consulta. Consulte a Referência da API para mais detalhes.
Nível de amostragem
  • Adicionamos um novo parâmetro, samplingLevel, que permite definir o nível de amostragem (ou seja, o número de visitas usadas para calcular o resultado) em uma consulta de relatório. Os valores permitidos são DEFAULT, FASTER e HIGHER_PRECISION.
  • Adicionamos dois novos campos à resposta da API: sampleSize e sampleSpace. Você pode usar esses valores para calcular a porcentagem de visitas que foram usadas em uma resposta com amostragem.
  • Consulte a Referência da API e a amostragem para mais detalhes.

Correções de bugs

  • Agora ga:adwordsCustomerID retorna corretamente o ID de cliente de 10 dígitos do Google AdWords associado ao AccountInfo.customerId da API AdWords. Assim, é possível agregar os dados do Analytics com várias contas do Google AdWords.

Além dos novos segmentos, lançaremos as seguintes mudanças na API Core Reporting:

  • O parâmetro segment agora é compatível com o novo ID alfanumérico dos segmentos avançados personalizados, que é retornado no conjunto de segmentos da API Management.
  • Os IDs numéricos atuais dos segmentos personalizados estão sendo descontinuados, os legados vão continuar sendo aceitos por seis meses. Recomendamos adicionar os novos códigos alfanuméricos aos aplicativos que salvam IDs de segmento do usuário. Ao fim do período de descontinuação, um erro será retornado para todas as consultas com os IDs antigos.
  • No momento, somente os segmentos no nível da visita criados na interface da Web poderão ser consultados usando o parâmetro segment.
  • Os segmentos padrão existentes que têm códigos numéricos negativos não serão afetados, mas os novos segmentos padrão ainda não são compatíveis.

Nesta versão, adicionamos novas dimensões e métricas à API. Leia a referência das dimensões e métricas para ver todas as definições.

Acompanhamento de apps

  • Esses dados são exibidos nos relatórios de perfil do app:
    • Dimensão ga:appId – ID do app.
    • Dimensão ga:appInstallerId – código do instalador (por exemplo, Google Play Store) de origem do download do aplicativo. Esse IDo é definido por padrão com base no método PackageManager#getInstallerPackageName.
    • Dimensão ga:appName – Nome do aplicativo.
    • Dimensão ga:appVersion – Versão do aplicativo.
    • Dimensão ga:exitScreenName – Nome da tela que o usuário visualizava quando saiu do aplicativo.
    • Dimensão ga:landingScreenName – Nome da primeira tela visualizada.
    • Dimensão ga:screenDepth – Número de exibições de tela por sessão informadas como uma string. Pode ser útil para histogramas.
    • Dimensão ga:screenName – Nome da tela.
    • Métrica ga:avgScreenviewDuration – Média de tempo em segundos que os usuários passaram em uma tela.
    • Métrica ga:timeOnScreen – Tempo gasto visualizando a tela atual.
    • Métrica ga:screenviews – Número total de exibições de tela. Use essa métrica em vez de ga:appviews.
    • Métrica ga:uniqueScreenviews – Número de ga:screenviews diferentes (exclusivas) em uma sessão. Use essa métrica em vez de ga:uniqueAppviews.
    • Métrica ga:screenviewsPerSession – Número médio de ga:screenviews por sessão. Use essa métrica em vez de ga:appviewsPerVisit.

Descontinuado

Estas métricas foram descontinuadas. Use o novo nome de cada uma delas.

  • Métrica ga:appviews – em vez dela, use ga:screenviews.
  • Métrica ga:uniqueAppviews – em vez dela, use ga:uniqueScreenviews.
  • Métrica ga:appviewsPerVisit – em vez dela, use ga:screenviewsPerSession.

Colunas ou variáveis personalizadas

  • Adicionamos o acesso a dimensões e métricas personalizadas:

    • Dimensão ga:dimensionXX – Nome da dimensão personalizada solicitada, em que XX é o número/índice dela.
    • Métrica ga:metricXX – Nome da métrica personalizada solicitada, em que XX é o número/índice dela.

Mudanças na documentação

Renomeamos a dimensão e a métrica a seguir da variável personalizada. Esta é apenas uma alteração na documentação. Não é necessário atualizar suas consultas.

  • ga:customVarName(n)ga:customVarNameXX
  • ga:customVarValue(n)ga:customVarValueXX

E-commerce

  • Dimensão ga:currencyCode – Código de moeda local da transação com base no padrão ISO 4217.
  • Métrica ga:localItemRevenue – Receita do produto na moeda local.
  • Métrica ga:localTransactionRevenue – Receita da transação na moeda local.
  • Métrica ga:localTransactionShipping – Custo de frete da transação na moeda local.
  • Métrica ga:localTransactionTax – Tributos da transação na moeda local.

Exceções

  • Esses dados são provenientes do acompanhamento de exceções.
    • Dimensão ga:exceptionDescription – Descrição da exceção.
    • Métrica ga:exceptionsPerScreenview – Número de exceções geradas dividido pelo número de exibições de tela.
    • Métrica ga:fatalExceptionsPerScreenview – Número de exceções fatais geradas dividido pelo número de exibições de tela.

Conversões de meta

  • Dimensão ga:goalCompletionLocation – Caminho da página ou o nome da tela correspondente a qualquer conclusão de meta do tipo de destino.
  • Dimensão ga:goalPreviousStep1 – caminho da página ou nome da tela correspondente a qualquer meta de tipo de destino que fica uma etapa antes do local de conclusão de meta.
  • Dimensão ga:goalPreviousStep2 – caminho da página ou nome de tela correspondente a qualquer meta de tipo de destino que fica duas etapas antes do local de conclusão da meta.
  • Dimensão ga:goalPreviousStep3 – Caminho da página ou nome da tela correspondente a qualquer meta de tipo de destino que fica três etapas antes do local de conclusão da meta.

Mudanças na documentação

Renomeamos a dimensão e as métricas a seguir de conversões de meta. Esta é apenas uma alteração na documentação. Não é necessário atualizar suas consultas.

  • ga:goal(n)AbandonRatega:goalXXAbandonRate
  • ga:goal(n)Abandonsga:goalXXAbandons
  • ga:goal(n)Completionsga:goalXXCompletions
  • ga:goal(n)ConversionRatega:goalXXConversionRate
  • ga:goal(n)Startsga:goalXXStarts
  • ga:goal(n)Valuega:goalXXValue
  • ga:searchGoal(n)ConversionRatega:searchGoalXXConversionRate
  • Métrica ga:percentSearchRefinements – porcentagem do número de vezes que um refinamento (ou seja, transição) ocorre entre as palavras-chave da rede de pesquisa interna em uma sessão.

Acompanhamento de páginas

  • Métrica ga:pageValue – Valor médio desta página ou do conjunto de páginas. Valor da página = ((receita da transação + valor total da meta) / visualizações únicas da página ou do grupo de páginas).

Plataforma ou dispositivo

  • Esses dados são derivados da string de user agent HTTP.

    • Dimensão ga:deviceCategory – Tipo de dispositivo: computador, tablet ou dispositivo móvel.
    • Dimensão ga:isTablet – indica os visitantes que usam tablets. Os valores possíveis são Yes ou No.
    • Dimensão ga:mobileDeviceMarketingName – Nome de marketing usado para dispositivos móveis.

Interações em redes sociais

  • Dados provenientes do acompanhamento de interações em mídias sociais no site.

    • Dimensão ga:socialEngagementType – Tipo de engajamento. Os valores possíveis são Socially Engaged ou Not Socially Engaged.

Tempo

  • Dimensão ga:dateHour – Valores combinados de ga:date e ga:hour.
  • Dimensão ga:dayOfWeekName – nome do dia da semana (em inglês).
  • Dimensão ga:isoWeek – número da semana no formato ISO com início na segunda-feira. Para mais detalhes, acesse http://en.wikipedia.org/wiki/ISO_week_date.
  • Dimensão ga:yearMonth – Valores combinados de ga:year e ga:month.
  • Dimensão ga:yearWeek – Valores combinados de ga:year e ga:week.

Origens de tráfego

  • Dimensão ga:fullReferrer – URL de referência completo, incluindo nome do host e caminho.
  • Dimensão ga:sourceMedium – valores combinados de ga:source e ga:medium.
  • Nesta versão, adicionamos cinco novas métricas de velocidade do site:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • Nesta versão, adicionamos um novo segmento padrão para o tráfego proveniente de tablets, gaid::-13.

Nesta versão, adicionamos novas dimensões e métricas à API. Leia a referência das dimensões e métricas para ver as definições.

Acompanhamento de apps

  • Esses dados aparecem nos relatórios do SDK de acompanhamento de apps para dispositivos móveis:
    • Métrica ga:uniqueAppviews – número de visualizações do app por sessão.
    • Métrica 'ga:appviews – Número total de visualizações do app.
    • Métrica ga:appviewsPerVisit – Número médio de visualizações do app por sessão.

Origens de tráfego

  • Dimensão ga:socialNetwork – String que representa o nome da rede social. Pode estar relacionada à rede social de referência para origens de tráfego ou àquela para Atividades do hub de dados de redes sociais. Por exemplo, Google+, Blogger, reddit etc.
  • Dimensão ga:hasSocialSourceReferral – indica as visitas que chegaram ao site de uma rede social de origem (por exemplo, Google+, Facebook, Twitter etc.). Os valores possíveis são "Sim" ou "Não" com a primeira letra em maiúscula.

Atividades em redes sociais

  • Esses dados vêm de atividades fora do site importadas de parceiros de hub de dados de redes sociais.
    • Dimensão ga:socialActivityDisplayName – Para uma Atividade do hub de dados de redes sociais, essa string representa o título da atividade postada pelo usuário.
    • Dimensão ga:socialActivityEndorsingUrl – para uma atividade do hub de dados de redes sociais, essa string representa o URL da atividade (por exemplo, da postagem no Google+, do comentário no blog etc.).
    • Dimensão ga:socialActivityPost – para uma atividade do hub de dados de redes sociais, essa string representa o conteúdo da atividade postada pelo usuário (por exemplo, o conteúdo da mensagem de uma postagem no Google+).
    • Dimensão ga:socialActivityTimestamp – para uma Atividade do hub de dados de redes sociais, essa string representa quando a atividade ocorreu.
    • Dimensão ga:socialActivityUserPhotoUrl – para uma atividade do hub de dados de redes sociais, essa string representa o URL da foto associada ao perfil do usuário.
    • Dimensão ga:socialActivityUserProfileUrl – para uma atividade do hub de dados de redes sociais, essa string representa o URL do perfil do usuário associado.
    • Dimensão ga:socialActivityContentUrl – Para uma Atividade do hub de dados de redes sociais, essa string representa o URL compartilhado pelo usuário da rede social associada.
    • Dimensão ga:socialActivityTagsSummary – para uma atividade do hub de dados de redes sociais, trata-se de um conjunto de tags separadas por vírgula associado à atividade.
    • Dimensão ga:socialActivityUserHandle – para uma atividade do hub de dados de redes sociais, essa string representa o identificador (por exemplo, nome) do usuário que iniciou a atividade.
    • Dimensão ga:socialActivityAction – para uma atividade do hub de dados de redes sociais, essa string representa o tipo de ação associada (por exemplo, votar, comentar, marcar com +1 etc.).
    • Dimensão ga:socialActivityNetworkAction – para uma atividade do hub de dados de redes sociais, essa string representa o tipo de ação e a rede de origem.
    • Métrica ga:socialActivities – contagem de atividades em que um URL de conteúdo foi compartilhado/mencionado em uma rede de parceiro de hub de dados de redes sociais.

Interações em redes sociais

  • Dados provenientes do acompanhamento de interações em mídias sociais no site.
    • Dimensão ga:socialInteractionAction – para as interações sociais, uma string que representa a atividade que está sendo acompanhada (por exemplo, marcar com +1 ou Gostei, adicionar aos favoritos).
    • Dimensão ga:socialInteractionNetwork – para as interações sociais, uma string que representa a rede que está sendo acompanhada (por exemplo, Google, Facebook, Twitter, LinkedIn).
    • Dimensão ga:socialInteractionNetworkAction – para as interações sociais, uma string que representa a concatenação da ga:socialInteractionNetwork e da ga:socialInteractionAction que estão sendo acompanhadas (por exemplo, Google: marcar com +1; Facebook: curtir).
    • Dimensão ga:socialInteractionTarget – para as interações sociais, uma string que representa o URL (ou recurso) que recebe a atividade.
    • Métrica ga:socialInteractions – Número total de interações sociais no seu site.
    • Métrica ga:uniqueSocialInteractions – Número total de interações sociais únicas no seu site. Tem como base o par de valores ga:socialInteractionNetwork e ga:socialInteractionAction.
    • Métrica – ga:socialInteractionsPerVisit - ga:socialInteractions / ga:uniqueSocialInteractions. O número médio de interações sociais por visita no seu site.

Dados geográficos / de rede

  • Dimensão ga:metro – a Área designada do mercado (DMA) de origem do tráfego.

Acompanhamento de páginas

  • Dimensão ga:pagePathLevel1 – Essa dimensão acumula todos os pagePaths no primeiro nível hierárquico do pagePath.
  • Dimensão ga:pagePathLevel2 – Essa dimensão acumula todos os pagePaths no segundo nível hierárquico do pagePath.
  • Dimensão ga:pagePathLevel3 – Essa dimensão acumula todos os pagePaths no terceiro nível hierárquico do pagePath.
  • Dimensão ga:pagePathLevel4 – Essa dimensão acumula todos os pagePaths no quarto nível hierárquico do pagePath. Todos os níveis adicionais na hierarquia do pagePath também são acumulados nessa dimensão.

Acompanhamento de exceções

  • Esses dados são provenientes de dados de acompanhamento de exceções.

    • Métrica ga:exceptions – Número de exceções que foram enviadas ao Google Analytics.
    • Métrica ga:fatalExceptions – Número de exceções em que isFatal está definido como "true".

Velocidade do usuário

  • Esses dados são provenientes das informações de velocidade do usuário.

    • Dimensão ga:userTimingCategory – String que classifica todas as variáveis de velocidade do usuário em grupos lógicos para facilitar a geração de relatórios.
    • Dimensão ga:userTimingLabel – string que indica o nome da ação do recurso que está sendo acompanhado.
    • Dimensão ga:userTimingVariable – String que pode ser usada para adicionar flexibilidade à exibição de velocidade do usuário nos relatórios.
    • Dimensão ga:userTimingValue – Tempo enviado ao Google Analytics em milissegundos.
    • Métrica ga:userTimingSample – Número de amostras que foram enviadas.
    • Métrica ga:avgUserTimingValue – Valor médio da velocidade do usuário. ga:userTimiingValue / ga:userTimiingSample.

Dispositivo / plataforma

  • Esses dados são provenientes do user agent das informações coletadas.
    • Dimensão ga:mobileDeviceBranding – Fabricante do dispositivo móvel ou nome de marca (por exemplo: Samsung, HTC, Verizon, T-Mobile).
    • Dimensão ga:mobileDeviceModel – Modelo de dispositivo móvel (por exemplo: Nexus S).
    • Dimensão ga:mobileInputSelector – Seletor usado no dispositivo móvel (por exemplo: tela touchscreen, joystick, anel de comando, stylus).
    • Dim - ga:mobileDeviceInfo – marca, modelo e nome comercial usados para identificar o dispositivo móvel.

Correções de bugs

  • Agora, a API identifica corretamente os caracteres UTF-8 em um filtro ou segmento dinâmico.

Nesta versão, as contas do Google Analytics Premium podem acessar até 50 variáveis personalizadas.

Nesta versão, corrigimos dois bugs:

Correções de bugs

  • Os filtros de consulta que contêm caracteres especiais dentro das expressões regulares não retornam mais erros de servidor.

  • Agora é possível combinar um filtro de métrica com um segmento avançado sem retornar um erro.

Nesta versão, adicionamos novas métricas de velocidade do site à API.

Novas métricas

  • Estas métricas de Velocidade do site foram adicionadas:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

Leia a referência das dimensões e métricas para ver as definições.

Lembrete sobre a descontinuação da versão 2.3 da API

  • A versão 2.3 da API Data Export está obsoleta há dois meses. Daqui a quatro meses, vamos encerrar esse serviço e oferecer suporte apenas à nova API Core Reporting versão 3.0 e versão 2.4.

  • Recomendamos que você migre seus aplicativos para a versão 3.0.

  • Em quatro meses, as solicitações para o feed de dados XML da versão 2.3 legada serão encaminhadas para a versão 2.4 e retornarão uma resposta XML correspondente. Depois disso, as políticas de cota da versão 2.4 serão aplicadas às solicitações da versão 2.3.

  • Todas as solicitações para o JSON da versão 2.3 ou a biblioteca de cliente JavaScript dos dados do Google que usa uma saída relacionada vão retornar os códigos de status 404.

  • Para receber a cota completa referente às versões 3.0 e 2.4, você precisará registrar seu aplicativo no Console de APIs do Google e usar uma chave de API ou um token OAuth 2.0 em cada solicitação.

Corrigimos um pequeno bug com ga:visitLength. Essa dimensão agora retorna os dados corretos.

Essa versão afeta todos os desenvolvedores de API do Google Analytics. Adicionamos duas novas versões da API, incluímos uma nova política de cota e muda,ps o nome da API para API Core Reporting. Agora também é necessário registrar os aplicativos. Por fim, a versão 2.3 da API Data Export existente será removida.

Versão 3.0

  • A versão 3.0 da API Core Reporting é a mais recente da nossa API e não é compatível com versões anteriores. Será preciso usar esta versão para todo o desenvolvimento futuro da API.

  • Novos recursos

  • Atualizações

    • Incluímos um novo URL para fazer solicitações: https://www.googleapis.com/analytics/v3/data/ga….
    • Os tokens de desenvolvedores e registro agora são obrigatórios.
    • Todas as solicitações de dados de configuração agora precisam ser feitas usando a API Management.

Versão 2.4

  • A versão 2.4 da API Core Reporting é um upgrade secundário que é, na maioria das vezes, compatível com versões anteriores da API Data Export 2.3.

  • Atualizações

    • Incluímos um novo URL para fazer solicitações: https://www.googleapis.com/analytics/v2.4/data….
    • Os tokens de desenvolvedores e registro agora são obrigatórios.
    • A saída XML agora é consistente com a versão 2.3, então, as outras bibliotecas de cliente de dados do Google continuarão funcionando.
    • O código de erro relacionado a cotas foi alterado de 503 para 403.
    • As respostas JSON deixaram de ser compatíveis.
    • A biblioteca de cliente JavaScript de dados do Google deixou de ser compatível.
    • Não haverá mais feed de conta. Todas as solicitações de dados de configuração agora precisam ser feitas usando a API Management.

Registro

  • Todos os aplicativos criados com a API Google Analytics precisam ser registrados como um projeto no Console de APIs do Google.

  • Cada solicitação precisa incluir uma chave de API ou um OAuth 2.0, um ID e uma chave secreta do cliente.

Política de cotas

  • A cota a seguir se aplica às APIs do Google Analytics (API Management e Data Export).

    • 50.000 solicitações por projeto por dia
    • 10 consultas por segundo (QPS) por endereço IP
  • A cota a seguir se aplica à API Data Export.

    • 10.000 solicitações por perfil por dia
    • 10 solicitações simultâneas por perfil
  • Para aplicativos não registrados, fornecemos uma cota de gratuidade muito baixa para acomodar uma pequena quantidade de testes.

Suspensões de uso

  • Nesta versão, também anunciamos a remoção da versão 2.3 e o encerramento futuro do feed de conta na API Data Export. Em 6 meses:

    • As solicitações para o feed de dados XML da versão 2.3 serão encaminhadas para a versão 2.4 e retornarão uma resposta correspondente. Depois disso, as políticas de cota da versão 2.4 serão aplicadas às solicitações da versão 2.3.

    • As solicitações para a saída JSON da versão 2.3 deixarão de ser compatíveis com a resposta da versão 2.4 e vão retornar códigos de status 404 Not Found. Se você precisar de uma resposta JSON, faça o upgrade para a versão 3.0.

    • As solicitações para o feed de conta na API Data Export retornarão códigos de status 404 Not Found. Todas as solicitações de dados de configuração agora precisam ser feitas usando a API Management.

Nesta versão, adicionamos novos dados do Google AdWords e mais combinações de dimensões e métricas.

  • Agora, os dados são atualizados em até uma hora. Antes, o processo ocorria uma vez ao dia.

  • Flexibilizamos diversas restrições de combinações válidas com os dados do Google AdWords.

Há algumas semanas, fizemos uma alteração para não permitir consultas da API que faziam solicitações de ga:adGroup ou ga:adContent com ga:impressions, já que essa combinação retornava 0. Agora, incluímos novamente a combinação e a corrigimos para retornar os dados certos.

Nesta versão, corrigimos algumas combinações inválidas de dimensões e métricas.

Correção de combinações de métricas/dimensões inválidas

  • No mês passado, anunciamos algumas alterações na API de forma a não permitir algumas consultas inválidas no feed de dados que não retornavam resultados. Agora aplicamos essas mudanças na API, e as seguintes combinações passaram a ser inválidas:

    • As dimensões do produto não podem ser combinadas com as métricas de transação.
    • ga:adContent ou ga:adGroup não podem ser combinados com ga:impressions.

    Em vez de retornar uma resposta sem resultados, a API agora retorna o código de erro 400 para todas as consultas que usam essas combinações.

Nesta versão, descontinuamos o valor do intervalo de confiança nas métricas.

Descontinuação do intervalo de confiança

  • Pare de usar os valores de intervalo de confiança nas métricas. Nesta versão, o feed de dados da API Data Export retorna 0.0 para todos esses valores. Em aproximadamente um mês, removeremos completamente esse atributo de todos os elementos de métrica.

    Para determinar se uma resposta é de amostra, use o campo containsSampledData nela.

Nesta versão, adicionamos três novas métricas e atualizamos a saída de duas.

Novas atualizações de dados

  • Adicionamos três novas métricas à API para lidar com o desempenho da velocidade do site:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

Atualizações de métricas

  • Para especificar valores de moedas nos filtros, defina o valor real extraído do código de acompanhamento (por exemplo, uma unidade agora vai ser especificada como 1).

  • O ga:CTR agora retorna a porcentagem real (por exemplo, o valor 2% será retornado como 2).

Nesta versão, melhoramos a performance do feed de dados e adicionamos novos dados:

Melhoria de desempenho

  • Nesta versão, melhoramos a latência do feed de dados de 30 para 35%.

Novas atualizações de dados

  • Atualizamos a lista de dimensões e métricas permitidas nos segmentos avançados. Veja a lista atualizada para garantir que suas solicitações sejam válidas.

Próximas alterações

  • No momento, é necessário especificar o valor de um filtro de moeda como microunidades (por exemplo, uma unidade de moeda é especificada como 1.000.000). No futuro, será necessário definir o valor real extraído do código de acompanhamento (por exemplo, uma unidade agora vai ser indicada como 1).

  • No momento, ga:CTR é um percent e retorna o valor 0,02. Em breve, isso mudará para a porcentagem real (por exemplo, 2).

Nesta versão, adicionamos mais dados ao feed de dados:

Novas atualizações de dados

  • Adicionamos esta dimensão de tempo: ga:dayOfWeek.

  • Adicionamos esta métrica de pesquisa interna: ga:percentVisitsWithSearch.

  • Incluímos as seguintes métricas de acompanhamento de eventos:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

Próximas alterações

Atualmente, a API mostra códigos de status 401 por vários problemas de autorização. Nas próximas semanas, o status 401 será usado exclusivamente para tokens inválidos, permitindo que os desenvolvedores lidem com essa exceção específica.

Nesta versão, adicionamos mais informações ao feed de dados:

Novas atualizações de dados

  • Mudamos o cálculo de ga:visitors para mostrar o número de visitantes únicos do período, e agora ele oferece suporte a mais combinações de dimensão e métrica.

  • Adicionamos 10 novas dimensões do Google AdWords: ga:adDistributionNetwork, ga:adMatchType, ga:adMatchedQuery, ga:adPlacementDomain, ga:adPlacementUrl, ga:adFormat, ga:adTargetingType, ga:adTargetingOption, ga:adDisplayUrl, ga:adDestinationUrl.

  • A métrica ga:organicSearches foi adicionada ao grupo de campanhas.

  • Adicionamos a métrica ga:searchResultViews ao grupo de pesquisa interna no site.

  • Foram adicionadas três novas dimensões com base em tempo: ga:nthDay, ga:nthWeek, ga:nthMonth.

  • Os agrupamentos de dimensões e métricas foram alterados para refletir melhor os recursos que eles representam.

Novas métricas calculadas

As métricas calculadas a seguir foram derivadas de cálculos que usam as métricas básicas. Observação: cada nome com (n) aceita valores de 1 a 20.

  • Com base em meta: ga:costPerConversion, ga:costPerGoalConversion, ga:costPerTransaction, ga:goal(n)AbandonRate, ga:goal(n)Abandons, ga:goal(n)ConversionRate, ga:goalAbandonRateAll, ga:goalAbandonsAll, ga:goalConversionRateAll, ga:goalValueAllPerSearch, ga:goalValuePerVisit.

  • Com base em conteúdo: ga:entranceBounceRate, ga:visitBounceRate, ga:entranceRate, ga:exitRate, ga:pageviewsPerVisit, ga:avgTimeOnPage, ga:avgTimeOnSite, ga:avgEventValue.

  • Com base em pesquisa interna no site: ga:avgSearchDepth, ga:avgSearchDuration, ga:avgSearchResultViews, ga:searchGoalConversionRateAll, ga:searchGoal(n)ConversionRate, ga:searchExitRate.

  • Com base em e-commerce: ga:itemsPerPurchase, ga:margin, ga:percentNewVisits, ga:revenuePerItem, ga:revenuePerTransaction, ga:ROI, ga:RPC, ga:totalValue, ga:transactionRevenuePerVisit, ga:transactionsPerVisit.

Nesta versão, adicionamos um novo recurso ao feed de dados:

Novos recursos

  • O novo elemento XML adicionado permite que os usuários saibam se os dados foram analisados por amostragem ( true. Esse elemento sempre mostrará se os dados foram analisados por amostragem ou não com true ou false. As bibliotecas Java e JavaScript também foram atualizadas com métodos auxiliares para acessar esse elemento.

Nesta versão, corrigimos dois bugs:

Correções de bugs

  • Anteriormente, adicionar um operador OR a uma expressão de filtro com uma dimensão (por exemplo, ga:keyword==store,ga:keyword==bar) poderia resultar em valores diferentes do que aqueles que seriam retornados se cada filtro fosse aplicado individualmente em várias consultas. Isso foi corrigido, e o uso do operador OR agora mostra valores consistentes.

  • Algumas mensagens de erro da API para filtros inválidos foram atualizadas para NÃO especificar se um filtro de dimensão ou métrica causou o erro, embora a expressão de filtro com falha real continue aparecendo.

Nesta versão, corrigimos três bugs:

Correções de bugs

  • Corrigimos um problema de codificação na biblioteca de cliente JavaScript. Rastreador de problemas do Google Analytics

  • Corrigimos um bug que retornava o feed de conta quando um nome, caminho, valor de comparação ou tipo de comparação de meta era definido incorretamente.

  • Não é possível usar OR em uma dimensão e métrica no parâmetro de filtro de consulta do feed de dados. Por exemplo, ga:source==google,ga:visits>5. A mensagem de erro para essa consulta inválida agora mostra o texto: Cannot OR dimension filter(s) with metric filter.

Nesta versão, adicionamos novos dados e corrigimos um bug:

Novos recursos

  • Adicionamos as cinco dimensões a seguir à nova categoria D8. Adwords:

    • ga:adwordsAdGroupId: corresponde ao AdGroup.id da API AdWords.
    • ga:adwordsCampaignId: corresponde ao Campaign.id da API AdWords.
    • ga:adwordsCreativeId: corresponde ao Ad.id da API AdWords.
    • ga:adwordsCriteriaId: corresponde ao Criterion.id da API AdWords.
    • ga:adwordsCustomerId: corresponde ao AccountInfo.customerId da API AdWords.

Correções de bugs

  • Corrigimos um problema em que o feed de conta não mostrava dados se um dos perfis tinha uma meta ou etapa configurada incorretamente.

Nesta versão, adicionamos vários novos recursos e corrigimos um bug:

Novos recursos

  • O segmento padrão do iPhone (gaid::-11) foi aprimorado para abordar todos os dispositivos móveis. O ID é o mesmo de antes (-11), mas o nome do segmento agora é: Mobile Traffic.

  • A taxa de amostragem usada pela API agora é igual à da interface da Web. Isso sincroniza os dados de relatórios de amostragem com a interface da Web e aumenta a consistência entre eles.

  • A política de cota foi atualizada para garantir que todos os usuários recebam acesso igualitário aos recursos. Consulte nossa documentação da política de cota para mais detalhes. A nova política é:

    • Uma única propriedade da Web pode fazer até 10.000 solicitações a cada 24 horas.
    • Um aplicativo pode fazer apenas 10 solicitações em um período de 1 segundo.
    • Um aplicativo pode ter apenas quatro solicitações pendentes a qualquer momento.
  • Algumas restrições de combinações de dimensão e métrica foram eliminadas. ga:nextPagePath e ga:previousPagePath agora fazem parte do grupo D3. Content. O grupo D8. Custom Variable agora é chamado de D6. Custom Variable. Consulte o guia de referência atualizado para conferir essas novas combinações.

Correções de bugs

  • Corrigimos um bug relacionado ao modo como a API informa o valor de confidenceInterval para métricas. Antigamente, os intervalos de confiança poderiam ter o valor igual a INF ou um número de zero a um. Agora todos os intervalos terão um valor INF ou um número maior ou igual a zero.

  • Os ga:itemQuantity e ga:uniquePurchases estavam trocados e mostravam o valor um do outro. Eles foram corrigidos para mostrar os dados corretos.

Lembrete sobre a descontinuação de dimensões e métricas

  • Pare de usar as dimensões e métricas já descontinuadas, se você ainda não tiver feito isso.

Nesta versão, adicionamos vários novos recursos:

Aumento do número da versão principal para 2

  • Alguns recursos precisam usar as bibliotecas de cliente mais recentes. Adicionamos suporte para Java e JavaScript. Talvez algumas bibliotecas de terceiros ainda não tenham sido atualizadas.

    • A versão 2 pode ser solicitada adicionando o cabeçalho GData-Version: 2 a cada conta ou solicitação de feed de dados. Leia a documentação para mais detalhes.
    • Um novo namespace XML foi adicionado aos feeds de conta e de dados:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • Agora a API é compatível com o protocolo de dados do Google versão 2.

Suporte para segmentação avançada

  • Parâmetro de consulta de segmentos dinâmicos:

    • ...&segment=dynamic::expressão
    • Permite a criação de segmentos avançados "imediatamente".
    • O parâmetro de expressão pode ser qualquer dimensão ou métrica e precisa seguir a mesma sintaxe dos filtros.
  • Parâmetro de consulta de segmentos padrão e personalizados:

    • ...&segment=gaid::número
    • Em que o número é um ID que faz referência a um segmento avançado definido na interface da Web do Google Analytics.
    • O ID pode ser encontrado no feed de conta.
  • O feed de conta descreve os dados de segmento usando os seguintes elementos e atributos XML:

    • ga:visitorType==Returning Visitor
  • O feed de dados também fornece um elemento XML que indica se um segmento foi aplicado na solicitação de API.

  • Veja mais detalhes sobre os segmentos avançados na nossa documentação.

Novos dados de meta disponíveis

  • As metas de destino e engajamento estão disponíveis no feed da conta:

  • Foram adicionadas 48 novas métricas de meta para as metas de 5 a 20, e todas seguem a convenção goal(n)Completions, em que (n) é um número entre 1 e 20.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value
  • GoalCompletionAll, GoalStartsAll e GoalValueAll foram atualizados na conta para os novos dados de meta.

Novos dados de variável personalizada

  • Todas as variáveis personalizadas já coletadas por todos os perfis foram adicionadas como um novo elemento XML ao feed de conta:

  • Foram adicionadas 10 novas dimensões para variáveis personalizadas, que seguem a convenção customVar(n), em que (n) pode ser um número entre 1 e 5.

    • ga:customVarName(n)
    • ga:customVarValue(n)

Dimensões e métricas descontinuadas devem ser removidas.

  • Pare de usar as dimensões e métricas obsoletas se você ainda não tiver feito isso. Elas serão removidas em breve, e nossa API vai mostrar um erro para sua solicitação.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • As dimensões a seguir foram renomeadas:

    • ga:countOfVisits agora é ga:visitCount.
    • ga:countOfVisitsToATransaction agora é ga:visitsToTransaction.

Nesta versão, adicionamos novos recursos e descontinuamos algumas funções antigas:

  • As dimensões e métricas a seguir foram descontinuadas e vão ser removidas permanentemente da API em um mês. Atualize seu código para que os aplicativos não deixem de funcionar:

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • As dimensões a seguir foram renomeadas:

    • ga:countOfVisits agora é ga:visitCount
    • ga:countOfVisitsToATransaction agora é ga:visitsToTransaction
  • Todos os dados de acompanhamento de eventos agora são expostos como dois novos grupos:

    D7. Eventos (Dimensões) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. Eventos (Métricas) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

  • Os dados de navegação geral do site agora são indicados pelas seguintes dimensões:

    D6. Navegação * ga:previousPagePath * ga:nextPagePath

  • A navegação nas páginas de destino agora é exposta pelas seguintes dimensões:

    D3. Conteúdo * ga:landingPagePath * ga:secondPagePath

  • O comprimento máximo das expressões regulares no parâmetro de consulta de filtros do feed de dados aumentou de 32 para 128 caracteres.

  • O relatório Duração da visita (disponível na IU em "Visitantes" -> "Lealdade do visitante") agora é indicado pela nova dimensão:

    • ga:visitLength

Nesta versão, atualizamos a API Data Export do Google Analytics:

  • Algumas restrições de combinações de dimensão e métrica foram eliminadas. Você pode consultar mais dimensões no nível do conteúdo e do visitante ao mesmo tempo, por exemplo, ga:pagePath e ga:source agora são uma combinação válida. Consulte o guia de referência atualizado para mais detalhes sobre essas novas combinações: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • O número total de linhas que podem ser usadas em uma solicitação foi aumentado para 10.000. O número padrão de linhas mostradas ainda é 1.000, mas agora você pode aumentá-lo definindo o parâmetro de consulta max-results.

  • O feed de conta agora mostra dois novos elementos de dados para cada ID de tabela (moeda e fuso horário).

  • As consultas de dados agora precisam incluir pelo menos uma métrica válida.

  • Todas as mudanças de descontinuação anteriores entraram em vigor.

Nesta versão, removemos os recursos descontinuados da versão Beta particular:

  • As solicitações do feed de conta não oferecerão mais suporte a um nome de usuário. Serão aceitas apenas solicitações neste formato:
    https://www.google.com/analytics/feeds/accounts/default

  • As métricas a seguir estão sendo removidas e não funcionarão mais. Em vez delas, use os valores mostrados neste link: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:abandonedFunnels1
    • ga:abandonedFunnels2
    • ga:abandonedFunnels3
    • ga:abandonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • As dimensões e métricas a seguir foram renomeadas. Os nomes antigos não funcionarão mais. Verifique se você está usando os nomes oficiais na nossa documentação: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    Dimensões * ga:subContinentRegion ⇒ ga:subContinent * ga:organization ⇒ ga:networkLocation * ga:domain ⇒ ga:networkDomain * ga:visitNumber ⇒ ga:countOfVisits * ga:platform ⇒ ga:operatingSystem * ga:platformVersion ⇒ ga:operatingSystemVersion * ga:content ⇒ ga:adContent * ga:requestUri ⇒ ga:pagePath * ga:requestUri1 ⇒ ga:landingPagePath * ga:requestUriLast ⇒ ga:exitPagePath * ga:internalSearchNext ⇒ ga:searchKeywordRefinement * ga:internalSearchKeyword ⇒ ga:searchKeyword * ga:internalSearchType ⇒ ga:searchCategory * ga:hasInternalSearch ⇒ ga:searchUsed * ga:requestUriFrom ⇒ ga:searchStartPage * ga:requestUriTo ⇒ ga:searchDestinationPage * ga:productCode ⇒ ga:productSku

    Métricas * ga:newVisitors ⇒ ga:newVisits * ga:pageDuration ⇒ ga:timeOnPage * ga:visitDuration ⇒ ga:timeOnSite * ga:cost ⇒ ga:adCost * ga:clicks ⇒ ga:adClicks * ga:clickThroughRate ⇒ ga:CTR * ga:costPerClick ⇒ ga:CPC * ga:costPerMilleImpressions ⇒ ga:CPM * ga:searchTransitions ⇒ ga:searchRefinements * ga:uniqueInternalSearches ⇒ ga:searchUniques * ga:visitsWithSearches ⇒ ga:searchVisits * ga:productPurchases ⇒ ga:itemQuantity * ga:productRevenue ⇒ ga:itemRevenue * ga:products ⇒ ga:uniquePurchases * ga:revenue ⇒ ga:transactionRevenue * ga:shipping ⇒ ga:transactionShipping * ga:tax ⇒ ga:transactionTax * ga:goalCompletions1 ⇒ ga:goal1Completions * ga:goalCompletions2 ⇒ ga:goal2Completions * ga:goalCompletions3 ⇒ ga:goal3Completions * ga:goalCompletions4 ⇒ ga:goal4Completions * ga:goalStarts1 ⇒ ga:goal1Starts * ga:goalStarts2 ⇒ ga:goal2Starts * ga:goalStarts3 ⇒ ga:goal3Starts * ga:goalStarts4 ⇒ ga:goal4Starts * ga:goalValue1 ⇒ ga:goal1Value * ga:goalValue2 ⇒ ga:goal2Value * ga:goalValue3 ⇒ ga:goal3Value * ga:goalValue4 ⇒ ga:goal4Value