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

Esta página documenta todas as alterações feitas nas APIs e SDKs do Google Analytics. Ela inclui os registros de todas as APIs de coleta, relatórios e configuração. Consulte regularmente esta lista para não perder os novos comunicados. Você também pode se inscrever para receber as mudanças pelos feeds listados na seção Fazer inscrição 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.

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

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:

  • Com a API User Deletion, um cliente do Google Analytics pode excluir dados de um projeto ou uma propriedade da Web de um determinado usuário final. As solicitações de exclusã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, mudamos as cotas e limites da API Real Time do Google Analytics.

As chamadas da API Real Time Reporting do Google Analytics contribuíam com o limite de 10.000 chamadas diárias por vista (perfil), que é equivalente a 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 mudança oferece uma abordagem mais detalhada e segura para gerenciar cotas. Assim, chamadas frequentes que usam a API Real Time Reporting do Google Analytics não bloqueiam acidentalmente todas as outras chamadas de API do Analytics pelo restante do dia em um perfil.

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

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

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

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

Esta versão adicionou a nova tarefa customTask.

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

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

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

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

Tempo

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

Remoção de dados

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

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

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

Métricas do usuário

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

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

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

Eventos únicos

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

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

Dimensões do usuário

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

Mensagens de erro

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

Dimensões e métricas do Google AdSense

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

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

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

Métricas calculadas

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

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

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

Acompanhamento de eventos

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

Eventos únicos

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

Teste de transição – privado

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

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

Nesta versão, adicionamos os públicos-alvo de remarketing à API Management.

Públicos-alvo de remarketing

A API Management permite realizar as ações create, get, list, update e patch em públicos-alvo de remarketing de uma propriedade do Google Analytics. Consulte o artigo Sobre os públicos-alvo de remarketing no Google Analytics da Central de Ajuda para entender como eles funcionam.

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.

ID da transação

  • Dimensão mcf:transactionId – ID da transação informado pelo método de acompanhamento de e-commerce 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 – ID do continente dos usuários, derivado dos endereços IP ou dos IDs de áreas geográficas.

Restrições

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

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

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

Como informar erros

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

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

Limites de tabela dinâmica

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

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

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

Rede geográfica

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

DoubleClick for Publishers

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

Nesta versão, adicionamos um novo atributo addedInApiVersion.

Adição à versão da API

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

Como começar

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

Política de cotas

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

Migração

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

Dimensões e métricas

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Atividades em redes sociais

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

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

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

Plataforma ou dispositivo

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

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 conferir 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 da 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. Quando ele é definido como false, as linhas sem dados são omitidas da resposta. O valor padrão é true, que é uma alteração não interruptiva e, por isso, não requer atualização de código. Consulte a documentação Referência da API Core Reporting para mais detalhes.

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

Nesta versão, 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 performance e redução no uso de cota.

Vistas (perfis)

Com essa versão, a propriedade currency da vista (perfil) vai passar a usar USD se esse valor não for definido durante uma operação insert. 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, descontinuamos algumas dimensões ou métricas. Leia a referência das dimensões e métricas para ver todas as definições.

Dimensões descontinuadas

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

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

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 descontinuados 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 vão retornar um erro.

Novidades desta versão:

Google Analytics

  • Não houve alterações.

Gerenciador de tags do Google

  • Corrigimos uma divergência 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.

Objetivos

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.
  • Descontinuação do Logger/LogLevel do Google Analytics. Agora, ele usa 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. Consulte o Issue 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 mudanças.

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 o framework 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.

Esta versão adicionou 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 foi descontinuada.
  • Correções de bugs

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

Plataforma ou dispositivo

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

Nesta versão, corrigimos um bug.

  • Nesta versão, corrigimos um problema (em inglês) na aplicação das restrições de filtro na consulta da API Real Time Reporting. As solicitações com rt:activeUsers e um filtro em uma dimensão de evento resultavam em um erro badRequest e uma mensagem OR operator not supported for a hit level filter. Consulte o guia para desenvolvedores sobre a API Real Time Reporting e conheça melhor as restrições de consulta.

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

