Registro de alterações

Para receber comunicados oficiais sobre a API Google Analytics, inscreva-se no grupo de notificações da API Google Analytics.

14/09/2026 Adição de suporte a consultas de conversação na v1 Alfa

Adicionamos o método properties.chat para interagir com os dados do Google Analytics usando consultas em linguagem natural.

14/09/2026 Adição de motivos de truncamento de dados às respostas do relatório

Adição do campo dataTruncationReasons a ResponseMetaData na v1 Beta e v1 Alfa. Quando os dados de um relatório são truncados, esse campo inclui uma lista de objetos DataTruncationReason que incluem o tipo de truncamento, uma mensagem descritiva e as datas afetadas.

23/04/2026 Adição de suporte para relatórios de conversão na v1 Alfa

Adicionamos suporte para recuperar dados do relatório de performance de conversões usando o método runReport na versão Alfa da API Data v1. Isso permite acessar os mesmos dados de conversão disponíveis na interface do Google Analytics em Publicidade > Performance de conversões.

  • Adicionamos o campo ConversionSpec a RunReportRequest, que permite filtrar conversões usando conversionActions (IDs da ação de conversão) e selecionar um AttributionModel (DATA_DRIVEN ou LAST_CLICK).
  • Adicionamos o campo Section a ResponseMetaData para identificar se os dados no relatório são de relatórios padrão (SECTION_REPORT) ou de relatórios de conversão (SECTION_ADVERTISING).

Atualizamos o método getMetadata na versão Alfa da API Data v1 para fornecer informações sobre relatórios de conversão:

  • Adicionamos o campo conversions à resposta, que retorna uma lista de objetos ConversionMetadata mapeando os IDs das ações de conversão para nomes de exibição.
  • Adicionamos o campo sections a DimensionMetadata e MetricMetadata para identificar se um campo específico é compatível com relatórios padrão, relatórios de conversão ou ambos.

20/10/2024 Adicionamos o tipo de filtro de dimensão EmptyFilter

Usando o filtro de dimensão EmptyFilter, é possível criar condições de filtragem para comparar com um valor em branco.

15/10/2024: adicionamos o recurso de nível de amostragem ao método reportTasks.

Usando o campo samplingLevel do método properties.runReportTask, você pode controlar o nível de amostragem do relatório.

Esse recurso dá às propriedades do Google Analytics 360 acesso a limites de amostragem mais altos de 1 bilhão de eventos. Além disso, os limites de amostragem podem ser definidos como UNSAMPLED para resultados não amostrados com grande contagem de eventos.

18/09/2024: adicionamos o recurso de resumo das cotas de propriedade.

Usando o método properties.getPropertyQuotasSnapshot, é possível ver um snapshot atual de todas as cotas de propriedade organizadas por categoria para uma determinada propriedade.

28/06/2024 Adição da cota "erros de cliente por projeto e propriedade"

Agora há um limite de 10.000 erros de servidor de API permitidos por projeto e por propriedade em um período de 15 minutos. Isso inclui todas as solicitações que resultam em uma resposta com qualquer código diferente de 500 ou 200. Exemplos de erros que se enquadram nessa cota: uso de combinações incompatíveis de dimensões e métricas, todos os erros de autenticação.

Se esse limite for excedido, as chamadas de API para essa propriedade serão bloqueadas temporariamente para o projeto na nuvem do Google Cloud associado até que a janela de 15 minutos termine.

14/05/2024 Adição do recurso de comparações

Com as comparações, você pode avaliar subconjuntos de dados lado a lado.

Os métodos de relatórios principais da API Data v1beta foram atualizados para aceitar o campo comparisons que, quando incluído, especifica a configuração das comparações solicitadas.

Em uma solicitação, é possível especificar uma comparação básica, fornecendo a expressão dimensionFilter com uma solicitação, ou usar uma comparação salva, fornecendo o nome do recurso da comparação no campo comparison.

O método getMetadata foi atualizado para listar todas as comparações salvas disponíveis para uma propriedade no campo de resposta comparisons.

Quando pelo menos uma comparação é especificada em uma solicitação, a resposta contém a coluna comparison que identifica cada comparação.

No momento, as comparações salvas só podem ser criadas usando a interface do Google Analytics.

08/05/2024 Adicionamos tarefas de relatório, um recurso de relatórios assíncronos, à API Data v1alpha.

Com as tarefas de relatório, é possível iniciar uma solicitação assíncrona de longa duração para criar um relatório personalizado dos dados de eventos do Google Analytics.

Os seguintes métodos de manipulação de tarefas de relatório foram adicionados à API Data v1alpha:

06/05/2024 Novas dimensões para eventos principais

As dimensões e métricas para eventos principais já estão disponíveis.

Modifique as solicitações de relatório que usam a dimensão isConversionEvent para usar a dimensão isKeyEvent.

Modifique as solicitações de relatório que usam uma métrica descontinuada na tabela a seguir para usar a métrica de evento principal.

Métrica descontinuada Métrica de evento principal
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

Faça modificações semelhantes em qualquer uso de métricas de eventos principais para um evento principal nas suas solicitações de relatório.

A resposta do método properties/getMetadata reflete a introdução de dimensões e métricas de eventos principais nos objetos DimensionMetadata e MetricMetadata da seguinte forma:

  • apiName, uiName e description contêm o nome da API, o nome da interface e a descrição do evento principal.
  • O campo repetido deprecatedApiNames tem uma entrada com o nome da API de conversão descontinuada.

25/03/2024: adicionamos o grupo de canais principal, a origem de tráfego manual e as dimensões específicas de integração.

Grupo de canais principal, origem do tráfego manual e dimensões específicas da integração do CM360, DV360 e SA360 adicionadas ao esquema de API da API Data.

Dimensões de público-alvo:

  • audienceId ID do público-alvo. O identificador numérico de um público-alvo.

Dimensões do grupo de canais principal:

  • firstUserPrimaryChannelGroup Grupo de canais principal do primeiro usuário

  • primaryChannelGroup Grupo de canais principal

  • sessionPrimaryChannelGroup Grupo de canais principal da sessão

