Google Analytics – Todos os registros de alterações das APIs

Esta página documenta todas as mudanças feitas nas APIs e SDKs do Google Analytics. Ela inclui os registros de todas as APIs de coleta, relatórios e configuração. Recomendamos que você consulte regularmente esta lista para se manter informado 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.

Esta é a versão inicial da API User Activity

  • A API User Activity permite recuperar todos os dados associados a um único ID do cliente ou User ID em um determinado período. O objetivo principal é oferecer suporte aos proprietários que gostariam de conceder acesso automatizado às informações de um usuário diretamente a ele. Acesse o guia da API User Activity para mais detalhes.

Configurações de retenção de dados do usuário na API Management

Agora é possível definir programaticamente as configurações de retenção de dados do usuário usando os novos campos "dataRetentionTtl" e "dataRetentionResetOnNewActivity" no recurso WebProperty.

Esta é a versão inicial da API User Deletion:

  • A API User Deletion permite que um cliente do Google Analytics exclua dados de um determinado usuário final de um projeto ou de uma propriedade da Web. As solicitações de remoção de usuários podem ser feitas em projetos do Firebase ou propriedades do Google Analytics. Acesse a visão geral da API User Deletion para mais detalhes.

Operações de gravação na API Management

As operações de gravação na API Management (por exemplo, "create", "update", "delete", "patch") para os recursos de propriedade da Web, vista (perfil) e meta não exigem mais autorização. O limite diário padrão para todas as operações desse tipo na API Management é de 50 gravações. Consulte a página Limites e cotas para mais informações.

Nesta versão, alteramos as cotas e limites da API Real Time do Google Analytics.

As operações da API Real Time Reporting do Google Analytics tinham um limite de 10.000 chamadas diárias por vista (perfil), que também incluíam as outras chamadas de API do Analytics. Agora, elas são contabilizadas separadamente, o que significa que é possível fazer 10.000 chamadas por vista (perfil) em cada dia usando a API Real Time Reporting do Analytics E outras 10.000 por vista (perfil) com outras APIs do Google Analytics. Consulte a página Limites e cotas para mais informações.

Essa alteração oferece uma abordagem mais granular e segura para gerenciar cotas. Assim, chamadas frequentes que usam a API Real Time Reporting do Analytics não bloqueiam acidentalmente todas as outras chamadas de API do Google Analytics pelo restante do dia em um perfil.

Essa versão aumenta o número máximo de linhas retornadas no conjunto de resultados da API Reporting v4 do 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 visualização 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).

Os URLs "android-app://" foram adicionados como uma origem de referência válida.

Nesta versão, adicionamos a nova tarefa customTask.

Nesta versão, o uso do recurso produtos relacionados e das dimensões e métricas associadas foi suspenso. Leia a referência das dimensões e métricas para ver 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 obsoletas. Leia a política de suspensão de uso de dados das APIs do Google Analytics para entender o processo de remoção de dados.

Hora

  • 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 contabilizar os usuários de forma 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 de 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 suspensão de uso 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 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 – Para qualquer usuário, a dimensão "Grupo de usuários" (valores de 1 a 100) indica o grupo a que 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 AdSense nas vistas não associadas ao Google AdSense. Se você fizer isso, um erro será exibido.

Métricas personalizadas

Nesta versão, corrigimos o bug que causava uma falha na criação de métricas personalizadas do tipo TIME quando min_value não era definido. As solicitações sem min_value agora geram uma métrica personalizada com um min_value padrão igual a 0.

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á exibido.

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 solicitada, em que refere-se ao nome definido pelo usuário para essa métrica. 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, deixaremos de utilizar a métrica ga:uniqueEvents atual de acordo com nossa política de suspensão de uso 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 de suspensão de uso adequado de aproximadamente seis meses, essa métrica ga:uniqueEventsTemporary será removida, e a original ga:uniqueEvents 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 mudará em breve para refletir o número de eventos únicos com mais precisão. 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 contabilizam o número de combinações de dimensões e valores únicas para cada dimensão 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.

Novidades desta versão:

Google Analytics

  • Agora há compatibilidade com o iOS 10, e alguns bugs foram corrigidos.

Novidades desta versão:

Google Analytics

  • Corrigimos algumas falhas.

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 – Código 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 – Código 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 veiculaçã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 – Código do pedido de veiculaçã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: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 exibido e clicado para o clique DBM correspondente à sessão do Google Analytics (somente Analytics 360, requer integração com o DBM).
  • Dimensão ga:dbmClickSiteId – Código do site do DBM em que o criativo dessa plataforma foi exibido 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 do último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) associado à sessão do Google Analytics (somente Analytics 360, requer integração com o DBM).
  • Dimensão ga:dbmLastEventAdvertiserId – Código do anunciante do DBM do último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) associado à sessão do Google Analytics (somente Analytics 360, requer integração com o DBM).
  • Dimensão ga:dbmLastEventCreativeId – ID do criativo do DBM do último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) associado à sessão do Google Analytics (somente Analytics 360, requer integração com o DBM).
  • Dimensão ga:dbmLastEventExchange – Nome da troca do DBM do último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) associado à sessão do Google Analytics (somente Analytics 360, requer integração com o DBM).
  • Dimensão ga:dbmLastEventExchangeId – Código da troca do DBM do último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) associado à sessão do Google Analytics (somente Analytics 360, requer integração com o DBM).
  • Dimensão ga:dbmLastEventInsertionOrder – Nome do pedido de veiculação do DBM do último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) associado à sessão do Google Analytics (somente Analytics 360, requer integração com o DBM).
  • Dimensão ga:dbmLastEventInsertionOrderId – Código do pedido de veiculação do DBM do último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) 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 do último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) associado à sessão do Google Analytics (somente Analytics 360, requer integração com o DBM).
  • Dimensão ga:dbmLastEventLineItemId – Código do item de linha do DBM do último evento dessa plataforma (impressão ou clique na janela de lookback do DBM) 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 exibido e clicado para o último evento do DBM (na janela de lookback) associado à sessão do Google Analytics (somente Analytics 360, requer integração com o DBM).
  • Dimensão ga:dbmLastEventSiteId – Código do site do DBM em que o criativo dessa plataforma foi exibido e clicado para o último evento do DBM (na janela de lookback) 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 – Código 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 – Código 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 – Código 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. Leia a referência das dimensões e métricas para ver todas as definições.

Código da transação

  • Dimensão mcf:transactionId – Código da transação informado pelo método de Acompanhamento de comércio eletrônico para a compra no carrinho.

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 – Código do continente dos usuários, derivado dos endereços IP ou dos códigos das regiões 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, por perfil e por hora
  • 50 solicitações com falha por projeto, por perfil e por dia

Limites de tabela dinâmica

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

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) de origem do tráfego, derivado dos endereços IP dos usuários ou dos códigos de regiões geográficas.

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 visualizada uma vez, exibiremos 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 de anúncios 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 Google 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 visualizada ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:dfpClicks – Número de vezes que os anúncios do DFP foram clicados 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 – Receita do DFP é uma estimativa da receita de anúncio 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. Essa métrica 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 – As impressões de preenchimento são a soma de todas as impressões de anúncios do Google AdSense ou Ad Exchance 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 visualizada uma vez, exibiremos 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, essa 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 – Calcula o número total de visualizações de página na propriedade que foram exibidas 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 – A proporção de impressões de anúncios de preenchimento para sessões do Google Analytics (impressões de anúncios / sessões do Google Analytics). Se o Google AdSense e o Ad Exchange oferecerem anúncios de preenchimento, essa métrica será a soma das duas contas de preenchimento ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:backfillViewableImpressionsPercent – A porcentagem de impressões de anúncios de preenchimento que estavam visíveis. Uma impressão será considerada visível quando tiver sido exibida nos navegadores dos usuários, podendo ser vista. Se o Google AdSense e o Ad Exchange oferecerem anúncios desse tipo, essa métrica 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 – O número de cliques nos anúncios de preenchimento no site. Se o Google AdSense e o Ad Exchange oferecerem anúncios desse tipo, essa métrica será a soma das duas contas de preenchimento ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:backfillCTR – A 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 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 – A receita total estimada dos anúncios de preenchimento. Se o Google AdSense e o Ad Exchange oferecerem anúncios desse tipo, essa métrica será a soma das duas contas de preenchimento ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).
  • Métrica ga:backfillRevenuePer1000Sessions – A 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, essa métrica 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, essa métrica será a soma das duas contas de preenchimento ("Vinculação do DFP" ativada e "Ocultar receita do DFP" desativada).

Nesta versão, adicionamos um novo atributo addedInApiVersion.

Adição à versão da API

  • O addedInApiVersion é um atributo numérico que verifica se uma coluna pode ser usada na API Reporting de uma versão específica. Consulte API Metadata: guia do desenvolvedor para mais detalhes.

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 coorte e valor da vida útil.
  • Vários segmentos: agora você pode solicitar vários segmentos em uma única solicitação.

Primeiros passos

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 alterações.

Migração

Além do guia de migração, também disponibilizamos uma biblioteca de compatibilidade do Python no GitHub.

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 do 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 de tráfego é computado com base nas regras padrão de agrupamento de canais (no nível da vista, se disponível) no momento da 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 – Essa métrica é 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 no coorte que estão ativos na janela correspondente ao 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, essa 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 um coorte.

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

  • Métrica ga:cohortRetentionRate – Taxa de retenção do 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 nos coortes que foram adquiridos por meio do canal, da origem, da mídia ou da 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 – Exibições do app por usuário para a dimensão de aquisição em um coorte.

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

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

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

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