Origem de dados

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

Esta versão adicionou um novo campo. Consulte a referência de campos para ver a lista completa.

Fonte de dados

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

Substituição geográfica

Nesta versão, adicionamos dois novos conjuntos à API Management: dimensões personalizadas e métricas personalizadas.

Dimensões e métricas personalizadas

Agora é possível criar, listar, receber, corrigir e atualizar dimensões e métricas personalizadas com a API Management.

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

ECommerce

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

Usuário

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

Rede geográfica

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

DoubleClick Campaign Manager

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

Métricas descontinuadas

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

A resposta do método list para todas as coletas agora inclui uma lista vazia para a propriedade items quando a coleta 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.

Novidades desta versão:

Google Analytics

Gerenciador de tags do Google

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

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

Adicionamos um novo campo de filtros DEVICE_CATEGORY, e IS_MOBILE e IS_TABLET foram descontinuados. 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

  • Descontinuamos openContainerWithId com base no TAGContainerFuture. Usar essa API no iOS 8 gera erros quando o método "get" é chamado em algumas fases do ciclo de vida de UIAppDelegate.
  • Agora é possível utilizar métricas e dimensões personalizadas para e-commerce avançado na tag do Google Universal Analytics.
  • Corrigimos um bug em que algumas ações de e-commerce avançado que deveriam ter definições de produto opcionais continham definições obrigatórias.
  • Você já pode usar recursos do ID 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.

As vistas (perfis) agora incluem uma propriedade enhancedECommerceTracking que indica se o e-commerce 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.

AdWords

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

Dimensões e métricas descontinuadas

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

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

Tempo

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

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 de 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 de 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 de 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 de 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 de 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 de 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 mostrado no evento (impressão ou clique) associado à conversão do Google Analytics.
  • Dimensão mcf:dcmSitePath – caminho de 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. Ela soma todos os tipos de hit (por exemplo, visualização de página, evento, tempo etc.)

Origens de tráfego

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

DoubleClick Campaign Manager

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

Novidades desta versão:

Google Analytics

  • Não houve mudanças.

Gerenciador de tags do Google

  • Agora é possível usar o e-commerce 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 posteriormente.
  • Dimensão ga:contentGroupXX – Grupo de conteúdo em uma propriedade. É um conjunto de conteúdo que oferece uma estrutura lógica que pode ser determinada pelo código de acompanhamento ou pela correspondência de título de página/URL regex ou regras predefinidas.
  • Dimensão ga:previousContentGroupXX – grupo de conteúdo que foi visitado anteriormente.
  • Métrica ga:contentGroupUniqueViewsXX – Número de páginas diferentes (exclusivas) em uma sessão para o grupo de conteúdo especificado. Essa opção considera o pagePath e o pageTitle para determinar a exclusividade.

Novidades desta versão:

Google Analytics

  • Agora é possível usar o e-commerce avançado. Para mais detalhes, consulte o guia para desenvolvedores sobre esse recurso.
  • Agora, o ID do cliente será redefinido sempre que o de publicidade for modificado.
  • Por padrão, a coleta do ID de publicidade fica 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 vai passar a coletar o IDFA e a sinalização ativada pelo acompanhamento de publicidade 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 e-commerce 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. Ele muda 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 para desenvolvedores sobre a importação de dados e saiba como usar a API Management se quiser importar dados para sua conta do Google Analytics.

Envios

  • 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 as customDataSources dos dados de custo.

Descontinuação dos uploads diários

  • O recurso dailyUpload foi descontinuado. Consulte o guia de migração para detalhes sobre como usar a importação de dados.
  • O recurso dailyUpload vai 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 só vão funcionar com o recurso upload.
  • Os usuários de dailyUpload têm que atualizar o código e migrar para o recurso de upload o quanto antes.

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