Dimensões de origem do tráfego manual:

  • manualCampaignId ID da campanha manual

  • manualCampaignName Nome da campanha manual

  • manualCreativeFormat Formato do criativo manual

  • manualMarketingTactic Ação de marketing manual

  • manualMedium Mídia manual

  • manualSource Origem manual

  • manualSourceMedium Origem / mídia manual

  • manualSourcePlatform Plataforma de origem manual

  • firstUserManualCampaignId ID da campanha manual do primeiro usuário

  • firstUserManualCampaignName Nome da campanha manual atribuída ao primeiro usuário

  • firstUserManualCreativeFormat Formato do criativo manual do primeiro usuário

  • firstUserManualMarketingTactic ação de marketing manual do primeiro usuário

  • firstUserManualMedium Mídia manual do primeiro usuário

  • firstUserManualSource Origem manual do primeiro usuário

  • firstUserManualSourceMedium Origem/mídia manual do primeiro usuário

  • firstUserManualSourcePlatform Plataforma de origem manual do primeiro usuário

  • sessionManualCampaignId ID da campanha manual da sessão

  • sessionManualCampaignName Nome da campanha manual da sessão

  • sessionManualCreativeFormat Formato do criativo manual da sessão

  • sessionManualMarketingTactic Ação de marketing manual da sessão

  • sessionManualMedium Mídia da campanha manual da sessão

  • sessionManualSource Origem manual da sessão

  • sessionManualSourceMedium Origem/mídia manual da sessão

  • sessionManualSourcePlatform Plataforma de origem manual da sessão

Dimensões de integração do Campaign Manager 360 (CM360):

  • cm360AccountId ID da conta do CM360

  • cm360AccountName Nome da conta do CM360

  • cm360AdvertiserId ID do anunciante do CM360

  • cm360AdvertiserName Nome do anunciante do CM360

  • cm360CampaignId ID da campanha do CM360

  • cm360CampaignName Nome da campanha do CM360

  • cm360CreativeFormat Formato do criativo do CM360

  • cm360CreativeId ID do criativo do CM360

  • cm360CreativeName Nome do criativo do CM360

  • cm360CreativeType Tipo de criativo do CM360

  • cm360CreativeTypeId ID do tipo de criativo do CM360

  • cm360CreativeVersion Versão do criativo do CM360

  • cm360Medium Mídia do CM360

  • Estrutura de custos da posição do CM360 de cm360PlacementCostStructure

  • cm360PlacementId ID da posição do CM360

  • cm360PlacementName Nome da posição do CM360

  • cm360RenderingId ID de renderização do CM360

  • cm360SiteId ID do site do CM360

  • cm360SiteName Nome do site do CM360

  • cm360Source Origem do CM360

  • cm360SourceMedium Origem / mídia do CM360

  • firstUserCm360AccountId ID da conta do primeiro usuário do CM360

  • firstUserCm360AccountName Nome da conta do primeiro usuário do CM360

  • firstUserCm360AdvertiserId ID do anunciante do primeiro usuário do CM360

  • firstUserCm360AdvertiserName Nome do anunciante do primeiro usuário do CM360

  • firstUserCm360CampaignId ID da campanha do primeiro usuário do CM360

  • firstUserCm360CampaignName Nome da campanha do primeiro usuário do CM360

  • firstUserCm360CreativeFormat Formato do criativo do primeiro usuário do CM360

  • firstUserCm360CreativeId ID do criativo do primeiro usuário do CM360

  • firstUserCm360CreativeName Nome do criativo do primeiro usuário do CM360

  • firstUserCm360CreativeType Tipo de criativo do primeiro usuário do CM360

  • firstUserCm360CreativeTypeId ID do tipo de criativo do primeiro usuário do CM360

  • firstUserCm360CreativeVersion Versão do criativo do primeiro usuário do CM360

  • firstUserCm360Medium Mídia do primeiro usuário do CM360

  • firstUserCm360PlacementCostStructure Estrutura de custos de canais do primeiro usuário do CM360

  • firstUserCm360PlacementId ID de lugar do primeiro usuário do CM360

  • firstUserCm360PlacementName Nome da posição do primeiro usuário do CM360

  • firstUserCm360RenderingId ID de renderização do primeiro usuário do CM360

  • firstUserCm360SiteId ID do site do primeiro usuário do CM360

  • firstUserCm360SiteName Nome do site do primeiro usuário do CM360

  • firstUserCm360Source Origem do primeiro usuário do CM360

  • firstUserCm360SourceMedium Origem/mídia do primeiro usuário do CM360

  • sessionCm360AccountId ID da conta da sessão do CM360

  • sessionCm360AccountName Nome da conta da sessão do CM360

  • sessionCm360AdvertiserId ID do anunciante da sessão do CM360

  • sessionCm360AdvertiserName Nome do anunciante da sessão do CM360

  • sessionCm360CampaignId ID da campanha da sessão do CM360

  • sessionCm360CampaignName Nome da campanha da sessão do CM360

  • sessionCm360CreativeFormat Formato do criativo da sessão do CM360

  • sessionCm360CreativeId ID do criativo da sessão do CM360

  • sessionCm360CreativeName Nome do criativo da sessão do CM360

  • sessionCm360CreativeType Tipo de criativo da sessão do CM360

  • sessionCm360CreativeTypeId ID do tipo de criativo da sessão do CM360

  • sessionCm360CreativeVersion Versão do criativo da sessão do CM360

  • sessionCm360Medium Mídia da sessão do CM360

  • sessionCm360PlacementCostStructure Estrutura de custos da posição da sessão do CM360

  • sessionCm360PlacementId ID da posição da sessão do CM360

  • sessionCm360PlacementName Nome da posição da sessão do CM360

  • sessionCm360RenderingId ID da renderização da sessão do CM360

  • sessionCm360SiteId ID do site da sessão do CM360

  • sessionCm360SiteName Nome do site da sessão do CM360

  • sessionCm360Source Origem da sessão do CM360

  • sessionCm360SourceMedium Origem / mídia da sessão do CM360