As dimensões e métricas do hub de dados de redes sociais deixaram de ser utilizadas e só irão gerar relatórios sobre dados históricos a partir de 30 de abril de 2016. Depois disso, novas informações não serão mais exibidas. De acordo com a política de suspensão de uso 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 deixaram de ser utilizadas e serão removidas após 30 de setembro de 2016. Consulte a política de suspensão de uso de dados para ver detalhes sobre a remoção de informações:

  • Dimensão ga:socialActivityEndorsingUrl – Em uma atividade do hub de dados de redes sociais, essa dimensão representa o URL da atividade em redes sociais (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, essa dimensão representa o título da atividade em redes sociais postada pelos usuários.
  • Dimensão ga:socialActivityPost – Em uma atividade do hub de dados de redes sociais, essa dimensão representa o conteúdo da atividade em redes sociais, por exemplo, o conteúdo de uma mensagem postada no Google+ pelos usuários.
  • Dimensão ga:socialActivityTimestamp – Em uma atividade do hub de dados de redes sociais, essa dimensão representa o momento em que a atividade ocorreu.
  • Dimensão ga:socialActivityUserHandle – Em uma atividade do hub de dados de redes sociais, essa dimensão representa o identificador da rede social (por exemplo, nome ou código) de usuários que iniciaram a atividade.
  • Dimensão ga:socialActivityUserPhotoUrl – Em uma atividade do hub de dados de redes sociais, essa dimensão representa o URL da foto associada aos perfis de rede social dos usuários.
  • Dimensão ga:socialActivityUserProfileUrl – Em uma atividade do hub de dados de redes sociais, essa dimensão representa o URL dos perfis dos usuários associados.
  • Dimensão ga:socialActivityTagsSummary – Em uma atividade do hub de dados de redes sociais, essa dimensão representa um conjunto de tags separadas por vírgula associadas à atividade em redes sociais.
  • Dimensão ga:socialActivityAction – Em uma atividade do hub de dados de redes sociais, essa dimensão representa o tipo de atividade em redes sociais (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, essa dimensão representa o tipo de atividade em redes sociais e a origem dela.
  • Dimensão ga:socialActivityContentUrl – Em uma atividade do hub de dados de redes sociais, essa dimensão representa o URL compartilhado pelos usuários da rede social associada.
  • 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 é uma dimensão no escopo da sessão que 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.

Relatórios sem dados de amostra

A API Unsampled Reports não tem mais um limite de 100 relatórios por dia. A API usa o mesmo sistema de token por propriedade e por dia que a interface da Web utiliza para criar um relatório sem dados de amostra.

Relatórios sem dados de amostra

Os relatórios sem dados de amostra que não são acessíveis ao usuário atual não terão mais um link de download na mensagem de resposta da API Management. Isso é condizente com o painel de IU, em que apenas os proprietários dos relatórios podem ver o link de download do documento gerado.

Novidades desta versão:

Google Analytics

  • Não houve alterações.

Gerenciador de tags do Google

  • Corrigimos um problema que causava uma falha ao executar os testes de unidade.

Segmentos

Nesta versão, corrigimos um bug em que os segmentos com valores de moeda na definição apareciam incorretamente ao chamar o método de lista de segmentos.

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

Incluir linhas vazias

  • Nesta versão, adicionamos o novo parâmetro opcional include-empty-rows, que, quando é 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 de referência da API Core Reporting para mais detalhes.

Novidades desta versão:

Google Analytics

  • Agora é possível usar bitcode.

Gerenciador de tags do Google

  • Agora é possível usar bitcode.

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.

Segmentos

Nesta versão, corrigimos um bug em que os usuários com segmentos privados fixados em várias vistas (perfis) recebiam uma resposta de erro 500 ao chamar o método de lista de segmentos.

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 de anúncios 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 de anúncio do AdX é registrada sempre que um anúncio individual é exibido no seu site. Por exemplo, se uma página com dois blocos for visualizada uma vez, exibiremos duas impressões.
  • Métrica ga:adxImpressionsPerSession – 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, adicionamos outro parâmetro ao URL dos TOS da API Provisioning:

  • A adição do parâmetro de URL provisioningSignup=false corrige um problema que ocorre durante o provisionamento de uma conta do Google Analytics para um usuário que não tem uma conta desse produto. Os desenvolvedores precisam atualizar o código para incluir esse parâmetro no URL dos TOS.

Lotes

Nesta versão, além do suporte geral a lotes, adicionamos compatibilidade especial à API User Permissions. As solicitações de permissões de usuário em lote terão melhorias significativas de desempenho e redução no uso de cota.

Vistas (perfis)

Com essa versão, a propriedade currency da vista (perfil) passará a usar USD se esse valor não for definido durante uma operação de inserção. Além disso, as operações get e list retornarão USD em vistas (perfis) que foram criadas anteriormente sem uma propriedade currency.

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

Dimensões com uso suspenso

As seguintes dimensões estão obsoletas. Consulte a política de suspensão de uso de dados para ver detalhes sobre a remoção de informações:

  • 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.

Novidades desta versão:

Google Analytics

  • Corrigimos um problema que causava falhas ao usar o comando setCampaignParametersFromUrl. Consulte o Issue 636.

Gerenciador de tags do Google

  • Não houve alterações.

Filtros

Nesta versão, removemos os campos de filtro obsoletos IS_MOBILE e IS_TABLET, que serão substituídos por DEVICE_CATEGORY=mobile e DEVICE_CATEGORY=tablet. Solicitações de inserção, atualização e correção que usarem IS_MOBILE e IS_TABLET nos campos de filtro retornarão um erro.

Novidades desta versão:

Google Analytics

  • Não houve alterações.

Gerenciador de tags do Google

  • Corrigimos um conflito entre nomes de classe. Consulte o Issue 631.

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.

Filtros

Nesta versão, adicionamos suporte para uso de uma dimensão personalizada em um campo de filtro ao incluir uma propriedade fieldIndex em todas as seções de detalhes dele. Por exemplo, agora é possível definir a expressão com "field": "CUSTOM_DIMENSION" e "fieldIndex": "1" para que o filtro funcione na primeira dimensão personalizada.

Metas

Nesta versão, também corrigimos uma falha que aparecia ao criar uma meta com "comparisonValue": "0".

Novidades desta versão:

Google Analytics

  • Agora é possível fazer envios em segundo plano em dispositivos que não usam o Google Play.
  • O Logger/LogLevel do Google Analytics deixou de ser usado. Agora, o Analytics utiliza a geração de registros do Android. Para ativar os registros de depuração, execute adb shell setprop log.tag.GAv4 DEBUG.
  • Aplicamos uma refatoração para otimizar a entrega de dados e a atribuição de campanhas de instalação.
  • Corrigimos o bug na análise de campanhas. Problema 596.
  • Agora é possível informar corretamente as exceções de apps não gerenciadas durante os primeiros segundos da inicialização do Google Analytics. Consulte o Issue 443.

Gerenciador de tags do Google

  • Não houve alterações.

Novidades desta versão:

Google Analytics

  • Agora você pode informar a resolução da tela usando o nativeBounds no iOS 8.0 e nas versões mais recentes. Isso resolve o Issue 504.
  • Agora é possível utilizar parâmetros de campanha relacionados a cliques.
  • Você já pode informar o modelo de hardware do iOS e a versão do SO do dispositivo. Isso resolve o Issue 408.
  • Já é possível informar a atribuição de instalação do iAd no iOS 7.1 e nas versões mais recentes. Isso exige a estrutura do iAd.
  • Incluímos um aviso sobre a desativação do tipo de hit "appview".
  • O SQLite3 passou a ser uma biblioteca obrigatória.

Gerenciador de tags do Google

  • Corrigimos um erro de string nula no TAGDispatcher.

Nesta versão, adicionamos um novo campo. Consulte a referência de campos para ver a lista completa.

Transporte

  • O campo transporte permite definir o mecanismo com que os hits serão enviados.

Outras alterações

  • A opção useBeacon teve o uso suspenso.
  • Alguns bugs foram corrigidos.

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 da ga.js e da 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 modificados.
  • Dimensão ga:searchAfterDestinationPage – página que o usuário visitou depois de realizar uma pesquisa interna no seu site.

Nesta versão, corrigimos um bug.

Nesta versão, adicionamos um novo parâmetro de hit. Consulte a referência de parâmetros para ver a lista completa.

Fonte de dados

  • O parâmetro Fonte de dados ds permite definir a fonte de dados de um hit.

Nesta versão, adicionamos um novo campo. Consulte a referência de campos para ver a lista completa.

Fonte de dados

Nesta versão, adicionamos um novo parâmetro de hit. Consulte a referência de parâmetros para ver a lista completa.

Modificação geográfica

Nesta versão, adicionamos novas dimensões e métricas à 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.

Comércio eletrônico

  • 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 gerada na transação, excluindo frete e impostos, 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 – Códigos de cidade dos usuários derivados dos endereços IP ou dos códigos de regiões 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 – Código de região dos usuários derivado dos endereços IP ou dos códigos de regiões 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 de uso suspenso

Essas métricas tiveram o uso suspenso. Consulte a política de suspensão de uso de dados para ver detalhes sobre a remoção das informações: + Métrica ga:dcmROI – Use ga:dcmROAS. + Métrica ga:dcmMargen – use ga:dcmROAS.

A resposta do método list para todos os conjuntos agora inclui uma lista vazia para a propriedade items quando a coleção não contém recursos. Anteriormente, a propriedade items seria omitida. Consulte a Referência da API para ver detalhes sobre consultas e respostas dos dados de configuração do Google Analytics.

Nesta versão, adicionamos um novo escopo à API Google Analytics Management. analytics.manage.users.readonly – veja as permissões de usuário do Google Analytics

Adicionamos um novo campo de filtros DEVICE_CATEGORY, e o uso de IS_MOBILE e IS_TABLET foram suspensos. Use DEVICE_CATEGORY=mobile e DEVICE_CATEGORY=tablet.

Novidades desta versão:

Google Analytics

  • Corrigimos um problema em que nenhum beacon era enviado quando o usuário tentava realizar essa ação.
  • O aplicativo de exemplo CuteAnimals foi atualizado para demonstrar como fazer envios quando o app fica em segundo plano.
  • Foram disponibilizados mais campos de comércio eletrônico avançado.
  • Removemos as mensagens de aviso sobre a ausência das classes GAIHit e GAIProperty ao compilar seu aplicativo no SDK do iOS 8.0. Essas classes foram excluídas.
  • O envio de beacons passou a ser mais eficiente. Vários deles são enviados em uma única solicitação HTTPS.
  • As solicitações serão compactadas para usar menos dados em determinadas circunstâncias.

Gerenciador de tags do Google

  • Desativamos o openContainerWithId com base no TAGContainerFuture. Se você usar essa API no iOS 8, serão exibidos erros quando o método "get" for chamado em algumas fases do ciclo de vida do UIAppDelegate.
  • Agora é possível utilizar métricas e dimensões personalizadas para comércio eletrônico avançado na tag do Google Universal Analytics.
  • Corrigimos um bug em que algumas ações de comércio eletrônico avançado que deveriam ter definições de produto opcionais continham definições obrigatórias.
  • Você já pode usar recursos do código de publicidade na tag do Google Universal Analytics.
  • O aplicativo de amostra CuteAnimals foi atualizado para demonstrar como enviar dados quando o app fica em segundo plano.

O recurso Vista (Perfil) agora inclui uma propriedade enhancedECommerceTracking que indica se o comércio eletrônico avançado está ativado (true) ou desativado (false).

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.

Google 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 de uso suspenso

Essas dimensões e métricas tiveram o uso suspenso. Consulte a política de suspensão de uso de dados para ver detalhes sobre a remoção das informações: + Métrica ga:ROI – Use ga:ROAS. + Métrica ga:margin – use ga:ROAS.

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

Hora

  • Dimensão rt:minutesAgo – há quantos minutos ocorreu um hit.

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

Google 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.

Novidades desta versão:

Google Analytics

  • Alguns pequenos bugs foram corrigidos.

Gerenciador de tags do Google

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.

Caminhos de conversão

  • Dimensão mcf:dcmAd – Nome do anúncio do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmAdPath – Caminho até a conversão em que as interações são representadas pelos anúncios do DCM.
  • Dimensão mcf:dcmAdType – Nome do tipo de anúncio do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmAdvertiser – Nome do anunciante do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmAdvertiserPath – Caminho até a conversão em que as interações são representadas pelos anunciantes do DCM.
  • Dimensão mcf:dcmCampaign – Nome da campanha do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmCampaignPath – Caminho até a conversão em que as interações são representadas pelas campanhas do DCM.
  • Dimensão mcf:dcmCreative – Nome do criativo do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmCreativePath – Caminho até a conversão em que as interações são representadas pelos criativos do DCM.
  • Dimensão mcf:dcmCreativeVersion – Versão do criativo do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmCreativeVersionPath – Caminho até a conversão em que as interações são representadas pelas versões do criativo do DCM.
  • Dimensão mcf:dcmNetwork – Rede usada.
  • Dimensão mcf:dcmPlacement – Nome do canal do site do DCM do evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmPlacementPath – Caminho até a conversão em que as interações são representadas pelos canais do DCM.
  • Dimensão mcf:dcmSite – Nome do site do DCM em que o criativo foi exibido no evento (impressão ou clique) correspondente à conversão do Google Analytics.
  • Dimensão mcf:dcmSitePath – Caminho até a conversão em que as interações são representadas pelos sites do DCM.
  • Métrica mcf:firstImpressionConversions – Número de conversões em que uma impressão de campanha do DCM foi a primeira interação em uma janela de lookback de 30 dias. Essa dimensão inclui conclusões de meta e transações.
  • Métrica mcf:firstImpressionValue – Valor das conversões em que uma impressão de campanha do DCM foi a primeira interação em uma janela de lookback de 30 dias. Essa dimensão inclui conclusões de meta e transações.
  • Métrica mcf:impressionAssistedConversions – Número de conversões em que uma impressão de campanha do DCM apareceu no caminho de conversão, mas não foi a interação final. Essa dimensão inclui conclusões de meta e transações.
  • Métrica mcf:impressionAssistedValue – Valor das conversões em que uma impressão de campanha do DCM apareceu no caminho de conversão, mas não foi a interação final. Essa dimensão inclui conclusões de meta e transações.

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. Essa métrica 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 – Código 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 – Código 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 – Código 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 – Código 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 exibido 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 exibido 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 – Código do canal do site do DCM do clique correspondente à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmClickSpotId – Código 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 – Código 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: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 – Código da renderização 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:dcmLastEventSite – Nome do site em que o criativo do DCM foi exibido e clicado no último evento (impressão ou clique na janela de lookback) desse produto associado à sessão do Google Analytics (somente premium).
  • Dimensão ga:dcmLastEventSiteId – Código do site do DCM em que o criativo foi exibido e clicado no último evento (impressão ou clique na janela de lookback) desse produto associado à 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).

Novidades desta versão:

Google Analytics

  • Não houve alterações.

Gerenciador de tags do Google

  • Agora é possível usar o comércio eletrônico avançado na tag do Google Universal Analytics.
  • Os novos métodos dispatch e dispatchWithCompletionHandler foram adicionados à classe TAGManager.

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 depois de outro grupo de conteúdo.
  • Dimensão ga:contentGroupXX – Grupo de conteúdo em uma propriedade. Um grupo de conteúdo é um conjunto de conteúdo que fornece 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 antes de outro grupo de conteúdo.
  • 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.

Novidades desta versão:

Google Analytics

  • Agora é possível usar o comércio eletrônico avançado. Para mais detalhes, consulte o guia do desenvolvedor sobre esse recurso.
  • Agora, o ID do cliente será redefinido sempre que o código de publicidade for alterado.
  • Por padrão, a coleta do código de publicidade ficará desativada.
  • Foram adicionadas APIs programáticas para gerar relatórios de exceções.
  • Corrigimos alguns bugs na documentação.
  • Alguns pequenos bugs foram corrigidos.

Gerenciador de tags do Google

  • Não houve alterações no Gerenciador de tags do Google.

Novidades desta versão:

Google Analytics

  • O SDK passará a coletar o IDFA e a sinalização de acompanhamento de publicidade ativado se a biblioteca libAdIdAccess.a (inclusa como parte do SDK) estiver presente no aplicativo e a propriedade allowIDFACollection estiver definida como "true" no rastreador.
  • Agora é possível usar o comércio eletrônico avançado.
  • O tipo de hit "screenview" agora é utilizado no lugar de "appview".
  • Passamos a adicionar um parâmetro de código a cada hit. Esse parâmetro é alterado sempre que um hit "appview", "screenview" ou "pageview" é gerado.
  • O ClientId agora é redefinido toda vez que o valor do IDFA é modificado. Isso só acontece quando o IDFA é coletado em um rastreador.
  • Um novo método dispatchWithCompletionHandler foi adicionado à classe GAI.
  • Corrigimos um problema em que o SDK podia enviar um beacon sem um clientId ou com essa opção em branco.

Gerenciador de tags do Google

  • Não houve alterações.
  • Os hits que não contêm um ID de acompanhamento válido agora são descartados.

Nesta versão, incluímos novos tipos de importação de dados e removemos o recurso dailyUpload.

Importação de dados

Consulte o guia do desenvolvedor sobre importação de dados e veja como usar a API Management para importar dados para sua conta do Google Analytics.

Uploads

  • O recurso upload agora aceita os seguintes tipos de upload:
    • Dados da campanha
    • Dados de conteúdo
    • Dados de custo
    • Dados do produto
    • Dados de reembolso
    • Dados do usuário
  • O recurso upload tem um novo método migrateDataImport para migrar os dados de custo customDataSources existentes.

Remoção dos uploads diários

  • Removemos o recurso dailyUpload. Consulte o guia de migração para ver detalhes sobre como usar o recurso de importação de dados.
  • O recurso dailyUpload continuará funcionando por mais seis meses. Depois disso, as customDataSources que ainda tiverem a propriedade uploadType definida como analytics#dailyUploads serão migradas automaticamente e funcionarão somente com o recurso upload.
  • Os usuários atuais de dailyUpload precisarão atualizar o código e migrar para o recurso de upload o mais rápido possível.

Nesta versão, incluímos uma nova condição dateOfSession nos segmentos e adicionamos novas dimensões e métricas de comércio eletrônico 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 do desenvolvedor sobre segmentos para ver mais detalhes.

Dimensões e métricas

Leia a referência das dimensões e métricas para ver todas as definições de comércio eletrônico avançado.

Comércio eletrônico 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 (comércio eletrônico 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 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ários estágios 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úmero de cliques / número de vezes que a promoção foi exibida).
  • 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 visualizaram 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 produto 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 do produto.
  • 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 que foram 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 – Código 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 consultado.
  • 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, alteramos a convenção de nomenclatura do atributo uiName.

Alteração de uiName

  • O atributo uiName para colunas com modelos agora usa XX para representar o índice numérico em vez de 1. Por exemplo, Goal 1 Value agora é Goal XX Value.

Esta é a versão inicial da API Embed:

  • A API Google Analytics Embed é uma biblioteca JavaScript que permite criar e incorporar com facilidade um painel em um site de terceiros em questão de minutos. Consulte a visão geral da API Embed para ver mais detalhes.
  • Inclui os componentes: autenticação, seletor de visualização, dados e gráfico de dados.

Esta é a versão inicial da API Provisioning:

  • A API Provisioning pode ser usada para criar programaticamente novas contas do Google Analytics. Ela é destinada somente para convidados, como provedores de serviços qualificados e grandes parceiros. Consulte a visão geral da API Provisioning para mais detalhes.

Nesta versão, adicionamos duas novas APIs de configuração.

Filtros

Relatórios sem dados de amostra: API Management

Adicionamos um novo recurso à API Management chamado Relatórios sem dados de amostra. Eles são relatórios do Google Analytics (GA) que foram gerados sem dados de amostra e,no momento, estão disponíveis apenas para usuários do GA Premium.

  • Atualizamos a lista de origens orgânicas compatíveis.

    • Removidas: Netscape, About, Mamma, Voila, Live, Wirtulana Polska, Yam, Ozu.
    • Adicionadas/atualizadas: Baidu, DOCOMO, Onet, Centrum, Sogou, Tut.By, Globo, Ukr.net, So.com, au one.
  • Atualizamos a lista de origens orgânicas compatíveis.

    • Removidas: Netscape, About, Mamma, Voila, Live, Wirtulana Polska, Yam, Ozu.
    • Adicionadas/atualizadas: Baidu, DOCOMO, Onet, Centrum, Sogou, Tut.By, Globo, Ukr.net, So.com, au one.

Novidades desta versão:

Google Analytics

  • Adicionamos o campo "User ID".

Gerenciador de tags do Google

  • Corrigimos um bug na macro do código de publicidade para que ela consiga retornar o identificador de publicidade (IDFA), se disponível.
  • Também corrigimos um problema que impedia os usuários de utilizar NSNumber em dados de comércio eletrônico.

Nesta versão, removemos o atributo appUiName. Consulte a política de suspensão de uso de dados para ver detalhes sobre a remoção:

Remoção de appUiName

  • Removemos o appUiName. Ele não é mais necessário na API Metadata porque os nomes de IU das vistas (perfis) da Web e do app foram unificadas. Remova qualquer código que use o atributo appUiName e utilize apenas o uiName.

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

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

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

Usuário

  • Dimensão rt:visitorType – Em vez dela, use rt:userType.
  • Métrica rt:activeVisitors – em vez dela, use rt:activeUsers.

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:

Google AdWords

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

Hora

  • 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 usar usuário e sessão, respectivamente.

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

Público-alvo

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

Comércio eletrônico

  • 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 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.

Nesta versão, substituímos o tipo de hit appview, adicionamos parâmetros e renomeamos alguns deles. Consulte a referência de parâmetros para ver a lista completa.

Substituição do appview

  • 0 tipo de hit appview foi substituído por screenview. Atualize seu código de acompanhamento do app o mais rápido possível para usar screenview em vez de appview.

Novos parâmetros

Renomeação de parâmetros

  • O parâmetro Descrição do conteúdo passou a ser chamado de Nome da tela. O nome do parâmetro de consulta, cd, permanecerá igual.

Nesta versão, substituímos o tipo de hit appview e adicionamos novos campos. Consulte a referência de campos para ver a lista completa.

Substituição do appview

  • 0 tipo de hit appview foi substituído por screenview. Atualize seu código de acompanhamento do app o mais rápido possível para usar screenview em vez de appview.

Novos campos

Outras alterações

  • A saída de depuração foi aprimorada.
  • Corrigimos diversos bugs de pré-renderização.
  • Agora é possível usar APIs de pré-renderização sem prefixo. A pré-renderização funciona no IE11 e no Chrome.
  • Também corrigimos alguns pequenos bugs na compatibilidade com o vinculador.
  • A pesquisa segura do Yahoo agora é classificada corretamente como uma origem orgânica.
  • Agora é possível usar APIs de pré-renderização sem prefixo. A pré-renderização funciona no IE11 e no Chrome.

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. Para mais detalhes, consulte o guia do desenvolvedor sobre segmentos.
  • O prefixo dynamic:: está obsoleto. É recomendável migrar para a nova sintaxe o quanto antes.

Segmentos: API Management v2.4 e v3.0

As seguintes alterações foram feitas no conjunto de segmentos:

  • Os segmentos de usuário e de sequência agora são compatíveis com a API.
  • O conjunto de segmentos agora retorna todos os segmentos no nível da sessão e do usuário integrados e personalizados.
  • Agora a propriedade definition dos segmentos usará a sintaxe dos novos segmentos. Isso inclui as definições dos segmentos de nível da sessão existentes, que serão alterados de definition: "" para definition: "sessions::condition::".
  • Uma nova propriedade type foi adicionada ao recurso de segmento para indicar se um segmento é CUSTOM (criado por um usuário na interface da Web) ou BUILT_IN (fornecido pelo Google Analytics).

Experimentos

As seguintes métricas do Google AdSense agora podem ser usadas como objetivos de otimização:

  • ga:adsenseAdsClicks – Número de cliques nos anúncios do Google AdSense no seu site.
  • ga:adsenseAdsViewed – Número de anúncios do Google AdSense visualizados. Vários anúncios podem ser exibidos em um bloco.
  • ga:adsenseRevenue – receita total dos anúncios do Google AdSense.

Novo conjunto de resumos de contas

  • O conjunto AccountSummaries foi adicionado à API Management. Ele mostra um resumo das informações de cada conta, propriedade e vista (perfil) a que um usuário autorizado tem acesso em uma solicitação única e rápida. Consulte o guia do desenvolvedor sobre resumos da conta para mais detalhes.

Remoção da prefixação com ga:

O ga: foi removido de todas as dimensões e métricas em tempo real e foi substituído pelo novo prefixo rt:. As solicitações de API que usam ga: continuarão funcionando por seis meses. Depois desse período, um erro será retornado.

Novas dimensões e métricas

Nessa atualização, adicionamos novas dimensões e métricas à API Real Time Reporting. Leia a referência das dimensões e métricas para ver todas as definições.

Acompanhamento de eventos

  • Dimensão rt:eventAction – Ação do evento.
  • Dimensão rt:eventCategory – Categoria do evento.
  • Dimensão rt:eventLabel – Etiqueta do evento.
  • Dimensão rt:totalEvents – Número total de eventos no perfil, em todas as categorias.

Acompanhamento de meta

  • Dimensão rt:goalId – String correspondente ao código da meta.
  • Métrica rt:goalXXValue – Valor numérico total do número da meta solicitada, em que XX é uma grandeza entre 1 e 20.
  • Métrica rt:goalValueAll – Valor numérico total de todas as metas definidas no seu perfil.
  • Métrica rt:goalXXCompletions – Número total de conclusões do número da meta solicitada, em que XX é um valor entre 1 e 20.
  • Métrica rt:goalCompletionsAll – Número total de conclusões de todas as metas definidas no seu perfil.

Acompanhamento de páginas

  • Métrica rt:pageViews – Número total de visualizações de página.

Acompanhamento de apps

  • Métrica rt:screenViews – número total de exibições de tela.

Novidades desta versão:

Google Analytics

  • O SDK agora preencherá o parâmetro de ID do aplicativo (&aid) por padrão.

Gerenciador de tags do Google

  • Agora é possível usar a macro de Experimentos de conteúdo do Google Analytics.

Novidades desta versão:

Google Analytics

  • Não houve alterações no Google Analytics.

Gerenciador de tags do Google

  • Agora é possível usar a macro de Experimentos de conteúdo do Google Analytics.

Novidades desta versão:

Google Analytics

  • Não houve alterações diretamente no Google Analytics. Os usuários do GA precisam observar que o Gerenciador de tags do Google não tem mais dependência do AdSupport.framework por padrão. Isso pode ajudar a resolver o Problema 387.

Gerenciador de tags do Google

  • As funções que chamam a API AdSupport.framework são detalhadas em uma biblioteca separada, a libAdIdAccess.a. Os apps precisam estar vinculados a essa biblioteca para ter acesso à string do identificador de publicidade (IDFA) e à sinalização de acompanhamento de publicidade ativado.

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.

Caminhos de conversão

  • Dimensão mcf:adwordsCustomerIDPath – Sequência do ID de cliente do Google AdWords nos caminhos de conversão.

Interações

  • Dimensão mcf:adwordsCustomerID – corresponde à API Customer.id do Google AdWords.
  • Os parâmetros do vinculador não são mais ignorados ao navegar em domínios com diferentes níveis de zoom no Firefox.
  • Corrigimos um problema de carregamento de determinados URLs na Análise de Página.
  • A saída do modo de depuração foi aprimorada.
  • Esta é uma versão de manutenção.

Novidades desta versão: * Não é mais necessário incluir AdSupport.framework. * Removemos um código que não era mais utilizado.

Novidades desta versão: * Adicionamos a compatibilidade com o SDK do iOS 7.0 de 64 bits. * Removemos libGoogleAnalytics_debug.a, que faz parte da biblioteca libGoogleAnalyticsServices.a. * Excluímos o arquivo de criação do CuteAnimals do Google Analytics.

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.

Caminhos de conversão

  • Dimensão mcf:adwordsAdGroupIDPath – Sequência do código do grupo de anúncios do Google AdWords nos caminhos de conversão.
  • Dimensão mcf:adwordsCampaignIDPath – Sequência do ID da campanha do Google AdWords nos caminhos de conversão.
  • Dimensão mcf:adwordsCreativeIDPath – Sequência do ID do criativo do Google AdWords nos caminhos de conversão.
  • Dimensão mcf:adwordsCriteriaIDPath – Sequência do código dos critérios do Google AdWords nos caminhos de conversão.

Interações

  • Dimensão mcf:adwordsAdGroupID – Corresponde à API AdGroup.id do Google AdWords.
  • Dimensão mcf:adwordsCampaignID – Corresponde à API Campaign.id do Google AdWords.
  • Dimensão mcf:adwordsCreativeID – Corresponde à API Ad.id do Google AdWords.
  • Dimensão mcf:adwordsCriteriaID – corresponde à API Criterion.id do Google AdWords.

Nesta versão, incluímos um novo formato de resposta de tabela de dados e 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 do Gráficos Google, a API pode opcionalmente 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:

Hora

  • 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 de uso suspenso

Essas dimensões e métricas tiveram o uso suspenso. Consulte a política de suspensão de uso de dados para ver detalhes sobre a remoção de informações:

  • 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.

As seguintes alterações foram feitas nos segmentos padrão devido à suspensão de uso das dimensões ga:isMobile e ga:isTablet:

  • O segmento gaid::-11 foi renomeado de Tráfego proveniente de dispositivos móveis para Tráfego de tablet e de dispositivos móveis. A definição dele foi alterada de ga:isMobile==Yes para ga:deviceCategory==mobile,ga:deviceCategory==tablet. ga:isMobile incluía o tráfego de tablets, e isso é refletido na nova definição. Se você quiser apenas o tráfego de smartphones, e não de tablets, mude para o novo segmento Tráfego proveniente de dispositivos móveis (gaid::-14).
  • A definição do segmento gaid::-13 foi alterada de ga:isTablet==Yes para ga:deviceCategory==tablet. Ela continua a representar o tráfego de tablets.
  • Adicionamos o segmento gaid::-14. O nome do segmento é Tráfego proveniente de dispositivos móveis, e a definição é ga:deviceCategory==mobile.
  • Esta é uma versão de manutençã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.

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 visualizados. 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.

Hora

  • Dimensão ga:isoYear – Ano ISO da visita. 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 são exibidos nos relatórios do Google AdWords:

Correções de bug:

  • Corrigimos as informações de fuso horário das vistas (perfis). Detalhes: antes dessa correção, em determinados casos, informações de fuso horário incorretas eram retornadas ao listar a vista (perfil) na API Management. Agora esses dados são consistentes com as definições na interface de administração do Google Analytics.

Novidades desta versão: * Corrigimos uma divergência com o SDK de buffer do protocolo. * Também eliminamos um erro no vinculador que acontecia quando a remoção de códigos estava ativada.

Novos recursos de controle de tamanho da amostra e datas relativas

Datas relativas
  • Adicionamos suporte para datas relativas à API MCF 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.

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.

Novidades desta versão: * Lançamento da sexta versão Beta. * Fizemos uma mudança para evitar uma exceção de tempo de execução quando um app que segmenta o KitKat (nível da API 19) usa o SDK.

Novidades desta versão: * Segundo lançamento da versão 3.0. * Fizemos uma mudança para evitar uma exceção de tempo de execução quando um app que segmenta o KitKat (nível da API 19) usa o SDK.

Nesta versão, adicionamos operações de gravação aos recursos de propriedade da Web, vista (perfil) e meta, além de um conjunto de três novos recursos que permitem o gerenciamento de permissões do usuário.

Configuração da conta e APIs relacionadas

  • Agora é possível criar, atualizar, corrigir e excluir vistas (perfis). Consulte a referência das vistas (perfis) para mais detalhes sobre os novos métodos.
  • Agora é possível criar, atualizar e corrigir propriedades da Web e metas. Leia a referência das propriedades da Web e a referência das metas para mais detalhes sobre os novos métodos.
  • Agora é possível solicitar uma única propriedade da Web, uma vista (perfil) ou uma meta com o método get.
  • No momento, esses recursos estão disponíveis como Visualização do desenvolvedor na versão Beta limitada. Se você quiser usá-los, solicite acesso.

Permissões de usuário na API Management

Novidades desta versão:

  • Corrigimos um erro no link que acontecia quando o usuário segmentava o iOS 7.0.

Esta é a versão inicial da API Metadata:

  • A API Metadata retorna informações sobre as dimensões e métricas exibidas nas APIs Reporting do Google Analytics. Os metadados retornados incluem atributos como nome da IU, descrição, suporte a segmentos avançados e muito mais. Quando você usa a API Metadata, seus aplicativos são atualizados automaticamente com os dados mais recentes das dimensões e métricas disponíveis para consultas de relatórios. Consulte a visão geral da API Metadata para mais detalhes.

Novidades desta versão: * Primeiro lançamento da versão 3.0. * A API do SDK foi modificada para se alinhar à analytics.js. Os métodos track e send foram removidos. Em vez deles, use send e os métodos de compilação GAIDictionaryBuilder. * A maioria das propriedades no protocolo GAITracker foi excluída. Utilize set nos campos. * Todos os parâmetros definidos usando o método set serão mantidos. Antes, vários parâmetros só eram definidos para a próxima chamada "send/track". * O protocolo GAILogger já está disponível para quem quiser implementar o próprio registro personalizado no SDK. * Alteramos os requisitos mínimos do sistema. Para mais detalhes, consulte o arquivo Readme.txt. * Todas as atividades do SDK (acesso ao banco de dados e à rede) agora são realizadas em uma linha de execução diferente. * clientId agora pode ser lido. Chame [tracker get:kGAIClientId]. Essa chamada será bloqueada até que o clientId possa ser lido pelo banco de dados. * O SDK deixou de usar o POST, exceto quando o hit tiver mais de 2.000 bytes. Ele utilizará GET. * O SDK não tentará mais reenviar hits com base no código de resposta HTTP.

Novidades desta versão: * Primeiro lançamento da versão 3.0. * A API do SDK foi reescrita para se alinhar mais à analytics.js. Para mais detalhes, consulte o Javadoc e o /analytics/devguides/collection/android/v3/. * Todos os métodos track e send foram removidos. Em vez deles, será possível usar o "send" e os métodos de compilação correspondentes na classe MapBuilder para enviar hits. Consulte a classe Fields e veja as constantes que podem ser utilizadas para criar hits com set e send. * Várias propriedades também foram removidas, incluindo useHttps, anonymizeIp etc. Você pode definir/redefini-las usando o comando set. * EasyTracker agora estende Tracker. Não é necessário chamar EasyTracker.getTracker para fazer chamadas de rastreamento diretas. * O SDK não executa mais a sinalização de controle da sessão na inicialização. Agora os desenvolvedores determinam se é necessário criar uma nova sessão. O EasyTracker ainda cuida do gerenciamento da sessão. * O SDK passou a ser compatível com uma classe de registro personalizada. Veja Logger no Javadoc para mais detalhes. * O modo dryRun foi adicionado. * clientId agora pode ser lido. Basta chamar tracker.get(Fields.CLIENT_ID). Essa chamada será bloqueada até que o clientId seja carregado no armazenamento persistente. * O SDK não tentará mais reenviar hits com base no código de resposta HTTP.

Esta é a versão inicial da API Real Time Reporting na versão Beta limitada:

  • A API Real Time Reporting permite que você gere relatórios sobre as atividades que ocorrem na sua propriedade. Você pode usar essa API para consultar dimensões e métricas e criar painéis e widgets da Web que serão exibidos aos clientes. Consulte a visão geral da API Real Time Reporting para mais detalhes.

Correções de bug

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

Além dos novos segmentos, lançaremos as seguintes alterações na API Core Reporting.

  • O parâmetro segment agora é compatível com o novo código alfanumérico dos segmentos avançados personalizados, que é retornado no conjunto de segmentos da API Management.
  • Os códigos numéricos atuais dos segmentos personalizados foram removidos, os códigos legados continuarão sendo aceitos por seis meses. Recomendamos adicionar os novos códigos alfanuméricos aos aplicativos que salvam IDs de segmento do usuário. Depois que o período de suspensão de uso terminar, um erro será retornado para todas as consultas que tiverem os códigos 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.

Além dos novos segmentos, lançaremos as seguintes alterações no conjunto de segmentos:

  • Todos os códigos de segmento serão alterados de strings inteiras positivas para strings alfanuméricas. Se você salvou os IDs de segmento do usuário, recomendamos atualizar para os novos códigos.
  • O conjunto de segmentos retornará apenas os segmentos no nível da visita. No momento, os novos segmentos de visitante, coorte e sequência não são compatíveis com a API.
  • O conjunto continuará retornando os segmentos padrão existentes com os mesmos códigos numéricos negativos, mas os novos segmentos padrão ainda não são aceitos.

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 código é 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.

Remoção de métricas

As métricas a seguir estão obsoletas. 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.

Alterações 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

Comércio eletrônico

  • 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 da 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.

Alterações 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 sociais

  • Esses dados são provenientes do acompanhamento das 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.

Hora

  • 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 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 duas novas propriedades ao recurso de propriedade da Web:

  • profileCount – Retorna a contagem do perfil de uma propriedade. Isso permite que você filtre propriedades sem perfil (ou seja, profileCount = 0).
  • industryVertical – Retorna a vertical/categoria do setor selecionado para uma propriedade.

Correções de bug:

  • A propriedade eCommerceTracking do recurso de perfil agora condiz com as configurações de comércio eletrônico na seção "Administrador" da interface da Web. Retorna true quando o Acompanhamento de comércio eletrônico está ativado e false quando não está.

Novidades desta versão: * Lançamento da quinta versão Beta. * Corrigimos um bug de análise de exceções do EasyTracker. Quando uma sinalização ga_reportUncaughtExceptions estava definida, o analisador de exceções não inicializava, e, consequentemente, não era feita a revisão do local de uma exceção não identificada. Depois dessa correção, os relatórios de falhas e exceções informarão esses locais quando ga_reportUncaughtExceptions estiver definido como "true".

Fizemos as seguintes alterações na versão mais recente do código de acompanhamento:

  • Agora é possível especificar moedas locais usando _set (por exemplo: gaq.push(['_set', 'currencyCode', 'EUR'])).
  • 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.
  • O recurso de perfil agora inclui uma propriedade type que identifica se um perfil está configurado para um site ou app. Os valores possíveis são WEB ou APP.

Novidades desta versão:

  • Alteramos o valor padrão do appVersion de CFBundleVersionKey para CFBundleShortVersionString.
  • O protocolo padrão passou a ser HTTPS, em vez de HTTP.
  • Alguns métodos "track" foram renomeados para "send" (por exemplo, trackView agora se chama sendView).
  • Alguns pequenos bugs foram corrigidos.

Novidades desta versão: * Lançamento da quarta versão Beta. * O SDK agora respeita a configuração de taxa de amostragem. Se você já tiver definido essa taxa como um valor diferente de 100%, perceberá uma redução correspondente em algumas das suas métricas do Google Analytics se comparadas à terceira versão Beta. * Métodos de rastreamento alterados para enviar (por exemplo, trackView agora são chamados de sendView). * Suporte de moeda local adicionado via Transaction.setCurrencyCode * A partir de agora, será usado HTTPS por padrão em vez de HTTP. * O SDK não tentará mais enviar hits se não houver uma conexão de rede. * Os ANRs não serão mais usados ao tentar gerenciar dados de campanhas de instalação. * As classes TrackedActivity foram removidas do SDK. * A inicialização do SDK não será mais realizada na linha de execução de IU principal. * Aprimoramos a capacidade de recuperação do SDK a partir de um banco de dados SQLite corrompido. * Corrigimos outros bugs e falhas.

Novidades desta versão:

  • A arquitetura armv7s foi incluída na libGoogleAnalytics.a.
  • Removemos a arquitetura armv6 da libGoogleAnalytics.a.

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 são exibidos 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 à rede social 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, uma rede social como 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 são provenientes 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, o URL da postagem no Google+, o URL de 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 na rede social.
    • Dimensão ga:socialActivityUserPhotoUrl – Para uma Atividade do hub de dados de redes sociais, essa string representa o URL da foto associada ao perfil da rede social do usuário.
    • Dimensão ga:socialActivityUserProfileUrl – Para uma Atividade do hub de dados de redes sociais, essa string representa o URL do perfil da rede social 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 na rede social.
    • Dimensão ga:socialActivityUserHandle – Para uma Atividade do hub de dados de redes sociais, essa string representa o identificador (por exemplo, nome) da rede social 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 atividade em redes sociais 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 atividade e a rede social em que a atividade teve 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 sociais

  • Esses dados são provenientes do acompanhamento de interações em redes sociais no site.
    • Dimensão ga:socialInteractionAction – Para as interações sociais, uma string que representa a atividade em redes sociais 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 social 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 em redes sociais.
    • 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.

Novidades desta versão:

  • Correções de bug:

    • Removemos a versão NoThumb da biblioteca.
    • Não é mais possível usar armv6.
  • Novos recursos:

    • Você já pode utilizar armv7s (para iPhone 5).

Novidades desta versão:

  • Correções de bugs:
    • Corrigimos a migração de variáveis personalizadas do SDK de versões anteriores à 1.5 para o SDK da versão 1.5.
    • Agora o usuário pode definir restrições de dados em segundo plano.

Novidades desta versão:

  • Correções de bugs:
    • Os métodos do protocolo GANTrackerDelegate passaram a ser opcionais.
    • Os eventos agora incluem a última visualização de página que foi rastreada (utmp).
  • Novos recursos:
    • Agora é possível utilizar até 50 variáveis personalizadas. Observação: esse recurso só está disponível para usuários do Google Analytics Premium.
    • Atualizamos o app de exemplo BasicExample.

Novidades desta versão:

  • Correções de bug:

    • Corrigimos o problema de vazamento de memória.
    • Os eventos agora incluem a última visualização de página que foi rastreada (utmp).
  • Novos recursos:

    • Agora é possível utilizar até 50 variáveis personalizadas. Observação: esse recurso só está disponível para usuários do Google Analytics Premium.

Novidades desta versão:

  • Agora é possível usar o método de acompanhamento de redes sociais no GAITracker:
    • trackSocial:withAction:withTarget:
  • A assinatura do método de velocidade foi alterada para:
    • trackTiming:withValue:withName:withLabel:
  • Os métodos manuais de envio e construção foram incluídos no GAITracker:
    • set:value:
    • get:
    • send:params:
  • Adicionamos os métodos do definidor de dimensões personalizadas ao GAITracker:
    • setCustom:dimension:
    • setCustom:metric:
  • A arquitetura do armazenamento de dados foi refatorada para evitar os problemas de CoreData.

Novidades desta versão:

  • Agora é possível usar dimensões e métricas personalizadas.
  • Adicionamos suporte ao acompanhamento de interações sociais.
  • Tornamos o StandardExceptionParser uma classe pública.
  • Corrigimos falhas que ocorriam durante a inicialização do SDK.
  • As transmissões de INSTALL_REFERRER não serão mais ignoradas, como ocorria em alguns dispositivos.
  • ConcurrentModificationExceptions corrigida na classe GoogleTracker.
  • Fizemos algumas outras correções de bugs e melhorias.

Esta é a versão inicial da API Multi-Channel Funnels Reporting:

  • Com essa nova API, você pode solicitar dados de funil multicanal para um usuário autenticado, derivados das informações do caminho de conversão que mostram as interações do usuário com várias origens de tráfego durante visitas anteriores à conversão. Isso permite analisar como vários canais de marketing influenciam as conversões ao longo do tempo. Para mais detalhes sobre quais dados estão disponíveis e como usar a API, consulte API Multi-Channel Funnels Reporting.

Novidades desta versão:

  • Passamos a usar o formato eletrônico mais recente.
  • sampleRate foi alterado para flutuante de precisão dupla.
  • Começaremos a limitar o acompanhamento excessivo.
  • As informações de acompanhamento não enviadas serão excluídas se o recurso "opt-out" estiver ativado.
  • As informações de acompanhamento com mais de 30 dias não enviadas serão excluídas.
  • Fizemos algumas melhorias no expedidor de hits.
  • Agora, em vez de tentar reenviar periodicamente, o expedidor usará a API Reachability se a conexão for perdida para ser notificado quando ela voltar.
  • O aplicativo de exemplo foi atualizado.
  • Fizemos algumas outras correções de bugs e melhorias.

Novidades desta versão:

  • A interface do EasyTracker foi simplificada.
  • O controle de envio foi movido para uma nova classe, GAServiceManager.
  • Passamos a usar o formato eletrônico mais recente.
  • sampleRate foi alterado para duplo.
  • Começaremos a limitar o acompanhamento excessivo.
  • As informações de acompanhamento não enviadas serão excluídas se o recurso "opt-out" estiver ativado.
  • As informações de acompanhamento com mais de 30 dias não enviadas serão excluídas.
  • Fizemos algumas outras correções de bugs e melhorias.

Correções de bug

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

Novidades desta versão:

  • Já é possível usar o recurso de tratamento de exceções não identificadas.
  • A propriedade dispatchEnabled foi removida de GAI.
  • A propriedade defaultTracker foi adicionada a GAI.
  • O método close foi adicionado a GAITracker.
  • Adicionamos o método de acompanhamento de velocidade a GAITracker.
  • O método trackView foi adicionado a GAITracker e não requer argumentos.
  • Os nomes dos campos de itens de transações foram atualizados.
  • Passamos a usar o formato eletrônico mais recente.
  • Agora o valor de evento é interpretado como um número inteiro de 64 bits.
  • A forma de geração de códigos do ARMv6 foi alterada de THUMB para ARM.

Novidades desta versão:

  • O método startSession foi removido. Use setStartSession.
  • Adicionamos o parâmetro ga_sessionTimeout ao EasyTracker.
  • Implementamos o Modo de economia de energia.
  • O método trackView foi adicionado a GAITracker e não requer argumentos.
  • Corrigimos um bug que impedia os parâmetros de exceção de serem enviados em hits.
  • Quando não for possível analisar hits do banco de dados, eles serão descartados. Deixaremos de bloquear permanentemente o envio de todos os hits.
  • Passamos a usar o formato eletrônico mais recente.
  • O tipo de hit "timing" foi implementado.
  • Também implementamos os tipos de hit de comércio eletrônico (transação e item).

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

Fizemos as seguintes alterações na versão mais recente do código de acompanhamento:

  • A taxa de amostragem de velocidade do site máxima permitida (_setSiteSpeedSampleRate) aumentou de 10% para 100%.
  • Agora, quando você usa o método _setAccount, os espaços adicionais no início e no fim são removidos.

Nesta versão, corrigimos dois bugs:

Correções de bug

  • 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

  • As seguintes 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 suspensão de uso 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, encerraremos esse serviço e ofereceremos 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 do Google Data JavaScript que usa uma saída relacionada retornarão 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.

Fizemos as seguintes alterações na versão mais recente do código de acompanhamento:

  • Atualizamos a lista de mecanismos de pesquisa orgânica que são detectados por padrão. Foram adicionadas as opções "startsiden.no", "rakuten.co.jp", "biglobe.ne.jp" e "goo.ne.jp". Removemos "search" e incluímos "conduit.com", "babylon.com", "search-results.com", "avg.com", "comcast.net" e "incredimail.com", que eram atribuídos conjuntamente como "search".

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

Nesta versão, adicionamos respostas de erros úteis à API Management.

  • Adicionamos novos códigos de erro, motivos e descrições ao corpo das respostas de erro da API. Todos os códigos foram documentados para a versão 2.4 e a versão 3.0 da API Management.

Fizemos as seguintes alterações na versão mais recente do código de acompanhamento:

  • O limite do tamanho da variável personalizada aumentou de 64 para 128 caracteres. Além disso, o tamanho é verificado antes da codificação do URL.
  • Também aumentamos a limitação de taxa para hits de evento. Agora é possível enviar 10 hits, com 1 hit adicional por segundo (antes, você só podia enviar 1 hit a cada 5 segundos). No entanto, o limite de 500 hits por sessão não foi alterado.
  • Os cookies __utmv agora são criados com um separador de variáveis diferente (acentos circunflexos, em vez de vírgulas) para serem usados com RFCs. Isso corrigirá alguns dos problemas relacionados à codificação de cookies.

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 alteramos 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

    • A nova saída baseada em JSON reduz o tamanho da resposta em cerca de 10 vezes em relação à saída XML anterior.
    • Adicionamos novas bibliotecas de cliente das APIs do Google compatíveis com Java, JavaScript, Python, PHP, Ruby e .Net.
    • Adicionamos suporte à API Google Discovery.
    • Adicionamos suporte para autorização de usuários com OAuth 2.0.
  • Atualizações

    • Incluímos um novo URL para fazer solicitações: https://www.googleapis.com/analytics/v3/data/ga….
    • Os tokens de desenvolvedor e registro agora são necessá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 desenvolvedor e registro agora são necessá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 retornarão 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 dados, alteramos a funcionalidade existente e corrigimos um bug.

Novos dados

  • O conjunto de segmentos avançados agora contém um campo segmentId que pode ser usado no parâmetro segment da API Data Export.

Alterações

  • O tipo de dados de max-results foi alterado para integer.

  • O valor padrão máximo de max-results foi alterado para 1.000.

Correções de bug

  • Removemos as contas, as propriedades da Web e os perfis dos experimentos do Otimizador de site do Google dos conjuntos correspondentes.

Novidades desta versão:

  • Documentação:

    • O ReadMe.txt foi atualizado e agora leva ao site da documentação.

Novidades desta versão:

  • Correções de bugs:
    • Corrigimos o gerenciamento do acompanhamento automático do URL de destino do Google Play.
    • O parâmetro de referenciador de setReferrer agora pode ser codificado pelo URL.

Alterações na coleta de dados da velocidade do site:

  • Os dados de velocidade do site agora são coletados automaticamente para todas as propriedades da Web a uma taxa de amostragem de 1%. A função _trackPageLoadTime, que antes era necessária para coletar essas informações, deixou de ser usada.
  • Já é possível ajustar a taxa de amostragem padrão com a nova função _setSiteSpeedSampleRate.
  • Se um caminho virtual for utilizado na chamada _trackPageview, ele também passará a ser associado aos dados de velocidade do site coletados nessa página.

Novidades desta versão:

  • Correções de bugs:
    • O banco de dados foi transferido do diretório "Documentos" para "Biblioteca".
    • O SDK não retorna mais NSAsserts para erros no banco de dados SQLite.
    • Corrigimos uma falha que acontecia ao chamar trackPageview com uma string vazia.
    • Também corrigimos erros que ocorriam ao chamar vários métodos GANTracker depois de stopTracker.
    • Resolvemos diversos vazamentos de memória, incluindo um que chamava trackPageview por engano com um pageURL iniciado em "/".
  • Novos recursos:
    • Incluímos o método dispatchSynchronously.
    • Foram disponibilizadas várias constantes úteis (consulte GANTracker.h).

Novidades desta versão:

  • Correções de bugs:
    • Interrompemos e processamos diversas SQLiteExceptions.
    • Corrigimos a exceção NullPointerException que surgia stopSession se a chamada ocorresse antes de startNewSession.
    • Corrigimos erros de memória insuficiente nos dispositivos HTC Thunderbolt e Motorola Droid Bionic.
    • Removemos o acesso desnecessário ao banco de dados no método de envio.

Novidades desta versão:

  • É possível marcar os eventos como "Sem interações" definindo o novo parâmetro opt_noninteraction do método _trackEvent() como true. Essa opção indica que os hits do evento em questão não afetarão a taxa de rejeição. Para saber mais, consulte a referência da ga.js.

O bug a seguir foi corrigido nesta versão:

  • Resolvemos um problema em que a propagação do parâmetro de URL gclid do Google AdWords em vinculações de sites internos aumentava o número de visitas pagas.

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.

Novidades desta versão:

  • Correções de bugs:
    • Solucionamos um erro de barramento que acontecia ao tentar definir a sinalização dryRun antes de inicializar o rastreador.
    • Foi corrigido outro erro de barramento que ocorria ao tentar enviar NULL para o erro.
    • Agora é possível usar o idioma correto no cabeçalho HTTP.
  • Novos recursos:
    • Adicionamos a sinalização anonymizeIp.
    • Incluímos o parâmetro sampleRate.
    • Agora é possível usar referências de campanhas.

Novidades desta versão:

  • Correções de bugs:
    • Corrigimos o bug no acompanhamento geral de referência de campanhas.
    • A sinalização anonymizeIp deixará de interferir no acompanhamento de campanhas.

Nesta versão, adicionamos duas novas versões da API com muitos recursos novos e removemos a antiga. As alterações afetam o modo de solicitar e manipular os dados da API.

Versão 3.0

  • Essa é a versão mais recente da nossa API, que não é compatível com versões anteriores. Será preciso usar esta versão para todo o desenvolvimento futuro da API.

  • Novos dados

    • Representação completa das metas de eventos
    • ID da propriedade da Web interno que pode ser usado para criar links diretos para a interface do usuário do Google Analytics
    • Configurações de perfil para a página padrão e parâmetros de consulta de pesquisa no site
  • Alterações

Versão 2.4

  • Este é um upgrade de versão secundária que é, na maioria das vezes, compatível com versões anteriores à 2.3.

  • Alterações

    • Adicionamos uma nova política de cota.
    • Incluímos a integração com o Console de APIs do Google para gerenciar o acesso à API e solicitar mais cotas.
    • Adicionamos suporte contínuo para os mecanismos de autorização existentes e o OAuth 2.0.
    • Incluímos um novo URL para fazer solicitações: https://www.googleapis.com/analytics/v2.4/management/….
    • Adicionamos o recurso de respostas somente em XML.
    • Removemos o suporte para a biblioteca de cliente JavaScript dos dados do Google.
    • 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.

Suspensão de uso

  • Estamos anunciando a remoção da versão 2.3 legada da API Management. Ela continuará funcionando por dois meses. Depois disso, todas as solicitações feitas na v2.3 retornarão uma resposta para a v2.4.

Esta versão corrigiu um bug que causava dois eventos: um número artificialmente maior de visitas e/ou uma redução no número de novos visitantes de alguns sites. O primeiro afetava, em sua maioria, sites com tráfego orgânico e comportamentos específicos do usuário. O segundo evento acontecia apenas em sites que usavam uma configuração incompatível de acompanhamento com vários rastreadores.

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 com nenhum resultado, a API agora retorna o código de erro 400 para todas as consultas que usam essas combinações.

Alterações nos cálculos da sessão:

  • Uma campanha por sessão: se uma nova campanha for lançada durante uma sessão existente, o script de acompanhamento passará a iniciar automaticamente uma outra sessão. Uma nova campanha será acionada quando houver alterações em qualquer um destes campos: "ID da campanha", "Nome", "Origem", "Mídia", "Termo", "Conteúdo" ou "GCLID".
  • O script de acompanhamento deixará de iniciar uma nova sessão caso o usuário feche o navegador.

Alterações no acompanhamento de vários domínios:

  • Não é mais preciso chamar _setAllowHash(false) ao configurar o acompanhamento de vários domínios. As páginas que já chamam _setAllowHash(false) continuarão funcionando, mas essa ação deixará de ser necessária ao criar um novo site.
  • Agora, o script de acompanhamento tentará corrigir os parâmetros do vinculador que foram corrompidos por redirecionadores HTTP e navegadores. Cerca de 85% dos valores do vinculador que são descartados atualmente devido a mudanças de codificação feitas por redirecionadores e navegadores passarão a ser restaurados e aceitos pelo script.

Novidades desta versão:

  • Correções de bugs:
    • Corrigimos vários problemas no gerenciamento do banco de dados.
    • Também corrigimos as exceções ao usar variáveis personalizadas.
    • Passaremos a utilizar o contexto do aplicativo em vez do contexto passado a ele.
    • Não serão mais criadas sessões fantasmas por engano.
  • Novos recursos:
    • Agora é possível definir as referências de campanhas a qualquer momento.
    • Adicionamos a sinalização sampleRate.
    • A sinalização anonymizeIp foi incluída.

Novidades desta versão:

  • O código de acompanhamento passou a adiar os hits de páginas pré-renderizadas até que elas sejam vistas pelo usuário. Se uma página dessas não for visualizada, nenhum hit será enviado. Esse recurso só está disponível para sites que usam o script de acompanhamento assíncrono. Saiba mais sobre a pré-renderização no blog da Central do webmaster do Google.

Esta versão contém diversas correções de bug e refatorações, além de um novo recurso:

  • Agora é possível usar o acompanhamento de redes sociais (_trackSocial).

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

Remoção do intervalo de confiança

  • Não será mais possível usar 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.

Novidades desta versão:

  • Correções de bugs:
    • Resolvemos a falha que acontecia ao usar variáveis personalizadas.
    • Também corrigimos os vazamentos de memória ao utilizar variáveis personalizadas.
  • Novos recursos:
    • Agora é possível usar hits de comércio eletrônico.
    • Adicionamos a sinalização Debug.
    • Adicionamos a sinalização DryRun.
    • Passamos a exibir informações mais detalhadas sobre os erros do SQLite3.

Novidades desta versão:

  • Correções de bug:

    • Corrigimos a string userAgent formatada incorretamente.
  • Novos recursos:

    • Agora é possível usar o Acompanhamento de comércio eletrônico.
    • Adicionamos a sinalização debug.
    • A sinalização dryRun foi incluída.

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, é necessário definir o valor real extraído do código de acompanhamento (por exemplo, uma unidade agora será especificada como 1).

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

Os bugs a seguir foram corrigidos nesta versão:

  • Solucionamos um bug no acompanhamento de vários domínios que causava a codificação incorreta dos dados da campanha.
  • Foi corrigido um bug no acompanhamento de vários domínios que fazia com que os cookies fossem carregados a partir do URL mais de uma vez, gerando cookies incorretos.
  • Também corrigimos um bug nas variáveis personalizadas que fazia com que alguns valores ficassem codificados nos relatórios.

Novidades desta versão:

  • Correções de bug:

    • Corrigimos a codificação inadequada de espaços.
    • SQLiteExceptions não causará mais falhas nos apps.
  • Novos recursos:

    • Agora é possível usar variáveis personalizadas.

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

Melhoria de desempenho

  • Nesta versão, melhoramos a latência do feed de dados de 30 a 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). Futuramente, será necessário definir o valor real extraído do código de acompanhamento (por exemplo, uma unidade agora será indicada como 1).

  • No momento, ga:CTR é uma percent e retorna o valor 0,02. No futuro, isso mudará, e a porcentagem real será retornada (por exemplo, 2).

