Para receber anúncios oficiais da API Google Analytics, inscreva-se no grupo de notificações da API Google Analytics.
25/03/2024 Adicionamos o grupo de canais principal, a origem do tráfego manual e as dimensões específicas da integração.
Grupo de canais principal, origem de tráfego manual e dimensões específicas da integração do CM360, DV360 e SA360 adicionadas ao esquema 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 principal de canais:
firstUserPrimaryChannelGroup
Grupo de canais principal do primeiro usuárioprimaryChannelGroup
grupo principal de canaissessionPrimaryChannelGroup
grupo de canais principal da sessão
Dimensões manuais de origem do tráfego:
manualCampaignId
ID da campanha manualmanualCampaignName
Nome da campanha manualmanualCreativeFormat
Formato do criativo manualmanualMarketingTactic
Estratégia de marketing manualmanualMedium
Mídia manualFonte manual:
manualSource
manualSourceMedium
Origem / mídia manualmanualSourcePlatform
Plataforma de origem de manualfirstUserManualCampaignId
ID da campanha manual do primeiro usuáriofirstUserManualCampaignName
Nome da campanha manual do primeiro usuáriofirstUserManualCreativeFormat
Formato do criativo do manual do primeiro usuáriofirstUserManualMarketingTactic
Estratégia de marketing manual do primeiro usuáriofirstUserManualMedium
Mídia manual do primeiro usuáriofirstUserManualSource
Origem do manual do primeiro usuáriofirstUserManualSourceMedium
Origem / mídia de manual do primeiro usuáriofirstUserManualSourcePlatform
Plataforma de origem do manual do primeiro usuárioID da campanha manual da sessão
sessionManualCampaignId
Nome da campanha manual da sessão
sessionManualCampaignName
Formato do criativo manual da sessão
sessionManualCreativeFormat
Estratégia de marketing manual da sessão
sessionManualMarketingTactic
Mídia manual da sessão
sessionManualMedium
Origem do manual da sessão
sessionManualSource
sessionManualSourceMedium
origem / mídia manual da sessãosessionManualSourcePlatform
Plataforma de origem de manual da sessão
Dimensões de integração do Campaign Manager 360 (CM360):
cm360AccountId
ID da conta do CM360cm360AccountName
Nome da conta do CM360cm360AdvertiserId
ID do anunciante do CM360cm360AdvertiserName
Nome do anunciante do CM360cm360CampaignId
ID da campanha do CM360cm360CampaignName
nome da campanha do CM360cm360CreativeFormat
formato do criativo do CM360cm360CreativeId
ID do criativo do CM360cm360CreativeName
Nome do criativo do CM360cm360CreativeType
tipo de criativo do CM360cm360CreativeTypeId
ID do tipo de criativo do CM360cm360CreativeVersion
versão do criativo do CM360cm360Medium
mídia do CM360cm360PlacementCostStructure
estrutura de custos do canal do CM360cm360PlacementId
ID do canal do CM360cm360PlacementName
nome do canal do CM360cm360RenderingId
ID de renderização do CM360cm360SiteId
ID do site do CM360cm360SiteName
Nome do site do CM360cm360Source
origem do CM360cm360SourceMedium
origem / mídia do CM360firstUserCm360AccountId
ID da conta do primeiro usuário do CM360firstUserCm360AccountName
Nome da conta do primeiro usuário do CM360firstUserCm360AdvertiserId
ID do anunciante do primeiro usuário do CM360firstUserCm360AdvertiserName
Nome do anunciante do primeiro usuário do CM360firstUserCm360CampaignId
ID da campanha do primeiro usuário do CM360firstUserCm360CampaignName
Nome da campanha do primeiro usuário do CM360firstUserCm360CreativeFormat
Formato do criativo do primeiro usuário do CM360firstUserCm360CreativeId
ID do criativo do primeiro usuário do CM360firstUserCm360CreativeName
Nome do criativo do primeiro usuário do CM360firstUserCm360CreativeType
Tipo de criativo do primeiro usuário do CM360firstUserCm360CreativeTypeId
ID do tipo de criativo do primeiro usuário do CM360firstUserCm360CreativeVersion
Versão do criativo do primeiro usuário do CM360firstUserCm360Medium
Mídia do primeiro usuário do CM360firstUserCm360PlacementCostStructure
Estrutura de custos do canal do primeiro usuário do CM360firstUserCm360PlacementId
ID do canal do primeiro usuário do CM360firstUserCm360PlacementName
Nome do canal do primeiro usuário do CM360firstUserCm360RenderingId
ID de renderização do primeiro usuário do CM360firstUserCm360SiteId
ID do site do primeiro usuário do CM360firstUserCm360SiteName
Nome do site do primeiro usuário do CM360firstUserCm360Source
Origem do primeiro usuário do CM360firstUserCm360SourceMedium
Origem / mídia do primeiro usuário do CM360sessionCm360AccountId
ID da conta da sessão do CM360sessionCm360AccountName
Nome da conta da sessão do CM360sessionCm360AdvertiserId
ID do anunciante da sessão do CM360sessionCm360AdvertiserName
Nome do anunciante da sessão do CM360sessionCm360CampaignId
ID da campanha da sessão do CM360sessionCm360CampaignName
Nome da campanha da sessão do CM360sessionCm360CreativeFormat
Formato do criativo da sessão do CM360sessionCm360CreativeId
ID do criativo da sessão do CM360sessionCm360CreativeName
Nome do criativo da sessão do CM360sessionCm360CreativeType
Tipo de criativo da sessão do CM360sessionCm360CreativeTypeId
ID do tipo de criativo da sessão do CM360sessionCm360CreativeVersion
Versão do criativo da sessão do CM360sessionCm360Medium
Mídia da sessão do CM360sessionCm360PlacementCostStructure
Estrutura de custos da posição da sessão do CM360sessionCm360PlacementId
ID da posição da sessão do CM360sessionCm360PlacementName
Nome da posição da sessão do CM360ID de renderização da sessão
sessionCm360RenderingId
do CM360sessionCm360SiteId
ID do site da sessão do CM360sessionCm360SiteName
Nome do site da sessão do CM360sessionCm360Source
Origem da sessão do CM360sessionCm360SourceMedium
origem / mídia da sessão do CM360
Dimensões de integração do Google Display & Video 360 (DV360):
dv360AdvertiserId
ID do anunciante do DV360dv360AdvertiserName
Nome do anunciante do DV360dv360CampaignId
ID da campanha do DV360Nome da campanha
dv360CampaignName
do DV360dv360CreativeFormat
formato do criativo do DV360dv360CreativeId
ID do criativo do DV360dv360CreativeName
Nome do criativo do DV360dv360ExchangeId
ID da troca do DV360dv360ExchangeName
Nome da troca do DV360dv360InsertionOrderId
ID do pedido de inserção do DV360dv360InsertionOrderName
nome do pedido de inserção do DV360dv360LineItemId
ID do item de linha do DV360dv360LineItemName
Nome do item de linha do DV360dv360Medium
mídia do DV360dv360PartnerId
ID do parceiro do DV360dv360PartnerName
Nome do parceiro do DV360dv360Source
origem do DV360dv360SourceMedium
origem / mídia do DV360firstUserDv360AdvertiserId
ID do anunciante do DV360 do primeiro usuáriofirstUserDv360AdvertiserName
Nome do anunciante do DV360 do primeiro usuáriofirstUserDv360CampaignId
ID da campanha do primeiro usuário do DV360firstUserDv360CampaignName
Nome da campanha do primeiro usuário do DV360firstUserDv360CreativeFormat
Formato do criativo do primeiro usuário do DV360firstUserDv360CreativeId
ID do criativo do primeiro usuário do DV360firstUserDv360CreativeName
Nome do criativo do primeiro usuário do DV360firstUserDv360ExchangeId
ID da troca do primeiro usuário do DV360firstUserDv360ExchangeName
Nome da troca do primeiro usuário do DV360firstUserDv360InsertionOrderId
ID do pedido de inserção do DV360 do primeiro usuáriofirstUserDv360InsertionOrderName
Nome do pedido de inserção do DV360 do primeiro usuáriofirstUserDv360LineItemId
ID do item de linha do DV360 do primeiro usuáriofirstUserDv360LinteItemName
Nome do item de linha do primeiro usuário do DV360firstUserDv360Medium
Mídia do primeiro usuário do DV360firstUserDv360PartnerId
ID do parceiro do primeiro usuário do DV360firstUserDv360PartnerName
Nome do parceiro do primeiro usuário do DV360firstUserDv360Source
Origem atribuída ao DV360 do primeiro usuáriofirstUserDv360SourceMedium
Origem / mídia do primeiro usuário do DV360sessionDv360AdvertiserId
ID do anunciante da sessão do DV360sessionDv360AdvertiserName
Nome do anunciante da sessão do DV360sessionDv360CampaignId
ID da campanha da sessão do DV360sessionDv360CampaignName
Nome da campanha da sessão do DV360sessionDv360CreativeFormat
Formato do criativo da sessão do DV360sessionDv360CreativeId
ID do criativo da sessão do DV360sessionDv360CreativeName
Nome do criativo da sessão do DV360sessionDv360ExchangeId
ID da troca da sessão do DV360sessionDv360ExchangeName
Nome da troca da sessão do DV360sessionDv360InsertionOrderId
ID do pedido de inserção da sessão do DV360sessionDv360InsertionOrderName
Nome do pedido de inserção da sessão do DV360sessionDv360LineItemId
ID do item de linha da sessão do DV360sessionDv360LineItemName
Nome do item de linha da sessão do DV360sessionDv360Medium
Mídia da sessão do DV360sessionDv360PartnerId
ID do parceiro da sessão do DV360sessionDv360PartnerName
Nome do parceiro da sessão do DV360sessionDv360Source
origem da sessão do DV360sessionDv360SourceMedium
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 do primeiro usuário do SA360firstUserSa360AdGroupName
Nome do grupo de anúncios do primeiro usuário do SA360firstUserSa360CampaignId
ID da campanha do primeiro usuário do SA360firstUserSa360CampaignName
Campanha do SA360 atribuída ao primeiro usuáriofirstUserSa360CreativeFormat
Formato do criativo do primeiro usuário do SA360firstUserSa360EngineAccountId
ID da conta de mecanismo do primeiro usuário do SA360firstUserSa360EngineAccountName
Nome da conta de mecanismo do primeiro usuário do SA360firstUserSa360EngineAccountType
Tipo da conta de mecanismo do primeiro usuário do SA360firstUserSa360KeywordText
Texto da palavra-chave do primeiro usuário do SA360firstUserSa360ManagerAccountId
ID da conta de administrador do primeiro usuário do SA360firstUserSa360ManagerAccountName
Nome da conta de administrador do primeiro usuário do SA360firstUserSa360Medium
Mídia do SA360 do primeiro usuáriofirstUserSa360Query
Consulta do SA360 do primeiro usuáriofirstUserSa360Source
Origem atribuída ao SA360 do primeiro usuáriofirstUserSa360SourceMedium
Origem / mídia atribuída ao primeiro usuário do SA360sa360AdGroupId
ID do grupo de anúncios do SA360sa360CampaignId
ID da campanha do SA360sa360AdGroupName
Nome do grupo de anúncios do SA360sa360CampaignName
campanha do SA360sa360CreativeFormat
Formato do criativo do SA360sa360EngineAccountId
ID da conta de mecanismo do SA360sa360EngineAccountName
Nome da conta de mecanismo do SA360sa360EngineAccountType
tipo de conta de mecanismo do SA360sa360KeywordText
Texto da palavra-chave do SA360sa360ManagerAccountId
ID da conta de administrador do SA360sa360ManagerAccountName
Nome da conta de administrador do SA360sa360Medium
mídia do SA360sa360Query
consulta do SA360sa360Source
origem do SA360sa360SourceMedium
Origem / mídia do SA360sessionSa360AdGroupId
ID do grupo de anúncios da sessão do SA360sessionSa360CampaignId
ID da campanha da sessão do SA360sessionSa360ManagerAccountId
ID da conta de administrador da sessão do SA360sessionSa360ManagerAccountName
Nome da conta de administrador da sessão do SA360sessionSa360SourceMedium
Origem / mídia da sessão do SA360
06/03/2024 Compatibilidade com públicos-alvo de usuários inativos nas exportações de público-alvo.
O recurso de exportação de públicos-alvo oferece mais suporte à exportação de públicos-alvo de usuários inativos. Os usuários entram nesses públicos-alvo sem um evento qualificado. Por exemplo, o usuário pode entrar no público-alvo ao não visitar seu site por sete dias. Exemplos de públicos-alvo inativos incluem "compradores inativos por sete dias", "usuários inativos por sete dias" e "usuários sem notificações nos últimos sete dias". Consulte Públicos-alvo sugeridos para saber mais sobre eles.
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, essas informações com o User-ID poderão ser enviadas ao Google Analytics na inclusão de tags para melhorar a medição. Para saber mais, consulte Coleta de dados fornecidos pelo usuário.
30/01/2024 Compatibilidade com notificações de webhook para listas de público-alvo e listas de público-alvo recorrentes na API Data v1 Alfa.
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).
Essa funcionalidade permite receber notificações do webhook de forma assíncrona quando uma lista de público-alvo fica disponível.
18/01/2024 Compatibilidade aprimorada para 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 outros campos.
Consulte o Explorador de dimensões e métricas do GA4 para conferir informações abrangentes 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 nas consultas da API Analytics Data usando a seguinte sintaxe:
Nome de API genérico | Descrição |
---|---|
customItem:nome_do_parâmetro | 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 API Data v1 Beta como exportações de público-alvo
O recurso de listas de público-alvo foi renomeado como Exportações de público-alvo e adicionado à API Data v1 Beta.
Os seguintes métodos foram adicionados à API Data v1 Beta:
28/11/2023 Adicionamos samplingMetadatas
à resposta do relatório.
Adição de samplingMetadatas
a
ResponseMetaData
. Essa coleção conterá um SampleMetadata
para cada período na solicitação em que os resultados foram amostrados. O Google Analytics aplica a amostragem somente quando prevê que os limites de cardinalidade reduzem a qualidade dos dados.
28/11/2023 Adicionamos a funcionalidade recorrente de exportação da lista de público-alvo à versão Alfa da API Data v1.
Os métodos properties.recurringAudienceLists.create
, properties.recurringAudienceLists.create
e properties.recurringAudienceLists.list
foram adicionados à API Data v1 Alfa.
Com essa funcionalidade, é possível produzir listas de público-alvo diariamente à medida que as assinaturas de público-alvo mudam. Com as listas de público-alvo recorrentes, você está trabalhando com os resultados mais recentes dessa associação.
08/11/2023 Adicionamos a funcionalidade de exportação da lista de público-alvo para o app Planilhas à versão Alfa da API Data v1.
Adição do método properties.audienceLists.exportSheet
à API Data v1 Alfa, que permite exportar uma lista de público-alvo para as Planilhas Google.
13/10/2023: agora é possível usar públicos-alvo com duração de associação de 1 dia.
Os públicos-alvo com duração de 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 o recurso de exportação de listas de público-alvo seguem as mesmas regras de ordenação que os outros métodos da API Data: a ordem será decrescente pela primeira coluna, depois pela segunda coluna etc.
Antes dessa alteração, você pode ter recebido o seguinte relatório:
deviceId | isAdsPersonalizationAllowed |
---|---|
ABC | verdadeiro |
DAC | false |
ABC | false |
AAA | verdadeiro |
Após a mudança, você receberá o seguinte relatório:
deviceId | isAdsPersonalizationAllowed |
---|---|
AAA | verdadeiro |
ABC | false |
ABC | verdadeiro |
DAC | false |
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 Dimensão currencyCode
adicionada e métrica itemDiscountAmount
currencyCode
O código da 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 "discount".
Para saber mais, consulte o Esquema de relatórios da API Data.
10/08/2023 A dimensão isAdsPersonalizationAllowed
foi adicionada ao esquema de exportação da lista de público-alvo.
isAdsPersonalizationAllowed
A personalização de anúncios é permitida. Se um usuário estiver qualificado para a personalização de anúncios,isAdsPersonalizationAllowed
retornarátrue
. Se um usuário não estiver qualificado para a personalização de anúncios,isAdsPersonalizationAllowed
retornaráfalse
.Para saber mais, consulte Dimensões da lista de público-alvo.
10/07/2023 Listas de público-alvo
Adicionamos suporte às listas de público-alvo à versão Alfa da API Data v1. As listas de público-alvo incluem um resumo dos usuários que estão nele no momento da criação dela.
Os seguintes métodos foram adicionados à API Data v1 Alfa:
19-05-2023 Grupos de canais personalizados
Adicionamos suporte a 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 para cada solicitação foi atualizado de acordo com a alteração da cota e reequilibrado para permitir um número maior de consultas simples de relatórios, ao mesmo tempo em que cobramos muito mais tokens de cota para relatórios grandes.
Após essa mudança, embora a cobrança de algumas solicitações permaneça a mesma, haverá um aumento notável nas cobranças para consultas mais complicadas. Por exemplo, as solicitações de mais de seis meses de dados podem cobrar 1.000 ou mais tokens de cota.
Propriedades padrão
Nome da cota | Limite antigo | Novo limite |
---|---|---|
Tokens principais por propriedade e 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 em tempo real por propriedade e por dia | 25.000 | 200.000 |
Tokens em tempo real por propriedade e por hora | 5.000 | 40.000 |
Tokens em tempo real por projeto, propriedade e hora | 1.750 | 14.000 |
Tokens de funil por propriedade e por 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 Google Analytics 360
Nome da cota | Limite antigo | Novo limite |
---|---|---|
Tokens principais por propriedade e 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 em tempo real por propriedade e por dia | 250.000 | 2.000.000 |
Tokens em tempo real por propriedade e por hora | 50.000 | 400.000 |
Tokens em tempo real por projeto, propriedade e hora | 17.500 | 140.000 |
Tokens de funil por propriedade e por 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 |
2023-03-02 Adicionamos as dimensões de data.
dayOfWeekName
Nome do dia da semana. O dia da semana em inglês. Esta dimensão tem valores deSunday
,Monday
etc.isoWeek
semana ISO do ano. Número da semana ISO, em que cada semana começa na segunda-feira. Para mais detalhes, consulte https://en.wikipedia.org/wiki/ISO_week_date. Exemplos de valores incluem01
,02
e53
.Ano ISO:
isoYear
. O ano ISO do evento. Para mais detalhes, consulte https://en.wikipedia.org/wiki/ISO_week_date. Exemplos de valores incluem2022
e2023
.isoYearIsoWeek
semana ISO do ano ISO. Os valores combinados deisoWeek
eisoYear
. Exemplos de valores incluem201652
e201701
.yearMonth
ano por mês. Os valores combinados deyear
emonth
. Exemplos de valores incluem202212
ou202301
.yearWeek
ano/semana. Os valores combinados deyear
eweek
. Exemplos de valores incluem202253
ou202301
.
27/02/2023 Adicionamos as dimensões de e-commerce.
Posição da lista de
itemListPosition
itens. A posição de um item (por exemplo, um produto que você vende) em uma lista. Essa dimensão é preenchida na inclusão de tags pelo parâmetro "index" na matriz de itens.Código do local do item:
itemLocationID
. O local físico associado ao item (por exemplo, a localização 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 de local personalizado. Esse campo é preenchido na inclusão de tags pelo parâmetro "location_id" na matriz de itens.itemPromotionCreativeSlot
Slot do 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âmetrocreative_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. Caminho da página + string de consulta associados à primeira visualização de página em uma sessão.
Este campo substitui a dimensão landingPage
, que foi descontinuada e será atualizado 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. Quantas telas do app ou páginas da Web seus usuários acessaram 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 para baixo.
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
ouAsia
.ID do continente
continentId
. É o ID geográfico do continente de origem da atividade do usuário, derivado do endereço IP.
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, consulte https://support.google.com/analytics/answer/10108813.
18/10/2022: adicionamos as métricas de anúncios.
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 dos anúncios. Valor total que você pagou pelos seus anúncios.advertiserAdCostPerClick
Custo por clique do Google Ads. O custo por clique dos anúncios é o custo do anúncio dividido pelos cliques nos anúncios e geralmente é abreviado como CPC.advertiserAdCostPerConversion
de custo por conversão. O custo por conversão equivale ao custo do anúncio dividido pelas conversões.advertiserAdImpressions
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 Adicionamos métricas no escopo do item.
itemsAddedToCart
itens adicionados ao carrinho. Número de unidades adicionadas ao carrinho de um único item.itemsCheckedOut
itens comprados. O número de unidades finalizadas para um único item.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
item acessado na lista. Número de unidades visualizadas na lista para um único item.itemsViewedInPromotion
itens acessados na promoção. Número de unidades visualizadas na promoção de um único item.
13/09/2022 Anúncio de mudanças na compatibilidade de esquemas.
Em 1o de dezembro de 2022, vão ocorrer as seguintes mudanças interruptivas:
Dimensões no escopo do item, como
itemName
, estão se tornando incompatíveis com as métricas no escopo do evento, comoeventCount
. As dimensões no escopo do item ainda serão compatíveis com as métricas no escopo do item, comoitemRevenue
, com as métricas com base no usuário (comoactiveUsers
) e com base em sessões (por exemplo,sessions
).Dimensões de atribuição como
source
estão se tornando incompatíveis com algumas métricas no escopo do evento, comoeventCount
. As dimensões de atribuição ainda serão compatíveis com métricas atribuíveis comoconversions
, métricas com base no usuário, comoactiveUsers
, e métricas com base em sessões, comosessions
.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.
Para saber mais, consulte a explicação detalhada das mudanças de compatibilidade.
2022-09-01 Mudanças nas cotas.
As cotas
Requests per day
,Requests Per Minute
eRequests Per Minute Per User
são removidas da API Data.A cota
Tokens Per Project Per Property Per Hour
foi adicionada à API.Cada solicitação consome cota para
Tokens Per Property Per Hour
eTokens Per Project Per Property Per Hour
.Consulte a documentação de cotas para informações detalhadas sobre novas cotas.
03/08/2022 Adicionamos as dimensões do SA360 no escopo da sessão.
sessionSa360AdGroupName
Nome do grupo de anúncios da sessão do SA360. 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 esta sessão.sessionSa360CreativeFormat
Formato do criativo da sessão do SA360. 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 levou a esta sessão.sessionSa360EngineAccountName
Nome da conta de mecanismo da sessão do SA360. O nome da conta de mecanismo no SA360 que levou a esta sessão.sessionSa360EngineAccountType
Tipo da 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 esta sessão.sessionSa360Medium
Mídia do SA360 da sessão. A palavra-chave do mecanismo de pesquisa do Search Ads 360 que levou a esta sessão. Por exemplo, "cpc".sessionSa360Query
Consulta da sessão do SA360. A consulta de pesquisa do Search Ads 360 que levou a esta sessão.sessionSa360Source
Origem do SA360 da sessão. A origem do tráfego do Search Ads 360 que levou a esta sessão. Por exemplo, "example.com" ou "google".As dimensões
sessionCampaignId
esessionCampaignName
agora são compatíveis com 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
A porcentagem de usuários que acionaram qualquer evento de conversão.
Métricas da taxa de conversão de 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.
O método
runFunnelReport
foi adicionado à versão v1alpha da API, que retorna um relatório de funil personalizado com os 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 entrar na versão Beta. Preencha o Feedback sobre os relatórios de funil da API Data do Google Analytics para dar seu feedback sobre a API.
16/02/2022 Adicionamos novas dimensões.
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. Essa dimensão é preenchida pelo parâmetroutm_content
.firstUserManualTerm
Termo manual do primeiro usuário. O termo que conquistou o usuário pela primeira vez. Essa dimensão é preenchida pelo parâmetroutm_term
.manualAdContent
Conteúdo manual do anúncio. O conteúdo do anúncio atribuído ao evento de conversão. Essa dimensão é preenchida pelo parâmetroutm_content
.manualTerm
Termo manual. O termo atribuído ao evento de conversão. Essa dimensão é preenchida pelo parâmetroutm_term
.Conteúdo do anúncio manual da sessão de
sessionManualAdContent
. O conteúdo do anúncio que levou a uma sessão. Essa dimensão é preenchida pelo parâmetroutm_content
.sessionManualTerm
Termo manual da sessão. Termo que levou a uma sessão. Essa dimensão é preenchida pelo parâmetroutm_term
.
Análise de falhas
crashAffectedUsers
Usuários afetados pela falha. O número de usuários que registraram uma falha nesta 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
. 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. 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 7 dias que também são usuários ativos por 1 dia.wauPerMau
WAU / MAU. Porcentagem contínua de usuários ativos por 30 dias que também são usuários ativos por 7 dias.purchaserConversionRate
É a porcentagem de usuários ativos que fizeram uma ou mais transações de compra.transactionsPerPurchaser
de transações por comprador.
Campanha do Google Ads
firstUserGoogleAdsCampaignType
O tipo da campanha do Google Ads que conquistou o usuário pela primeira vez.googleAdsCampaignType
: o tipo da campanha do Google Ads atribuído ao evento de conversão.sessionGoogleAdsCampaignType
O tipo da 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 com 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 de um evento.character
: o personagem do jogador em um jogo de um evento.fileExtension
: a extensão do arquivo transferido por download.fileName
: o caminho da página do arquivo transferido por download.groupId
: o ID do grupo de jogadores em um jogo para um evento.linkClasses
O atributo de classe HTML de um link externo.linkDomain
O domínio de destino do link externo.linkId
O atributo de ID HTML de um link externo ou download de arquivo.linkText
: o texto do link de download do arquivo.linkUrl
O URL completo de um link externo ou download de arquivo.method
: o método que aciona o acionamento de um evento.outbound
Retorna "true" se o link leva a um site 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
O URL de referência completo, incluindo o nome do host e o caminho.percentScrolled
A porcentagem que o usuário rolou para baixo na página (por exemplo, "90").searchTerm
: o termo pesquisado pelo usuário.videoProvider
: é a origem 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.
Mudanças no esquema da API de 07/09/2021.
Mudanças nas dimensões atuais:
unifiedPageScreen
Para eventos gerados pela 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 conquistou o usuário pela primeira vez. Não dependa que esse campo retorne "Manual" para tráfego que usa UTMs. Esse campo vai ser atualizado de "Manual" para "(not set)" em um lançamento futuro de recurso.sessionTrafficOrigin
A origem do tráfego da campanha da sessão. Não dependa que esse campo retorne "Manual" para tráfego que usa UTMs. Esse campo vai ser atualizado de "Manual" para "(not set)" em um lançamento futuro de recurso.trafficOrigin
: a origem do tráfego da campanha do evento de conversão. Não dependa que esse campo retorne "Manual" para tráfego que usa UTMs. Esse campo vai ser atualizado de "Manual" para "(not set)" em um lançamento futuro de recurso.
O método checkCompatibility
2021-09-07 foi 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 em 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 do agrupamento de canais.
Novas dimensões do agrupamento de canais adicionadas ao esquema de relatórios da API Data:
firstUserDefaultChannelGrouping
Agrupamento de canais padrão do primeiro usuário.defaultChannelGrouping
Agrupamento de canais padrão.
Mudanças no esquema da API em 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étodorunRealtimeReport
. Essa dimensão contém o número de minutos atrás em que um evento foi coletado. 00 é o minuto atual e 01 significa o minuto anterior.A dimensão
googleAdsCreativeId
foi adicionada ao esquema da API Data. Essa dimensão contém o ID do criativo do Google Ads atribuído ao evento de conversão.A dimensão
sessionGoogleAdsCreativeId
foi adicionada ao esquema da API Data. Essa dimensão contém o ID do criativo do Google Ads que leva a uma sessão no seu site ou app.Dimensão
firstUserCreativeId
renomeada comofirstUserGoogleAdsCreativeId
no esquema da API Data. Essa dimensão contém o ID do criativo do Google Ads que conquistou o usuário.
09/04/2021 A API Data v1 Beta do Google Analytics foi lançada.
O endpoint da API foi atualizado para
https://analyticsdata.googleapis.com/v1beta
.Os métodos
runReport
,runPivotReport
,batchRunReports
ebatchRunPivotReports
agora aceitam o ID de uma propriedade do Google Analytics 4 no parâmetroproperty
do caminho do URL em vez do campoentity
do corpo de uma 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 da API.
2021-02-19 Mudanças na paginação.
O tamanho da resposta padrão do relatório aumentou de 10 para 10.000 linhas de dados de eventos.
O valor
"limit" : -1
, usado para indicar uma tentativa de recuperar todas as linhas, não é mais compatível com RunReportRequest.O valor máximo do campo
limit
está definido como100000
. 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 da 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
e totalPurchasers
.
08/02/2021 Adicionamos novas dimensões de campanha.
Novas dimensões de campanha foram adicionadas ao esquema da API: campaignId
, campaignName
, googleAdsAccountName
, googleAdsAdGroupId
, googleAdsAdGroupName
, googleAdsAdNetworkType
, source
e trafficOrigin
2021-02-08 dayOfWeek
, week
mudanças na dimensão.
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. 1o de janeiro é sempre a semana 01.
28/01/2021 Adicionamos variantes de agregação para métricas personalizadas.
Cada métrica personalizada registrada por uma propriedade cria três variantes de métrica de API: uma soma, uma média e uma contagem.
28/01/2021: adicionamos novas dimensões de data/hora.
As novas dimensões a seguir foram adicionadas ao esquema da 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 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 em tempo real.
Consulte Como criar um Relatório em tempo real para ver exemplos e runRealtimeReport para ver a documentação de referência da REST.
19/10/2020: os artefatos da biblioteca de cliente foram atualizados.
Os artefatos da biblioteca de cliente foram atualizados com instruções de uso e amostras de código.
13/10/2020: as propriedades App + Web foram renomeadas para Google Analytics 4 (GA4).
Adição do método getMetadata
2020-10-08 à API.
O método getMetadata retorna dimensões e métricas personalizadas disponíveis para o ID da propriedade do GA4 especificado, bem como metadados universais.
08/10/2020 Dimensões e métricas personalizadas estão disponíveis nos relatórios.
Consulte a documentação do esquema de API para ver informações sobre dimensões e métricas personalizadas. Essa atualização inclui dimensões e métricas personalizadas no escopo do evento, além das dimensões personalizadas no escopo do usuário.