Dimensões de integração do Google Display & Video 360 (DV360):

  • dv360AdvertiserId ID do anunciante do DV360

  • Nome do anunciante do DV360: dv360AdvertiserName

  • dv360CampaignId ID da campanha do DV360

  • dv360CampaignName Nome da campanha do DV360

  • dv360CreativeFormat Formato do criativo do DV360

  • dv360CreativeId ID do criativo do DV360

  • dv360CreativeName Nome do criativo do DV360

  • dv360ExchangeId ID da troca do DV360

  • dv360ExchangeName Nome da troca do DV360

  • dv360InsertionOrderId código do pedido de inserção do DV360

  • dv360InsertionOrderName Nome do pedido de inserção do DV360

  • dv360LineItemId ID do item de linha do DV360

  • dv360LineItemName Nome do item de linha do DV360

  • dv360Medium Mídia do DV360

  • dv360PartnerId ID do parceiro do DV360

  • dv360PartnerName Nome do parceiro do DV360

  • dv360Source Origem do DV360

  • dv360SourceMedium Origem / mídia do DV360

  • firstUserDv360AdvertiserId ID do anunciante do DV360 do primeiro usuário

  • firstUserDv360AdvertiserName Nome do anunciante do DV360 do primeiro usuário

  • firstUserDv360CampaignId ID da campanha do primeiro usuário do DV360

  • firstUserDv360CampaignName Nome da campanha do primeiro usuário do DV360

  • firstUserDv360CreativeFormat Formato do criativo do primeiro usuário do DV360

  • firstUserDv360CreativeId ID do criativo do DV360 do primeiro usuário

  • firstUserDv360CreativeName Nome do criativo do DV360 do primeiro usuário

  • firstUserDv360ExchangeId ID da troca do DV360 do primeiro usuário

  • firstUserDv360ExchangeName Nome da troca do DV360 do primeiro usuário

  • firstUserDv360InsertionOrderId Código do pedido de inserção do DV360 do primeiro usuário

  • firstUserDv360InsertionOrderName Nome do pedido de inserção do DV360 do primeiro usuário

  • firstUserDv360LineItemId ID do item de linha do DV360 do primeiro usuário

  • firstUserDv360LinteItemName Nome do item de linha do DV360 do primeiro usuário

  • firstUserDv360Medium Mídia do primeiro usuário do DV360

  • firstUserDv360PartnerId ID do parceiro do primeiro usuário do DV360

  • firstUserDv360PartnerName Nome do parceiro do primeiro usuário do DV360

  • firstUserDv360Source Origem do primeiro usuário do DV360

  • firstUserDv360SourceMedium Origem/mídia do primeiro usuário do DV360

  • sessionDv360AdvertiserId ID do anunciante da sessão do DV360

  • sessionDv360AdvertiserName Nome do anunciante da sessão do DV360

  • sessionDv360CampaignId ID da campanha da sessão do DV360

  • sessionDv360CampaignName Nome da campanha da sessão do DV360

  • sessionDv360CreativeFormat Formato do criativo da sessão do DV360

  • sessionDv360CreativeId ID do criativo da sessão do DV360

  • sessionDv360CreativeName Nome do criativo da sessão do DV360

  • sessionDv360ExchangeId ID da troca da sessão do DV360

  • sessionDv360ExchangeName Nome da troca da sessão do DV360

  • sessionDv360InsertionOrderId código do pedido de inserção da sessão do DV360

  • sessionDv360InsertionOrderName Nome do pedido de inserção da sessão do DV360

  • sessionDv360LineItemId ID do item de linha da sessão do DV360

  • sessionDv360LineItemName Nome do item de linha da sessão do DV360

  • sessionDv360Medium Mídia da sessão do DV360

  • sessionDv360PartnerId ID do parceiro da sessão do DV360

  • sessionDv360PartnerName Nome do parceiro da sessão do DV360

  • sessionDv360Source Origem da sessão do DV360

  • sessionDv360SourceMedium Origem / mídia da sessão do DV360

Dimensões de integração do Google Search Ads 360 (SA360):

  • firstUserSa360AdGroupId ID do grupo de anúncios atribuído ao primeiro usuário do SA360

  • firstUserSa360AdGroupName Nome do grupo de anúncios do SA360 do primeiro usuário

  • firstUserSa360CampaignId ID da campanha do SA360 do primeiro usuário

  • firstUserSa360CampaignName Campanha do SA360 atribuída ao primeiro usuário

  • firstUserSa360CreativeFormat Formato do criativo do SA360 do primeiro usuário

  • firstUserSa360EngineAccountId ID da conta de mecanismo do SA360 do primeiro usuário

  • firstUserSa360EngineAccountName Nome da conta de mecanismo do SA360 do primeiro usuário

  • firstUserSa360EngineAccountType Tipo de conta de mecanismo do SA360 do primeiro usuário

  • firstUserSa360KeywordText Texto da palavra-chave do SA360 do primeiro usuário

  • firstUserSa360ManagerAccountId ID da conta de administrador do primeiro usuário do SA360

  • firstUserSa360ManagerAccountName Nome da conta de administrador do SA360 atribuída ao primeiro usuário

  • firstUserSa360Medium Mídia do SA360 atribuída ao primeiro usuário

  • firstUserSa360Query Consulta do SA360 do primeiro usuário

  • firstUserSa360Source Origem do SA360 atribuída ao primeiro usuário

  • firstUserSa360SourceMedium Origem/mídia do SA360 atribuída ao primeiro usuário

  • sa360AdGroupId ID do grupo de anúncios do SA360

  • sa360CampaignId ID da campanha do SA360

  • sa360AdGroupName Nome do grupo de anúncios do SA360

  • sa360CampaignName Campanha do SA360

  • sa360CreativeFormat Formato do criativo do SA360

  • sa360EngineAccountId ID da conta de mecanismo do SA360

  • sa360EngineAccountName Nome da conta de mecanismo do SA360

  • sa360EngineAccountType Tipo de conta de mecanismo do SA360

  • sa360KeywordText Texto da palavra-chave do SA360

  • sa360ManagerAccountId ID da conta de administrador do SA360

  • sa360ManagerAccountName Nome da conta de administrador do SA360

  • sa360Medium Mídia do SA360

  • sa360Query Consulta do SA360

  • sa360Source Origem do SA360

  • sa360SourceMedium Origem / mídia do SA360

  • sessionSa360AdGroupId ID do grupo de anúncios do SA360 da sessão

  • sessionSa360CampaignId ID da campanha da sessão do SA360

  • sessionSa360ManagerAccountId ID da conta de administrador do SA360 da sessão

  • sessionSa360ManagerAccountName Nome da conta de administrador do SA360 da sessão

  • sessionSa360SourceMedium Origem / mídia do SA360 da sessão