Esta é uma versão de manutenção regular, incluindo correções de bugs e refatorações. Não houve alterações nos recursos ou nas APIs públicas.

Novidades desta versão:

  • Agora é possível usar o POST:

    • Já é possível enviar beacons de acompanhamento muito maiores com o código de acompanhamento. Os beacons costumavam ser transmitidos por meio de solicitações HTTP GET, que só conseguem utilizar 2.048 caracteres em alguns navegadores e proxies. As solicitações que excedessem esse limite eram descartadas, e os dados nunca chegavam ao Google Analytics. A partir desta versão, as solicitações que incluírem mais caracteres serão enviadas por meio do POST HTTP, que não tem essa restrição. O código de acompanhamento passou a aceitar até 8.192 caracteres.

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.

  • Adicionamos 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.

Os bugs a seguir foram corrigidos nesta versão:

  • Corrigimos um bug que impedia o funcionamento correto de _addIgnoredOrganic e _addIgnoredRef na primeira visita a um site.
  • Foi corrigido um problema em que o código de acompanhamento era executado em vários iframes.

Novidades desta versão:

  • Novos recursos:
    • Agora é possível usar variáveis personalizadas.
    • Adicionamos a versão NoThumb da biblioteca.

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

Novas atualizações de dados

  • O cálculo de ga:visitors foi alterado para mostrar o número de visitantes únicos do período e agora 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 comércio eletrônico: 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.