Segmentos

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

Dimensões e métricas

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

E-commerce avançado

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

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

Dimensões e métricas

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

Sistema

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

Agrupamento de canais

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

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

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

Nesta versão, 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 contas do Google Analytics de forma programática. 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 ID 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 e-commerce.

Nesta versão, removemos o atributo appUiName. Consulte a política de descontinuação de dados para ver mais detalhes:

Descontinuação do appUiName

  • O appUiName foi descontinuado. 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 todos os códigos que usem 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 descontinuação de dados para ver mais detalhes:

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:

AdWords

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

Tempo

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

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

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

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

Público-alvo

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

e-commerce

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

Acompanhamento de eventos

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

Conversões de meta

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

Acompanhamento de páginas

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

Sessão

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

Interações em redes sociais

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

Usuário

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

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

  • O 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"

  • O 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. Consulte o guia para desenvolvedores sobre segmentos se quiser mais detalhes.
  • O prefixo dynamic:: foi descontinuado. É recomendável migrate o quanto antes.

Segmentos: API Management v2.4 e v3.0

As seguintes mudanças 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 no nível da sessão, que vão mudar de definition: "" para definition: "sessions::condition::".
  • Uma nova propriedade type foi adicionada ao segmento para indicar se ele é 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

Descontinuação do prefixo ga:

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

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 ID 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 mudanças diretamente no Analytics. Os usuários do GA vão perceber 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 outra biblioteca, a libAdIdAccess.a. Os apps precisam estar vinculados a essa biblioteca para ter acesso à string do identificador de publicidade (IDFA) e à sinalização ativada pelo acompanhamento de publicidade.

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: * Agora é possível usar o SDK para 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, adicionamos dimensões e métricas e removemos outras. Leia a Referência das dimensões e métricas para ver todas as definições.

Saída da tabela de dados

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

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

Novas dimensões e métricas

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

Tempo

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

Público-alvo

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

Dimensões e métricas permitidas nos segmentos

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

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

Dimensões e métricas descontinuadas

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

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

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

Tempo

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

Google AdWords

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

Correções de bugs:

  • Corrigimos as informações sobre 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: * Correção do conflito com o SDK do buffer de protocolo. * Correção do erro do vinculador quando a remoção de código 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, vista (perfil) ou 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

  • O novo recurso accountUserLinks permite que os usuários gerenciem as permissões da conta.
  • Com o novo recurso webpropertyUserLinks, os usuários podem gerenciar as permissões da propriedade.
  • O novo recurso profileUserLinks permite que os usuários gerenciem as permissões da vista (perfil).
  • Agora as permissões para um usuário autorizado estão disponíveis como parte dos recursos de conta, propriedade da Web e vista (perfil).
  • Adicionamos um novo escopo necessário para gerenciar as permissões de usuário. https://www.googleapis.com/auth/analytics.manage.users.
  • Consulte o guia para desenvolvedores sobre o assunto se quiser mais detalhes.

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 mostradas 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 removida. 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 tem 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 permanente. * 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 bugs

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

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

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

Além dos novos segmentos, lançaremos estas mudanças 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 só vai retornar 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 vai continuar retornando os segmentos padrão atuais com os mesmos IDs 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 IDo é definido por padrão com base no método PackageManager#getInstallerPackageName.
    • Dimensão ga:appName – Nome do aplicativo.
    • Dimensão ga:appVersion – Versão do aplicativo.
    • Dimensão ga:exitScreenName – Nome da tela que o usuário visualizava quando saiu do aplicativo.
    • Dimensão ga:landingScreenName – Nome da primeira tela visualizada.
    • Dimensão ga:screenDepth – Número de exibições de tela por sessão informadas como uma string. Pode ser útil para histogramas.
    • Dimensão ga:screenName – Nome da tela.
    • Métrica ga:avgScreenviewDuration – Média de tempo em segundos que os usuários passaram em uma tela.
    • Métrica ga:timeOnScreen – Tempo gasto visualizando a tela atual.
    • Métrica ga:screenviews – Número total de exibições de tela. Use essa métrica em vez de ga:appviews.
    • Métrica ga:uniqueScreenviews – Número de ga:screenviews diferentes (exclusivas) em uma sessão. Use essa métrica em vez de ga:uniqueAppviews.
    • Métrica ga:screenviewsPerSession – Número médio de ga:screenviews por sessão. Use essa métrica em vez de ga:appviewsPerVisit.