06/03/2024 Suporte a públicos-alvo de usuários inativos nas exportações de público-alvo.

O recurso de exportação de público-alvo é mais compatível com a exportação de públicos-alvo de usuários inativos. Os usuários entram nesses públicos-alvo sem um evento de qualificação. Por exemplo, o usuário pode entrar no público-alvo se não visitar seu site por sete dias. Exemplos de públicos-alvo de usuários inativos incluem "Compradores inativos por sete dias", "Usuários inativos por sete dias" e "Usuários sem notificações nos últimos sete dias". Para saber mais sobre esses públicos-alvo sugeridos, consulte Públicos-alvo sugeridos.

28/02/2024 As exportações de público-alvo retornam o ID do usuário especificado na inclusão de tags.

As exportações de público-alvo agora retornam o ID do usuário especificado na inclusão de tags, mesmo que os dados fornecidos pelo usuário estejam ativados na sua propriedade. Se a coleta de dados fornecidos pelo usuário estiver ativada, esses dados e o ID do usuário poderão ser enviados ao Google Analytics na inclusão de tags para melhorar a medição. Saiba mais sobre a coleta de dados fornecidos pelo usuário.

30/01/2024 Suporte a notificações de webhook para listas de público-alvo e listas de público-alvo recorrentes na versão Alfa da API Data v1.

Os campos AudienceList.webhookNotification e RecurringAudienceList.webhookNotification podem ser especificados ao criar uma lista de público-alvo (usando properties.audienceLists.create) ou uma lista de público-alvo recorrente (usando properties.recurringAudienceLists.create).

Com essa funcionalidade, você recebe notificações de webhook de forma assíncrona quando uma lista de público-alvo fica disponível.

18/01/2024 Melhoria na compatibilidade de dimensões que incluem a string de consulta ou o componente de minuto.

As dimensões que incluem a string de consulta agora são compatíveis com a maioria dos campos. Dimensões como pagePathPlusQueryString, unifiedPageScreen, pageLocation e fullPageUrl agora são compatíveis com muitos outros campos, incluindo sessionSource, browser, city e landingPage.

As dimensões que incluem o componente de minuto agora são compatíveis com a maioria dos campos. Dimensões como minute, nthMinute e dateHourMinute agora são compatíveis com um conjunto semelhante de campos adicionais.

Consulte a Análise de dimensões e métricas do GA4 para informações completas sobre compatibilidade.

13/12/2023 Parâmetros personalizados no escopo do item

As dimensões personalizadas no escopo do item agora podem ser incluídas em consultas da API Data do Analytics usando a seguinte sintaxe:

Nome genérico da API Descrição
customItem:parameter_name Dimensão personalizada no escopo do item para parameter_name

Consulte as dimensões e métricas da API para mais informações.

05/12/2023: as listas de público-alvo estão disponíveis na versão Beta da API Data v1 como exportações de público-alvo

O recurso Listas de público-alvo foi renomeado como Exportações de público-alvo e adicionado à versão Beta da API Data v1.

Adicionamos os seguintes métodos à versão Beta da API Data v1:

28/11/2023: adição de samplingMetadatas à resposta do relatório.

Adicionamos samplingMetadatas a ResponseMetaData. Essa coleção vai conter um SampleMetadata para cada período na solicitação em que os resultados foram amostrados. O Google Analytics vai aplicar a amostragem somente quando prever que os limites de cardinalidade vão reduzir a qualidade dos dados.

28/11/2023: adicionamos a funcionalidade de exportação recorrente de listas de público-alvo à versão Alfa da API Data v1.

Adicionamos os métodos properties.recurringAudienceLists.create, properties.recurringAudienceLists.create e properties.recurringAudienceLists.list à versão Alfa da API Data v1.

Com essa funcionalidade, é possível produzir listas de público-alvo diariamente à medida que as associações de público-alvo mudam. As listas de público-alvo recorrentes garantem que você trabalhe com os resultados mais recentes de associação de público-alvo.

13/10/2023 Adicionamos suporte para públicos-alvo com duração da associação de 1 dia.

Os públicos-alvo com duração da associação de um dia agora são compatíveis com a funcionalidade de exportação de listas de público-alvo.

12/09/2023 Regras de ordenação padrão da AudienceList

Por padrão, os relatórios criados com a funcionalidade de exportação de listas de público-alvo seguem as mesmas regras de ordenação dos outros métodos de relatório da API Data: a ordenação será decrescente pela primeira coluna, depois pela segunda coluna etc.

Antes dessa mudança, você poderia ter recebido o seguinte relatório:

deviceId isAdsPersonalizationAllowed
ABC verdadeiro
DAC falso
ABC falso
AAA verdadeiro

Após essa mudança, você vai receber o seguinte relatório:

deviceId isAdsPersonalizationAllowed
AAA verdadeiro
ABC falso
ABC verdadeiro
DAC falso

15/08/2023 Adicionamos a dimensão isLimitedAdTracking ao esquema de exportação da lista de público-alvo.

  • isLimitedAdTracking A configuração "Limitar o rastreamento de anúncios" do dispositivo. Os valores possíveis incluem: true, false e (not set).

    Para saber mais, consulte Dimensões da lista de público-alvo.