Esta é uma versão de manutenção regular, incluindo correções de bugs e refatorações. Não houve alterações nos recursos ou nas APIs públicas.

Novidades desta versão:

  • Novos recursos:

    • Agora é possível usar o iOS 4.

Nesta versão, corrigimos dois bugs:

Correções de bug

  • 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 sendo mostrada.

Esta é a versão Beta da API Google Analytics Management.

Novos feeds

Bibliotecas cliente atualizadas

  • A API Management está sendo lançada na mesma biblioteca que a API Data Export do Google Analytics. As bibliotecas Java e JavaScript de dados do Google foram atualizadas. Cada feed pode ser acessado especificando o URI de feed apropriado para o método getManagementFeed() das bibliotecas.

Nova documentação

  • Criamos uma nova seção de documentação do desenvolvedor do Google Analytics para descrever como a nova API Management funciona.

Nesta versão, corrigimos três bugs:

Correções de bug

  • Corrigimos um problema de codificação na biblioteca 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 exibe 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 do Google AdWords.
    • ga:adwordsCampaignId: corresponde ao Campaign.id da API do Google AdWords.
    • ga:adwordsCreativeId: corresponde ao Ad.id da API do Google AdWords.
    • ga:adwordsCriteriaId: corresponde ao Criterion.id da API do Google AdWords.
    • ga:adwordsCustomerId: corresponde ao AccountInfo.customerId da API do Google AdWords.