Descontinuado

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

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

Colunas ou variáveis personalizadas

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

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

Mudanças na documentação

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

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

E-commerce

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

Exceções

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

Conversões de meta

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

Mudanças na documentação

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

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

Acompanhamento de páginas

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

Plataforma ou dispositivo

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

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

Interações em redes sociais

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

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

Tempo

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

Origens de tráfego

  • Dimensão ga:fullReferrer – URL de referência completo, incluindo nome do host e caminho.
  • Dimensão ga:sourceMedium – valores combinados de ga:source e ga:medium.

Nesta versão, adicionamos 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 categoria/segmento do setor selecionado para uma propriedade.

Correções de bugs:

  • A propriedade eCommerceTracking do recurso de perfil agora condiz com as configurações de e-commerce na seção "Administrador" da interface da Web. Retorna true quando o acompanhamento de e-commerce 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".

  • Adicionamos um novo endpoint à API Management v3 para acessar e modificar os experimentos.

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. * Alguns métodos "track" foram renomeados para "send" (por exemplo, trackView agora é chamado de sendView). * Agora é possível usar moedas locais com Transaction.setCurrencyCode. * Você já pode utilizar HTTPS como 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 interface 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 do app para dispositivos móveis:
    • Métrica ga:uniqueAppviews – número de visualizações do app por sessão.
    • Métrica ga:appviews – Número total de visualizações do app.
    • Métrica ga:appviewsPerVisit – Número médio de visualizações do app por sessão.

Origens de tráfego

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

Atividades em redes sociais

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

Interações em redes sociais

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

Dados geográficos / de rede

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

Acompanhamento de páginas

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

Acompanhamento de exceções

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

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

Velocidade do usuário

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

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

Dispositivo / plataforma

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

Novidades desta versão:

  • Correções de bugs:

    • 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 usar 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 bugs:

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

  • Adicionamos o método de acompanhamento de redes sociais a 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 adicionados ao 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 em redes 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 vão mais ser 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 funis 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 app 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 bugs

  • 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 e-commerce ("transaction" 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 bugs

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

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

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

Novas métricas

  • 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 descontinuação da versão 2.3 da API

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

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

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

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

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

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 as versões 2.4 e 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 muda,ps o nome da API para API Core Reporting. Agora também é necessário registrar os aplicativos. Por fim, a versão 2.3 da API Data Export existente será removida.

Versão 3.0

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

  • Novos recursos

  • Atualizações

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

Versão 2.4

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

  • Atualizações

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

Registro

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

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

Política de cotas

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

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

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

Suspensões de uso

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

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

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

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

Nesta versão, adicionamos 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.

Mudou

  • O tipo de dados de max-results mudou para integer.

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

Correções de bugs

  • 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, foi descontinuada.
  • Já é possível ajustar a taxa de amostragem padrão com a nova função _setSiteSpeedSampleRate.
  • Se um caminho virtual for usado na chamada _trackPageview, ele também vai 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 principal mais recente da nossa API, que não é compatível com as 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
  • Mudanças

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.

  • Mudou

    • 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 descontinuação da versão 2.3 legada da API Management. Ela vai continuar funcionando por dois meses. Depois disso, todas as solicitações feitas na v2.3 vão retornar 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 sem resultados, 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, o script de acompanhamento vai iniciar automaticamente 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.

Mudanças 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) vão continuar funcionando, mas essa ação deixará de ser necessária ao criar um novo site.
  • Agora, o script de acompanhamento vai 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 vão passar 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 inclui várias correções de bugs e refatorações, além de um novo recurso:

  • Agora é possível usar o acompanhamento social (_trackSocial).

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