15/08/2023 Adicionamos a dimensão currencyCode e a métrica itemDiscountAmount

  • currencyCode É o código de moeda local (com base no padrão ISO 4217) do evento de e-commerce. Por exemplo, "USD" ou "GBP".

  • itemDiscountAmount O valor monetário dos descontos de itens em eventos de e-commerce. Essa métrica é preenchida na inclusão de tags pelo parâmetro de item "discount".

Para saber mais, consulte o esquema de relatórios da API Data.

10/08/2023 Adição da dimensão isAdsPersonalizationAllowed ao esquema de exportação da lista de público-alvo

  • isAdsPersonalizationAllowed Se a personalização de anúncios é permitida. Se um usuário estiver qualificado para a personalização de anúncios, isAdsPersonalizationAllowed vai retornar true. Se um usuário não for elegível para personalização de anúncios, isAdsPersonalizationAllowed retorna false.

    Para saber mais, consulte Dimensões da lista de público-alvo.

10/07/2023 Listas de público-alvo

Suporte para listas de público-alvo adicionado à versão Alfa da API Data v1. As listas de público-alvo incluem um resumo dos usuários no público-alvo no momento da criação da lista.

Os seguintes métodos foram adicionados à versão Alfa da API Data v1:

19/05/2023 Grupos de canais personalizados

Adicionamos suporte aos grupos de canais personalizados à API Data.

11/05/2023 Mudanças na cota de tokens.

O sistema de cotas da API Data foi atualizado para permitir cobranças mais precisas.

O número de tokens cobrados por cada solicitação foi atualizado de acordo com a mudança na cota e reequilibrado para permitir um número maior de consultas de relatórios simples, enquanto cobra significativamente mais tokens de cota para relatórios de datas grandes.

Após essa mudança, embora a cobrança de algumas solicitações permaneça a mesma, haverá um aumento perceptível nas cobranças de consultas mais complicadas. Por exemplo, solicitações de dados de mais de seis meses podem cobrar 1.000 ou mais tokens de cota.

Propriedades padrão

Nome da cota Limite antigo Novo limite
Tokens principais por propriedade por dia 25.000 200.000
Tokens principais por propriedade e hora 5.000 40.000
Tokens principais por projeto, propriedade e hora 1.750 14.000
Tokens da API Realtime por propriedade e dia 25.000 200.000
Tokens em tempo real por propriedade e hora 5.000 40.000
Tokens em tempo real por projeto, propriedade e hora 1.750 14.000
Tokens de funil por propriedade e dia 25.000 200.000
Tokens de funil por propriedade e hora 5.000 40.000
Tokens de funil por projeto, propriedade e hora 1.750 14.000

Propriedades do Analytics 360

Nome da cota Limite antigo Novo limite
Tokens principais por propriedade por dia 250.000 2.000.000
Tokens principais por propriedade e hora 50.000 400.000
Tokens principais por projeto, propriedade e hora 17.500 140.000
Tokens da API Realtime por propriedade e dia 250.000 2.000.000
Tokens em tempo real por propriedade e hora 50.000 400.000
Tokens em tempo real por projeto, propriedade e hora 17.500 140.000
Tokens de funil por propriedade e dia 250.000 2.000.000
Tokens de funil por propriedade e hora 50.000 400.000
Tokens de funil por projeto, propriedade e hora 17.500 140.000

02/03/2023: adicionamos dimensões de data.

  • dayOfWeekName Nome do dia da semana. O dia da semana em inglês. Essa dimensão tem valores de Sunday, Monday etc.

  • isoWeek Semana ISO do ano. Número da semana no formato ISO, em que cada semana começa na segunda-feira. Para mais detalhes, acesse https://en.wikipedia.org/wiki/ISO_week_date. Exemplos de valores incluem 01, 02 e 53.

  • isoYear Ano ISO. O ano ISO do evento. Para mais detalhes, acesse https://en.wikipedia.org/wiki/ISO_week_date. Exemplos de valores incluem 2022 e 2023.

  • isoYearIsoWeek Semana ISO do ano ISO. Os valores combinados de isoWeek e isoYear. Exemplos de valores incluem 201652 e 201701.

  • yearMonth Ano e mês. Os valores combinados de year e month. Exemplos de valores incluem 202212 ou 202301.

  • yearWeek Ano e semana. Os valores combinados de year e week. Exemplos de valores incluem 202253 ou 202301.

27/02/2023: adicionamos dimensões de e-commerce.

  • itemListPosition Posição na lista de itens. A posição de um item (por exemplo, um produto que você vende) em uma lista. Essa dimensão é preenchida na codificação pelo parâmetro "index" na matriz "items".

  • itemLocationID ID do local do item. O local físico associado ao item (por exemplo, o local da loja física). É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID do local personalizado. Esse campo é preenchido na codificação pelo parâmetro "location_id" na matriz de itens.

  • itemPromotionCreativeSlot Slot de criativo da promoção do item. Nome do slot do criativo promocional associado ao item. Essa dimensão pode ser especificada na inclusão de tags pelo parâmetro creative_slot no nível do evento ou do item. Se o parâmetro for especificado no nível do evento e do item, o parâmetro no nível do item será usado.

21/02/2023 Adicionamos a dimensão "Página de destino + string de consulta".

  • landingPagePlusQueryString Página de destino + string de consulta. O caminho da página + string de consulta associados à primeira visualização de página em uma sessão.

Esse campo substitui a dimensão landingPage, que foi descontinuada e será atualizada para não retornar uma string de consulta em 14 de maio de 2023.

28/01/2023 Adicionamos as métricas "Visualizações por usuário" e "Usuários que rolaram a tela".

  • screenPageViewsPerUser Visualizações por usuário. O número de telas do app ou páginas da Web que seus usuários visualizaram por usuário ativo. Visualizações repetidas de uma única página ou tela são consideradas. (screen_view + page_view events) / active users.

  • scrolledUsers Usuários que rolaram a tela. O número de usuários únicos que rolaram pelo menos 90% da página.