Correções de bug

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

Esta versão contém correções de bugs e a limpeza da API.

  • Correções de bugs:

    • Corrigimos o bug de acompanhamento de eventos. Para chamar _trackEvent, não é mais necessário chamar _initData ou _trackPageview primeiro.
    • Atualizamos o snippet assíncrono para que ele possa ser colocado no cabeçalho de qualquer página sem causar problemas no IE 6 e 7. Consulte o guia de acompanhamento assíncrono para conhecer o novo snippet. Essa atualização foi feita em 22 de março de 2010.
    • A sintaxe assíncrona foi expandida para oferecer suporte à chamada de métodos no objeto _gat.
  • As APIs de inicialização do rastreador foram atualizadas de acordo com a sintaxe assíncrona. Além disso, as funções antigas foram desativadas.

    • Adicionamos a função _gat._createTracker(opt_account, opt_name), que permite que os objetos de acompanhamento sejam nomeados e recuperados posteriormente por nome. Use-a em vez de _gat._getTracker(account).
    • Adicionamos _gat._getTrackerByName(name), que recupera o rastreador com o nome em questão.
    • Adicionamos tracker._getName(), que mostra o nome informado ao rastreador quando ele foi criado.
    • Removemos _gaq._createAsyncTracker(account, opt_name). Use _gat._createTracker.
    • Removemos _gaq._getAsyncTracker(name). Use _gat._getTrackerByName.
  • Consulte a referência do rastreador para ver detalhes sobre essas alterações na API.

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 no máximo 10.000 solicitações a cada 24 horas.
    • Um aplicativo pode fazer apenas 10 solicitações em um período de um 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 ver essas novas combinações.