Descontinuação do intervalo de confiança

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

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

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 mostrar informações mais detalhadas sobre os erros do SQLite3.

Novidades desta versão:

  • Correções de bugs:

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

    • Agora é possível usar o acompanhamento de e-commerce.
    • 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 à API três novas métricas para lidar com o desempenho da velocidade do site:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

Atualizações de métricas

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

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

Os bugs a seguir foram corrigidos nesta versão:

  • Resolvemos 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 os cookies carregarem 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 bugs:

    • 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 a performance do feed de dados e adicionamos novos dados:

Melhoria de desempenho

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

Novas atualizações de dados

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

Próximas alterações

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

  • Atualmente, ga:CTR é um percent e retorna o valor 0,02. Em breve, isso mudará e retornará a porcentagem real (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 solicitações HTTP GET, que só conseguem usar 2.048 caracteres em alguns navegadores e proxies. As solicitações que ultrapassavam 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 pelo HTTP POST, 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.

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

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

Próximas alterações

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

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 informações ao feed de dados:

Novas atualizações de dados

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

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

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

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

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

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

Novas métricas calculadas

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

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

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

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

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

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

Novos recursos

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

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 bugs

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

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

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

Novos feeds

Bibliotecas de 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 seção de documentação para desenvolvedores do Google Analytics que descreve como a nova API Management funciona.

Nesta versão, corrigimos três bugs:

Correções de bugs

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

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

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

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

Novos recursos

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

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

Correções de bugs

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

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 ampliada 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 depois de acordo com o nome. Use essa função 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.
    • Descontinuamos _gaq._getAsyncTracker(name). Use _gat._getTrackerByName.
  • Consulte a Referência do rastreador para ver detalhes sobre essas mudanças 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 até 10.000 solicitações a cada 24 horas.
    • Um aplicativo pode fazer apenas 10 solicitações em um período de 1 segundo.
    • Um aplicativo pode ter apenas quatro solicitações pendentes a qualquer momento.
  • Algumas restrições de combinações de dimensão e métrica foram eliminadas. ga:nextPagePath e ga:previousPagePath agora fazem parte do grupo D3. Content. O grupo D8. Custom Variable agora é chamado de D6. Custom Variable. Consulte o guia de referência atualizado para conferir essas novas combinações.

Correções de bugs

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

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

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

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

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

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

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

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

Suporte para segmentação avançada

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

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

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

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

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

Novos dados de meta disponíveis

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

    • <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 descontinuadas devem ser removidas.

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

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

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

Esta versão inclui 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 foram descontinuadas. 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. Confira a documentação para saber como usar esse snippet.

  • A função _setVar foi descontinuada. 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 fim da lista relacionada. Veja a documentação para mais detalhes.

    • _addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)

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

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

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

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

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

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

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

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

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

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

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

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

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

    • ga:visitLength

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

  • Codificação apropriada para os termos de pesquisas orgânicas, informações sobre o caminho da página da Web para (utmp) e valores definidos pelo usuário utilizados com o recurso do vinculador (ou seja, as funções _link e _linkByPost).
  • O mecanismo Rambler foi adicionado à lista de pesquisas orgânicas.
  • 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) descontinuada 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.
  • Também incluímos uma nova função para permitir a modificação de tempos limite padrão para cookies: _setCookiePersistence(timeout).

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

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

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

  • O feed de conta agora mostra dois novos elementos de dados para cada ID de tabela (moeda e fuso horário).
    <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 descontinuação anteriores entraram em vigor.

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

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

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

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

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

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