23/01/2023 Adicionamos as dimensões "Continente" e "ID do continente".

  • continent Continente. Continente de origem da atividade do usuário. Por exemplo, Americas ou Asia.

  • continentId ID do continente. É o ID geográfico do continente de origem da atividade do usuário, derivado do endereço IP dele.

23/01/2023 Adicionamos a dimensão "ID do filtro de dados de teste".

  • testDataFilterId ID do filtro de dados de teste. O identificador numérico de um filtro de dados em estado de teste. Use filtros de dados para incluir ou excluir dados de eventos dos seus relatórios com base nos respectivos valores de parâmetro. Para saber mais, acesse https://support.google.com/analytics/answer/10108813.

18/10/2022: adição de métricas do Google Ads.

  • advertiserAdClicks cliques no anúncio. Número total de vezes que os usuários clicaram em um anúncio para acessar a propriedade.
  • advertiserAdCost Custo do Google Ads. Valor total que você pagou pelos seus anúncios.
  • advertiserAdCostPerClick Custo por clique do Google Ads. O custo por clique no anúncio é o custo do anúncio dividido pelos cliques no anúncio e geralmente é abreviado como CPC.
  • advertiserAdCostPerConversion Custo por conversão. O custo por conversão é o custo do anúncio dividido pelas conversões.
  • advertiserAdImpressions de impressões de anúncios. O número total de impressões.
  • returnOnAdSpend Retorno do investimento em publicidade. O retorno do investimento em publicidade (ROAS) é a receita total dividida pelo custo de publicidade do anunciante.

17/10/2022 Adição de métricas no escopo do item.

  • itemsAddedToCart itens adicionados ao carrinho. O número de unidades adicionadas ao carrinho para um único item.
  • itemsCheckedOut itens com compra finalizada. Número de unidades de um único item que foram compradas.
  • itemsClickedInList Itens clicados na lista. Número de unidades clicadas na lista para um único item.
  • itemsClickedInPromotion Itens clicados na promoção. Número de unidades clicadas na promoção de um único item.
  • itemsViewed itens acessados. Número de unidades visualizadas de um único item.
  • itemsViewedInList itens acessados na lista. O número de unidades visualizadas na lista de um único item.
  • itemsViewedInPromotion Itens visualizados na promoção. Número de unidades visualizadas em uma promoção de um único item.

13/09/2022: anúncio de mudanças na compatibilidade de esquemas.

Em 1º de dezembro de 2022, as seguintes alterações interruptivas vão ocorrer:

  1. As dimensões no escopo do item, como itemName, estão se tornando incompatíveis com as métricas no escopo do evento, como eventCount. As dimensões no escopo do item ainda serão compatíveis com métricas no escopo do item, como itemRevenue, métricas baseadas no usuário, como activeUsers, e métricas baseadas na sessão, como sessions.

  2. As dimensões de atribuição, como source, estão se tornando incompatíveis com algumas métricas no escopo do evento, como eventCount. As dimensões de atribuição ainda serão compatíveis com métricas atribuíveis, como conversions, métricas baseadas no usuário, como activeUsers, e métricas baseadas na sessão, como sessions.

  3. As dimensões que incluem a string de consulta, como pagePathPlusQueryString, só serão compatíveis com um conjunto limitado de dimensões e métricas.

01/09/2022 Mudanças nas cotas.

  • As cotas Requests per day, Requests Per Minute e Requests Per Minute Per User foram removidas da API Data.

  • A cota de Tokens Per Project Per Property Per Hour foi adicionada à API.

  • Cada solicitação consome cota para Tokens Per Property Per Hour e Tokens Per Project Per Property Per Hour.

    Consulte a documentação de cotas para informações detalhadas sobre as novas cotas.

03/08/2022 Adicionamos dimensões do SA360 com escopo de sessão.

  • sessionSa360AdGroupName Nome do grupo de anúncios do SA360 da sessão. O nome do grupo de anúncios do Search Ads 360 que levou a essa sessão.

  • sessionSa360CampaignName Campanha do SA360 da sessão. O nome da campanha do Search Ads 360 que levou a essa sessão.

  • sessionSa360CreativeFormat Formato do criativo do SA360 da sessão. O tipo de criativo no Search Ads 360 que levou a essa sessão. Por exemplo, "Anúncio responsivo de pesquisa" ou "Anúncio de texto expandido".

  • sessionSa360EngineAccountId ID da conta de mecanismo da sessão do SA360. O ID da conta de mecanismo no SA360 que resultou nessa sessão.

  • sessionSa360EngineAccountName Nome da conta de mecanismo do SA360 da sessão. O nome da conta de mecanismo no SA360 que resultou nessa sessão.

  • sessionSa360EngineAccountType Tipo de conta de mecanismo do SA360 da sessão. O tipo de conta de mecanismo no Search Ads 360 que levou a essa sessão. Por exemplo, "google ads", "bing" ou "baidu".

  • sessionSa360Keyword Texto da palavra-chave do SA360 da sessão. A palavra-chave do mecanismo de pesquisa do Search Ads 360 que levou a essa sessão.

  • sessionSa360Medium Mídia da sessão do SA360. A palavra-chave do mecanismo de pesquisa do Search Ads 360 que levou a essa sessão. Por exemplo, "cpc".

  • sessionSa360Query Consulta do SA360 da sessão. A consulta de pesquisa do Search Ads 360 que levou a essa sessão.

  • sessionSa360Source Origem da sessão do SA360. A origem do tráfego do Search Ads 360 que levou a essa sessão. Por exemplo, "example.com" ou "google".

  • As dimensões sessionCampaignId e sessionCampaignName agora são compatíveis com as campanhas do Search Ads 360.

11/07/2022: adicionamos métricas de taxa de conversão.

Taxa de conversão

  • sessionConversionRate A porcentagem de sessões em que algum evento de conversão foi acionado.

  • userConversionRate: porcentagem de usuários que acionaram algum evento de conversão.