Correções de bug

  • 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 exibir os dados corretos.

Lembrete da desativação de dimensões e métricas

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

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

Aumentamos o número da versão principal para 2

  • Alguns recursos precisam usar as bibliotecas 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:

    • <dxp:segment id="gaid::-3" name="Returning Visitors"></dxp:segment>
    • <dxp:definition>ga:visitorType==Returning Visitor</dxp:definition>
  • O feed de dados também fornece um elemento XML que indica se um segmento foi aplicado na solicitação da 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 de conta:

    • <ga:goal active="true" name="Completing Order" number="1" value="10.0"></ga:goal>
    • <ga:destination expression="/purchaseComplete.html" matchtype="regex" step1required="false" casesensitive="false"></ga:destination>
    • <ga:step number="1" name="Login" path="/login.html"></ga:step>
    • <ga:engagement comparison=">" thresholdvalue="300" type="timeOnSite"></ga:engagement>
  • 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:

    • <ga:customvariable index="1" name="category" scope="visitor"></ga:customvariable>
  • 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 obsoletas 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 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.

Esta versão contém atualizações na lista de mecanismos de pesquisa padrão e novas funções para controlar o tempo limite dos cookies. Além disso, o snippet assíncrono do GA foi lançado e diminui o impacto da latência da ga.js na página.

  • Fizemos algumas atualizações na lista de mecanismos de pesquisa padrão.

    • Foram adicionados os mecanismos Naver, Eniro e Daum.
    • As opções Looksmart, Gigablast, Club-internet, Netsprint, Intera, Nostrum e Ilse foram removidas da lista.
  • Adicionamos funções para controlar o tempo limite de todos os cookies armazenados. As funções relacionadas existentes foram desativadas. Consulte a documentação da API JS para ver mais detalhes.

    • _setVisitorCookieTimeout(cookieTimeoutMillis) substitui a função _setCookiePersistence.
    • _setSessionCookieTimeout(cookieTimeoutMillis) substitui a função _setSessionTimeout.
    • _setCampaignCookieTimeout(cookieTimeoutMillis) substitui a função _setCookieTimeout.
  • O snippet assíncrono do GA foi lançado. Veja a documentação relacionada para saber como usá-lo.

  • A função _setVar está obsoleta. O recurso de variáveis personalizadas substitui _setVar. Veja a documentação relacionada para mais detalhes.

