Metrics
Métricas do Google Analytics 4 pela API
Seu cliente conecta a conta do Google Analytics 4 e seu produto consulta 95 métricas pelo mesmo endpoint das outras plataformas. Cada métrica tem um identificador (reference_key) que vai na chamada.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "google_analytics_4:all_sessions",
"component": "number_v1",
"metrics": [
"sessions"
]
}
]
}Mais exemplos de chamadas no Google Analytics 4
O mesmo endpoint para cada tipo de métrica. Os campos metrics e dimensions de cada item vêm do catálogo da plataforma (GET /api/metrics/{integration_slug}).
Gráfico
Gênero do Visitante
Esse gráfico mostra o número de visitantes, agrupados pelo gênero.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "google_analytics_4:gender",
"component": "chart_v1",
"metrics": [
"totalUsers"
],
"dimensions": [
"userGender"
]
}
]
}Tabela
Países em destaque
Países com a maior quantidade de sessões durante o período analisado.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "google_analytics_4:countries",
"component": "datatable_v1",
"metrics": [
"engagedSessions",
"activeUsers"
],
"dimensions": [
"country"
]
}
]
}Número
Conferiu Produto
Number of users who viewed an item.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "google_analytics_4:view_product",
"component": "number_v1",
"metrics": [
"itemViewEvents"
]
}
]
}Números
52 métricas
Sessões
Este é o número total de usuários únicos que registraram um evento. Uma Sessão é um grupo de interações do usuário com seu site que ocorreram dentro de um período de tempo específico. Por exemplo, uma única sessão pode conter múltiplas visualizações de página, eventos, interações sociais e transações de e-commerce.
google_analytics_4:all_sessionsConferiu Produto
Number of users who viewed an item.
google_analytics_4:view_productCarrinhos abandonados
Number of times visitors added products to their shopping cart during a session but did not complete the transaction, abandoning the purchase process before completing it.
google_analytics_4:abandoned_cartsUsuários Ativos
Número total de usuários ativos que interagiram com seu site ou app durante o período de análise.
google_analytics_4:all_usersUsuários Retornantes
Número de usuários que tiveram uma ou mais sessões anteriores em seu site ou app durante o período de análise.
google_analytics_4:returning_usersTotal de Usuários
Este é o número total de usuários únicos que registraram pelo menos um evento durante o período de análise. Esta métrica é estimada pela rede.
google_analytics_4:total_usersNovos usuários
Número de novos usuários que interagiram com seu site ou acessaram seu App pela primeira vez, durante o período de análise.
google_analytics_4:new_usersVisualizações
Número total de páginas visualizadas durante o período analisado. As visualizações repetidas de uma única página são contadas.
google_analytics_4:all_pageviewsVisualizações por usuário ativo
Número médio de páginas visitadas por usuário ativo no período selecionado. É a divisão de Visualizações pelo número de usuários ativos.
google_analytics_4:all_pageviews_per_active_userVisualizações por sessão
Número médio de páginas visitadas por sessão, incluindo visitas repetidas à mesma página. É a divisão de Visualizações pelo número de sessões.
google_analytics_4:pageview_sessionContagem de eventos
Número de vezes que os usuários acionaram os eventos durante o período selecionado. Um evento permite medir uma interação específica dos usuários em sites ou apps, como carregar uma página, clicar em um link e concluir uma compra
google_analytics_4:event_countContagem de eventos por usuário ativo
Número médio de eventos acionados por usuário ativo no período selecionado. É a divisão de Contagem de Eventos pelo número de usuários ativos.
google_analytics_4:event_count_per_active_userTaxa de eventos principais do usuário
Porcentagem de usuários ativos que acionaram o evento chave durante o período selecionado. É a divisão do número de usuários que acionaram o evento chave pelo número de usuários ativos.
google_analytics_4:user_key_event_rate_per_active_userTaxa de eventos principais da sessão
Porcentagem de sessões que acionaram o evento chave durante o período selecionado. É a divisão do número de sessões que acionaram o evento chave pelo número de sessões.
google_analytics_4:session_key_event_rateNovos compradores
Número de usuários que concluíram o primeiro evento de compra.
google_analytics_4:first_time_purchasersTotal de compradores
Número total de usuários que registraram eventos de compras durante o período de análise.
google_analytics_4:total_purchasersTaxa de conversão do comércio eletrônico
A porcentagem de sessões (visitas ao site) que resultam em compras
google_analytics_4:conversion_rateSessões para transação
O número de sessões entre as compras dos usuários e as campanhas relacionadas que levam às compras.
google_analytics_4:sessions_to_transactionEvento Principal
Número de vezes que os usuários acionam eventos principais durante o período analisado.
google_analytics_4:conversions_countTransações
Número total de compras feitas através do site.
google_analytics_4:transactions_countQuantidade adicionada ao carrinho
O número de vezes que os usuários adicionaram artigos aos carrinhos de compras durante o período de análise.
google_analytics_4:quantity_added_to_cartCompras iniciadas
Número de vezes que os usuários iniciaram o processo de finalização da compra.
google_analytics_4:quantity_checked_outCompras
O número total de compras no seu site ou aplicativo durante o período analisado.
google_analytics_4:ecommerce_purchase_amountReceita média de compra
A receita média de compra do grupo de transações de eventos, durante o intervalo de datas especificado.
google_analytics_4:average_purchase_revenueItens comprados
O número total de itens comprados durante o período do relatório.
google_analytics_4:items_purchasedTaxa de engajamento
Porcentagem de sessões engajadas. Sessões em que o usuário ficou ativo por mais de 10 segundos, acessou duas páginas ou telas pelo menos, ou que realizou alguma conversão, durante o período de análise especificado. O cálculo é realizado dividindo o número de sessões engajadas pelas sessões.
google_analytics_4:engagement_rateTempo Médio de Engajamento por Usuário Total
Tempo médio de engajamento por usuário total no período selecionado.
google_analytics_4:average_engagement_timeTempo Médio de Engajamento por usuário ativo
Tempo médio de engajamento por usuário ativo no período selecionado.
google_analytics_4:average_engagement_time_per_active_userTempo Médio de Engajamento por Sessões
Tempo médio de interação por sessão, durante o período de análise.
google_analytics_4:average_engagement_time_per_sessionsSessões engajadas
O número de sessões que duraram mais de 10 segundos ou tiveram um evento de conversão ou tiveram 2 ou mais visualizações de tela, durante o período analisado.
google_analytics_4:engaged_sessionsValor dos eventos
Valor total dos eventos durante o período de análise
google_analytics_4:event_valueReceita total
A soma da receita de compras, de assinatura e de publicidade.
google_analytics_4:total_revenueARPPU
A Receita média por usuário pagante (ARPPU) é a receita total de compra por usuário ativo, que registrou um evento de compra durante o período de análise.
google_analytics_4:average_revenue_per_paying_userARPU
Receita média por usuário ativo (ARPU), durante o período analisado. ARPU inclui estimativas de ganhos da AdMob.
google_analytics_4:average_revenue_per_userReceita de Publicidade Total
Receita total dos anúncios realizados durante o período de análise
google_analytics_4:total_advertising_revenueTráfego orgânico
Número de sessões por grupo de canal orgânico
google_analytics_4:sessions_by_organic_channel_groupTráfego pago
Número de sessões por grupo de canal pago
google_analytics_4:sessions_by_paid_channel_groupTráfego direto
Número de sessões por grupo de canal direto
google_analytics_4:sessions_by_direct_channel_groupUsuários ativos orgânicos
Número de usuários ativos por grupo de canal orgânico
google_analytics_4:active_users_by_organic_channel_groupUsuários ativos pagos
Número de usuários ativos por grupo de canal pago
google_analytics_4:active_users_by_paid_channel_groupUsuários ativos diretos
Número de usuários ativos por grupo de canal direto
google_analytics_4:active_users_by_direct_channel_groupTaxa de engajamento orgânico
Taxa de engajamento por grupo de canal orgânico
google_analytics_4:engagement_rate_by_organic_channel_groupTaxa de engajamento pago
Taxa de engajamento por grupo de canal pago
google_analytics_4:engagement_rate_by_paid_channel_groupTaxa de engajamento direto
Taxa de engajamento por grupo de canal direto
google_analytics_4:engagement_rate_by_direct_channel_groupSessões engajadas orgânicas
Número de sessões engajadas por grupo de canal orgânico
google_analytics_4:engaged_sessions_by_organic_channel_groupSessões engajadas pagas
Número de sessões engajadas por grupo de canal pago
google_analytics_4:engaged_sessions_by_paid_channel_groupSessões engajadas diretas
Número de sessões engajadas por grupo de canal direto
google_analytics_4:engaged_sessions_by_direct_channel_groupReceita de Compra
Receita total de eventos de compra, incluindo impostos e envio.
google_analytics_4:ecommerce_purchase_revenueReceita Bruta de Compra
Receita bruta total de eventos de compra, incluindo impostos e envio.
google_analytics_4:gross_ecommerce_purchase_revenueTaxa de adições ao carrinho por visualização
Taxa de produtos adicionados em relação às visualizações dos detalhes dos produtos (número de produtos adicionados por número de visualizações de detalhes do produto)
google_analytics_4:cart_to_view_rateTaxa de Rejeição
Porcentagem de sessões não engajadas. As sessões são consideradas engajadas se: durarem mais de 10 segundos, tiverem pelo menos 1 evento de conversão ou 2 visualizações de página/tela. A taxa de rejeição é calculada dividindo o número de sessões não engajadas pelo número total de sessões.
google_analytics_4:bounce_rateROAS
O Retorno do investimento em publicidade (ROAS) é a receita total dividida pelo custo de publicidade do anunciante.
google_analytics_4:return_on_ad_spend
Gráficos
10 métricas
Gênero do Visitante
Esse gráfico mostra o número de visitantes, agrupados pelo gênero.
google_analytics_4:genderSessões por idade
Quantidade de sessões e usuários a partir da idade do visitante.
google_analytics_4:ageSessões por grupo de canais padrão da sessão
Número de sessões agrupadas pelos canais que os usuários usaram para acessar o site/aplicativo quando iniciaram sessões.
google_analytics_4:sessions_by_session_default_channel_group_chartUsuários ativos por grupo de canal padrão de sessão ao longo do tempo
Número de usuários ativos, segmentados por grupo de canal padrão de sessão, durante o período analisado.
google_analytics_4:users_per_session_default_channel_group_over_timeTaxa de Rejeição ao longo do tempo
Este gráfico mostra a evolução da taxa de rejeição (porcentagem de sessões sem engajamento) ao longo do período de análise.
google_analytics_4:bounce_rate_chartTempo Médio de Engajamento por usuário ativo
Este gráfico mostra o tempo de interação médio por usuário ativo, durante o período de análise.
google_analytics_4:average_engagement_time_chartUsuários ativos por dispositivo
Número de usuários ativos em seu site ou app com base nos diferentes tipos de dispositivos usados, como desktops, smartphones e tablets.
google_analytics_4:users_by_deviceSessões por dispositivos
Número de sessões no seu site ou aplicativo com base nos diferentes tipos de dispositivos usados, como desktops, smartphones e tablets.
google_analytics_4:sessions_by_deviceUsuários ao longo do tempo
Número de usuários ao longo do tempo
google_analytics_4:users_over_timeEvento ao longo do tempo
Este gráfico mostra a evolução do número de eventos para cada um dos eventos registrados ao longo do tempo.
google_analytics_4:event_count_over_time
Tabelas
33 métricas
Países em destaque
Países com a maior quantidade de sessões durante o período analisado.
google_analytics_4:countriesDesempenho dos produtos
Resumo das interações com os produtos ou serviços oferecidos em seu site ou aplicativo durante o período de análise selecionado.
google_analytics_4:top_products_soldCampanha do primeiro usuário
Esta tabela fornece um resumo dos dados de aquisição de usuários através da primeira campanha de usuário no GA4.
google_analytics_4:first_user_campaign_nameTexto das palavra-chave do Google Ads
Resumo de desempenho das palavras-chave do Google Ads que levaram ao evento principal durante o período analisado.
google_analytics_4:google_ads_keywordTexto da palavra-chave do Google Ads atribuída a essa sessão
Resumo do desempenho das palavras-chave do Google Ads que levaram a uma sessão durante o período analisado.
google_analytics_4:session_google_ads_keywordGrupo de canais padrão da sessão
Esta tabela mostra o desempenho de cada um dos canais que os usuários usaram para acessar o site/aplicativo quando iniciaram sessões
google_analytics_4:session_default_channel_group_datatableGrupo principal de canais do primeiro usuário
Esta tabela mostra o desempenho de cada um dos canais que os usuários usaram para acessar o site/aplicativo quando iniciaram sessões
google_analytics_4:first_user_primary_channel_groupResultados da campanha
Resultados sobre as campanhas de marketing de uma sessão. Inclui campanhas do Google Ads, manuais e outros.
google_analytics_4:campaign_resultsJornada de Compra: Categoria do Dispositivo
This table shows how users are progressing through the purchase funnel on your ecommerce website or app, based on their device category. The device category is the type of device the user's activity originated on. Device categories include desktop, mobile, and tablet.
google_analytics_4:device_categoryTráfego de pesquisa orgânica do Google
A tabela de Tráfego Orgânico do Google é um relatório detalhado pré-configurado que exibe as páginas de destino com métricas associadas do Search Console e do Google Analytics para a propriedade do Search Console vinculada.
google_analytics_4:organic_search_trafficPágina de Destino
Esta tabela mostra o desempenho de cada página de destino, segmentado pela origem do tráfego.
google_analytics_4:landing_pageGrupo de Canal Padrão de Sessão por Campanhas
Esta tabela fornece informações sobre de onde vem seu tráfego (por exemplo, Google, Baidu, Bing) e os respectivos meios que direcionam os usuários para seu site ou app (por exemplo, resultados de busca orgânica, e-mail e CPC).
google_analytics_4:top_campaignsEventos por Campanha do Primeiro Usuário
Esta tabela fornece um resumo do desempenho de cada evento, segmentado pela campanha atribuída ao primeiro usuário.
google_analytics_4:event_conversion_first_user_campaign_nameEventos por conteúdo de anúncio manual do primeiro usuário
Esta tabela fornece um resumo do desempenho de cada evento, segmentado pelo conteúdo do anúncio manual associado ao primeiro usuário.
google_analytics_4:event_conversion_first_user_ad_contentEventos por termo manual do primeiro usuário
Esta tabela apresenta um resumo do desempenho de cada evento, segmentado pelo termo manual atribuído ao primeiro usuário.
google_analytics_4:event_conversion_first_user_ad_nameEventos por origem de sessão
Esta tabela fornece um resumo do desempenho de cada evento, segmentado pela origem da sessão.
google_analytics_4:event_conversion_by_session_sourceEventos por mídia atribuída ao primeiro usuário
Esta tabela apresenta um resumo do desempenho de cada evento, segmentado pela mídia atribuída ao primeiro usuário.
google_analytics_4:event_conversion_first_user_ad_mediumDesempenho das campanhas do Google Ads
Esta tabela fornece um resumo do desempenho das campanhas do Google Ads e mostra se elas estão gerando tráfego e conversões para seu site ou aplicativo.
google_analytics_4:google_ads_campaignCidades em destaque
Cidades com a maior quantidade de sessões durante o período analisado.
google_analytics_4:citiesPáginas mais acessadas
Página com o maior número de acessos.
google_analytics_4:top_contentOrigem e mídia da sessão
Esta tabela fornece informações sobre de onde vem seu tráfego (por exemplo, Google, Baidu, Bing) e os respectivos meios que direcionam os usuários para seu site ou app (por exemplo, resultados de busca orgânica, e-mail e CPC).
google_analytics_4:content_sourcesEventos por origem/mídia de sessão
Esta tabela fornece um resumo do desempenho de cada evento, segmentado por origem/mídia de sessão.
google_analytics_4:conversion_events_by_session_mediumOrigem/mídia por evento
Esta tabela traz um resumo do desempenho dos eventos de conversão, agrupados por origem/mídia.
google_analytics_4:media_source_by_eventResumo dos eventos
Esta tabela mostra os principais resultados dos eventos registrados em seu site ou app.
google_analytics_4:top_eventsResumo dos principais eventos
Esta tabela fornece um resumo dos eventos que foram marcados como eventos principais.
google_analytics_4:top_conversionsPrincipais origens das sessões
Origem das sessões que tiveram os melhores desempenhos durante o período de análise.
google_analytics_4:featured_channelsPlataforma de origem da sessão
Plataforma que originou as sessões que tiveram os melhores desempenhos durante o período de análise.
google_analytics_4:session_source_platformUTM Origem
Esta tabela fornece um resumo do desempenho das UTM fontes.
google_analytics_4:utm_sourceUTM Meio
Esta tabela fornece um resumo do desempenho dos UTM meios.
google_analytics_4:utm_mediumUTM Campanha
Esta tabela fornece um resumo do desempenho das UTM campanhas.
google_analytics_4:utm_campaignNameUTM Conteúdo
Esta tabela fornece um resumo do desempenho do UTM conteúdo.
google_analytics_4:utm_manualAdContentUTM Termo
Esta tabela fornece um resumo do desempenho dos UTM termos.
google_analytics_4:utm_manualTermVisualizações por título da página e classe da tela
Esta tabela traz dados sobre as páginas visitadas pelos usuários em um site e as telas que as pessoas abriram em um app para dispositivos móveis.
google_analytics_4:screen_page_views
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