Métricas de taxa de conversão para uma conversão

  • sessionConversionRate:event_name A porcentagem de sessões em que um evento de conversão específico foi acionado.

  • userConversionRate:event_name A porcentagem de usuários que acionaram um evento de conversão específico.

05/05/2022: adicionamos a funcionalidade de relatórios de funil ao canal Alfa.

  • Método runFunnelReport adicionado à versão v1alpha da API, que retorna um relatório de funil personalizado dos dados de eventos do Google Analytics.

  • Esse método é introduzido na estabilidade Alfa com a intenção de coletar feedback sobre a sintaxe e os recursos antes de chegar à versão Beta. Preencha o Feedback de relatório do funil da API Google Analytics Data para enviar sua opinião sobre ela.

16/02/2022 Novas dimensões foram adicionadas.

Termo e conteúdo manuais

  • firstUserManualAdContent Conteúdo do anúncio manual do primeiro usuário. O conteúdo do anúncio que conquistou o usuário pela primeira vez. Preenchida pelo parâmetro utm_content.

  • firstUserManualTerm Termo manual do primeiro usuário. O termo que conquistou o usuário pela primeira vez. Preenchida pelo parâmetro utm_term.

  • manualAdContent Conteúdo do anúncio manual. O conteúdo do anúncio atribuído ao evento de conversão. Preenchida pelo parâmetro utm_content.

  • manualTerm Termo manual. O termo atribuído ao evento de conversão. Preenchida pelo parâmetro utm_term.

  • sessionManualAdContent Conteúdo do anúncio manual da sessão. O conteúdo do anúncio que levou a uma sessão. Preenchida pelo parâmetro utm_content.

  • sessionManualTerm Termo manual da sessão. O termo que levou a uma sessão. Preenchida pelo parâmetro utm_term.

Análise de falhas

  • crashAffectedUsers Usuários afetados por falhas. É o número de usuários que registraram uma falha nessa linha do relatório.

  • crashFreeUsersRate Taxa de usuários sem falhas.

App/Web

  • averageSessionDuration A duração média (em segundos) das sessões dos usuários.

  • newVsReturning Usuários novos / recorrentes.

  • screenPageViewsPerSession Visualizações por sessão.

  • landingPage Página de destino. O caminho da página + string de consulta associados à primeira visualização de página em uma sessão.

  • platformDeviceCategory A plataforma e o tipo de dispositivo em que seu site ou app para dispositivos móveis foi executado.

App para dispositivos móveis

  • averagePurchaseRevenuePerUser Receita média de compra por usuário.

  • firstTimePurchaserConversionRate É a porcentagem de usuários ativos que fizeram a primeira compra.

  • firstTimePurchasersPerNewUser O número médio de novos compradores por novo usuário.

  • dauPerMau DAU / MAU. A porcentagem contínua de usuários ativos por 30 dias que também são usuários ativos por 1 dia.

  • dauPerWau DAU / WAU. Porcentagem contínua de usuários ativos por sete dias que também são usuários ativos por um dia.

  • wauPerMau WAU / MAU. Porcentagem contínua de usuários ativos por 30 dias que também são usuários ativos por sete dias.

  • purchaserConversionRate É a porcentagem de usuários ativos que fizeram uma ou mais transações de compra.

  • transactionsPerPurchaser Transações por comprador.

Campanha do Google Ads

  • firstUserGoogleAdsCampaignType O tipo de campanha do Google Ads que conquistou o usuário pela primeira vez.

  • googleAdsCampaignType O tipo de campanha do Google Ads atribuído ao evento de conversão.

  • sessionGoogleAdsCampaignType O tipo de campanha do Google Ads que levou a essa sessão.

07/09/2021 Adicionamos novas dimensões de data/hora.

  • dateHourMinute Os valores combinados de data, hora e minuto formatados como AAAAMMDDHHMM.

  • minute O minuto de dois dígitos da hora em que o evento foi registrado.

  • nthMinute O número de minutos desde o início do período.

07/09/2021 Adicionamos novas dimensões preenchidas por parâmetros de evento.

  • achievementId O ID da conquista em um jogo para um evento.

  • character O personagem do jogador em um jogo para um evento.

  • fileExtension A extensão do arquivo baixado.

  • fileName: o caminho da página do arquivo baixado.

  • groupId O ID do grupo de jogadores em um jogo para um evento.

  • linkClasses O atributo HTML class de um link externo.

  • linkDomain O domínio de destino do link externo.

  • linkId O atributo HTML id de um link externo ou download de arquivo.

  • linkText O texto do link de download de um arquivo.

  • linkUrl O URL completo de um link externo ou de download de um arquivo.

  • method O método pelo qual um evento foi acionado.

  • outbound Retorna "true" se o link leva a um site que não faz parte do domínio da propriedade.

  • pageLocation O protocolo, o nome do host, o caminho da página e a string de consulta das páginas da Web visitadas.

  • pageReferrer URL de referência completo, incluindo nome do host e caminho.

  • percentScrolled A porcentagem da tela que o usuário rolou para baixo (por exemplo, "90").

  • searchTerm O termo pesquisado pelo usuário.

  • videoProvider Fonte do vídeo (por exemplo, "youtube").

  • videoTitle O título do vídeo.

  • videoUrl O URL do vídeo.

  • visible Retorna "true" se o conteúdo estiver visível.

  • unifiedPagePathScreen O caminho da página (Web) ou a classe da tela (app) em que o evento foi registrado.

07/09/2021: mudanças no esquema de API.

Mudanças nas dimensões atuais:

  • unifiedPageScreen Para eventos gerados na Web, essa dimensão agora retorna o caminho da página e a string de consulta em que o evento foi registrado.

Aviso sobre as próximas mudanças:

  • firstUserTrafficOrigin A origem do tráfego que atraiu o usuário pela primeira vez. Não dependa do retorno "Manual" desse campo para o tráfego que usa UTMs. Esse campo vai deixar de retornar "Manual" e passará a retornar "(not set)" em um próximo lançamento de recurso.

  • sessionTrafficOrigin A origem do tráfego da campanha da sessão. Não dependa do retorno "Manual" desse campo para o tráfego que usa UTMs. Esse campo vai deixar de retornar "Manual" e passará a retornar "(not set)" em um lançamento de recurso futuro.

  • trafficOrigin A origem do tráfego da campanha do evento de conversão. Não dependa do retorno "Manual" desse campo para o tráfego que usa UTMs. Esse campo vai deixar de retornar "Manual" e passará a retornar "(not set)" em um lançamento de recurso futuro.