Novidades desta versão:

  • Adicionamos uma nova função para recuperar variáveis personalizadas no nível do visitante. Consulte a documentação da função para ver mais detalhes.

    • _getVisitorCustomVar(index)
  • Em vez de aguardar window.onload, o conteúdo de cobertura do site passará a ser carregado assim que a ga.js for executada.

Novidades desta versão:

  • Adicionamos um parâmetro booleano opcional à função _addOrganic para especificar se novas origens orgânicas devem ser adicionadas no início ou no final da lista correspondente. Veja a documentação relacionada para mais detalhes.

    • _addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)

Esta é uma versão de manutenção regular, incluindo melhorias de desempenho e refatorações. Não houve alterações nos recursos ou nas APIs públicas.

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

  • As dimensões e métricas a seguir foram desativadas e serão removidas permanentemente da API dentro de um mês. Atualize seu código para que seus 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 expostos pelas seguintes dimensões:

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

  • A navegação na página 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 filtro do feed de dados aumentou de 32 para 128 caracteres.

  • O Relatório de duração da visita (encontrado na IU em "Visitantes" -> "Lealdade do visitante") agora é exposto pela nova dimensão:

    • ga:visitLength

Nesta versão, corrigimos vários bugs e fizemos melhorias de desempenho:

  • Codificação apropriada para os termos de pesquisas orgânicas, informações do caminho da página da Web para (utmp) e valores definidos pelo usuário usados com o recurso do vinculador (isto é, as funções _link e _linkByPost).
  • O mecanismo Rambler foi adicionado à lista de pesquisa orgânica.
  • Foi corrigida a análise da pesquisa orgânica no mecanismo http://kvasir.no.
  • Incluímos novos mecanismos de pesquisa orgânica definidos pelo usuário no topo da lista.
  • A função _trackEvent(action, label, value) obsoleta foi removida e substituída por _trackEvent(category, action, label, value).
  • Os URLs de referenciadores agora são armazenados com distinção entre maiúsculas e minúsculas. Por exemplo, www.domain.com/PaGe.HtMl será registrado com informações de letras maiúsculas e minúsculas.
  • Adicionamos um limite de 1.200 caracteres ao tamanho do token do GASO.
  • Foi incluída uma nova função para permitir a substituição de tempos limite padrão por cookies: _setCookiePersistence(timeout).

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

  • 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 informações 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).
    <dxp:property name="ga:currency" value="USD"></dxp:property>
    <dxp:property name="ga:timezone" value="America/Los_Angeles"></dxp:property>

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

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

Nesta versão, removemos os recursos desativados 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 somente solicitações no seguinte 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