07/09/2021 Método checkCompatibility adicionado à API.

O método checkCompatibility lista dimensões e métricas que podem ser adicionadas a uma solicitação de relatório e manter a compatibilidade.

21/07/2021 Mudanças nos relatórios de tempo real.

Agora é possível especificar os intervalos de minutos dos dados de eventos a serem lidos usando o parâmetro minuteRanges do método runRealtimeReport.

21/07/2021 Novas dimensões de agrupamento de canais.

Novas dimensões de agrupamento de canais adicionadas ao esquema de relatórios da API Data:

  • firstUserDefaultChannelGrouping Agrupamento padrão de canais do primeiro usuário.

  • defaultChannelGrouping Agrupamento de canais padrão.

Mudanças no esquema de API de 10/06/2021.

  • A dimensão minutesAgo foi adicionada ao esquema em tempo real da API Data e pode ser usada em consultas ao método runRealtimeReport. Essa dimensão contém o número de minutos atrás em que um evento foi coletado. 00 é o minuto atual, e 01 é o minuto anterior.

  • A dimensão googleAdsCreativeId foi adicionada ao esquema de API Data. Essa dimensão contém o ID do criativo do anúncio do Google Ads atribuído ao evento de conversão.

  • A dimensão sessionGoogleAdsCreativeId foi adicionada ao esquema de API Data. Essa dimensão contém o ID do criativo do anúncio do Google Ads que levou a uma sessão no seu site ou app.

  • A dimensão firstUserCreativeId foi renomeada como firstUserGoogleAdsCreativeId no esquema da API Data. Essa dimensão contém o ID do criativo do Google Ads que conquistou o usuário pela primeira vez.

09/04/2021: a versão Beta da API Google Analytics Data v1 foi lançada.

  • O endpoint de API foi atualizado para https://analyticsdata.googleapis.com/v1beta.

  • Os métodos runReport, runPivotReport, batchRunReports e batchRunPivotReports agora aceitam o ID de uma propriedade do Google Analytics 4 no parâmetro property do caminho do URL, em vez do campo entity de um corpo de solicitação:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • As bibliotecas de cliente da API foram atualizadas para usar o novo endpoint de API.

19/02/2021 Mudanças na paginação.

  • O tamanho padrão da resposta do relatório aumentou de 10 para 10.000 linhas de dados de eventos.

  • O valor "limit" : -1 que era usado para indicar uma tentativa de recuperar todas as linhas não é mais aceito em RunReportRequest.

  • O valor máximo do campo limit é definido como 100000. Use a paginação para recuperar relatórios com mais de 100.000 linhas.

08/02/2021 Novas dimensões e métricas de e-commerce.

Novas dimensões e métricas de e-commerce foram adicionadas ao esquema de API:

Dimensões: adFormat, adSourceName, adUnitName, itemBrand, itemCategory, itemCategory2, itemCategory3, itemCategory4, itemCategory5 itemId, itemListId, itemListName, itemName, itemPromotionCreativeName, itemPromotionId, itemPromotionName, orderCoupon, transactionId.

Métricas: adUnitExposure, addToCarts, cartToViewRate, checkouts, ecommercePurchases, firstTimePurchasers, itemListClickThroughRate, itemListClicks, itemListViews, itemPromotionClickThroughRate, itemPromotionClicks, itemPromotionViews, itemPurchaseQuantity, itemRevenue, itemViews, publisherAdClicks, publisherAdImpressions, totalPurchasers.

08/02/2021 Adicionamos novas dimensões de campanha.

Novas dimensões de campanha foram adicionadas ao esquema de API: campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

08/02/2021: mudanças nas dimensões dayOfWeek e week.

  • O valor da dimensão dayOfWeek agora começa com 0 em vez de 1.

  • O valor da dimensão week agora começa com 01 e retorna um número de dois dígitos de 01 a 53. Toda semana começa no domingo. O dia 1º de janeiro está sempre na semana 01.

28/01/2021 Adição de variantes de agregação para métricas personalizadas.

Cada métrica personalizada registrada por uma propriedade cria três variantes de métrica da API: uma soma, uma média e uma contagem.

28/01/2021 Adicionamos novas dimensões de data/hora.

As seguintes dimensões foram adicionadas ao esquema de API: hour, nthHour, nthYear, dateHour.

28/01/2021: a API Data reduziu os tokens de cota cobrados por consulta.

A API Data reduziu os tokens de cota cobrados por consulta. Os limites de cota para tokens de cota de propriedade por hora e por dia não foram alterados.

09/11/2020 O método getUniversalMetadata foi excluído.

O método getUniversalMetadata foi excluído. Use getMetadata. O período máximo de um ano por solicitação de API foi removido.

02/11/2020: adicionamos um método de Relatório de tempo real.

Consulte Como criar um relatório de tempo real para ver exemplos e runRealtimeReport para acessar a documentação de referência da REST.

19/10/2020: artefatos da biblioteca de cliente atualizados.

Artefatos da biblioteca de cliente atualizados com instruções de uso e exemplos de código.

13/10/2020 As propriedades App + Web foram renomeadas para Google Analytics 4 (GA4).

08/10/2020 Método getMetadata adicionado à API.

O método getMetadata retorna dimensões e métricas personalizadas disponíveis para o ID da propriedade do GA4 especificado, além de metadados universais.

08/10/2020 As dimensões e métricas personalizadas estão disponíveis nos relatórios.

Consulte a documentação do esquema de API para saber mais sobre dimensões e métricas personalizadas. Essa atualização inclui dimensões e métricas personalizadas no escopo do evento, além de dimensões personalizadas no escopo do usuário.