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"
      ]
    }
  ]
}
Exemplo: "Sessões" em outubro, comparado a setembro.

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_sessions
  • Conferiu Produto

    Number of users who viewed an item.

    google_analytics_4:view_product
  • Carrinhos 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_carts
  • Usuá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_users
  • Usuá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_users
  • Total 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_users
  • Novos 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_users
  • Visualizaçõ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_pageviews
  • Visualizaçõ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_user
  • Visualizaçõ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_session
  • Contagem 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_count
  • Contagem 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_user
  • Taxa 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_user
  • Taxa 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_rate
  • Novos compradores

    Número de usuários que concluíram o primeiro evento de compra.

    google_analytics_4:first_time_purchasers
  • Total de compradores

    Número total de usuários que registraram eventos de compras durante o período de análise.

    google_analytics_4:total_purchasers
  • Taxa de conversão do comércio eletrônico

    A porcentagem de sessões (visitas ao site) que resultam em compras

    google_analytics_4:conversion_rate
  • Sessõ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_transaction
  • Evento Principal

    Número de vezes que os usuários acionam eventos principais durante o período analisado.

    google_analytics_4:conversions_count
  • Transações

    Número total de compras feitas através do site.

    google_analytics_4:transactions_count
  • Quantidade 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_cart
  • Compras iniciadas

    Número de vezes que os usuários iniciaram o processo de finalização da compra.

    google_analytics_4:quantity_checked_out
  • Compras

    O número total de compras no seu site ou aplicativo durante o período analisado.

    google_analytics_4:ecommerce_purchase_amount
  • Receita 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_revenue
  • Itens comprados

    O número total de itens comprados durante o período do relatório.

    google_analytics_4:items_purchased
  • Taxa 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_rate
  • Tempo 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_time
  • Tempo 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_user
  • Tempo 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_sessions
  • Sessõ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_sessions
  • Valor dos eventos

    Valor total dos eventos durante o período de análise

    google_analytics_4:event_value
  • Receita total

    A soma da receita de compras, de assinatura e de publicidade.

    google_analytics_4:total_revenue
  • ARPPU

    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_user
  • ARPU

    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_user
  • Receita de Publicidade Total

    Receita total dos anúncios realizados durante o período de análise

    google_analytics_4:total_advertising_revenue
  • Tráfego orgânico

    Número de sessões por grupo de canal orgânico

    google_analytics_4:sessions_by_organic_channel_group
  • Tráfego pago

    Número de sessões por grupo de canal pago

    google_analytics_4:sessions_by_paid_channel_group
  • Tráfego direto

    Número de sessões por grupo de canal direto

    google_analytics_4:sessions_by_direct_channel_group
  • Usuários ativos orgânicos

    Número de usuários ativos por grupo de canal orgânico

    google_analytics_4:active_users_by_organic_channel_group
  • Usuários ativos pagos

    Número de usuários ativos por grupo de canal pago

    google_analytics_4:active_users_by_paid_channel_group
  • Usuários ativos diretos

    Número de usuários ativos por grupo de canal direto

    google_analytics_4:active_users_by_direct_channel_group
  • Taxa de engajamento orgânico

    Taxa de engajamento por grupo de canal orgânico

    google_analytics_4:engagement_rate_by_organic_channel_group
  • Taxa de engajamento pago

    Taxa de engajamento por grupo de canal pago

    google_analytics_4:engagement_rate_by_paid_channel_group
  • Taxa de engajamento direto

    Taxa de engajamento por grupo de canal direto

    google_analytics_4:engagement_rate_by_direct_channel_group
  • Sessões engajadas orgânicas

    Número de sessões engajadas por grupo de canal orgânico

    google_analytics_4:engaged_sessions_by_organic_channel_group
  • Sessões engajadas pagas

    Número de sessões engajadas por grupo de canal pago

    google_analytics_4:engaged_sessions_by_paid_channel_group
  • Sessões engajadas diretas

    Número de sessões engajadas por grupo de canal direto

    google_analytics_4:engaged_sessions_by_direct_channel_group
  • Receita de Compra

    Receita total de eventos de compra, incluindo impostos e envio.

    google_analytics_4:ecommerce_purchase_revenue
  • Receita Bruta de Compra

    Receita bruta total de eventos de compra, incluindo impostos e envio.

    google_analytics_4:gross_ecommerce_purchase_revenue
  • Taxa 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_rate
  • Taxa 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_rate
  • ROAS

    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:gender
  • Sessões por idade

    Quantidade de sessões e usuários a partir da idade do visitante.

    google_analytics_4:age
  • Sessõ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_chart
  • Usuá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_time
  • Taxa 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_chart
  • Tempo 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_chart
  • Usuá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_device
  • Sessõ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_device
  • Usuários ao longo do tempo

    Número de usuários ao longo do tempo

    google_analytics_4:users_over_time
  • Evento 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:countries
  • Desempenho 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_sold
  • Campanha 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_name
  • Texto 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_keyword
  • Texto 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_keyword
  • Grupo 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_datatable
  • Grupo 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_group
  • Resultados da campanha

    Resultados sobre as campanhas de marketing de uma sessão. Inclui campanhas do Google Ads, manuais e outros.

    google_analytics_4:campaign_results
  • Jornada 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_category
  • Trá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_traffic
  • Página de Destino

    Esta tabela mostra o desempenho de cada página de destino, segmentado pela origem do tráfego.

    google_analytics_4:landing_page
  • Grupo 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_campaigns
  • Eventos 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_name
  • Eventos 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_content
  • Eventos 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_name
  • Eventos 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_source
  • Eventos 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_medium
  • Desempenho 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_campaign
  • Cidades em destaque

    Cidades com a maior quantidade de sessões durante o período analisado.

    google_analytics_4:cities
  • Páginas mais acessadas

    Página com o maior número de acessos.

    google_analytics_4:top_content
  • Origem 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_sources
  • Eventos 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_medium
  • Origem/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_event
  • Resumo dos eventos

    Esta tabela mostra os principais resultados dos eventos registrados em seu site ou app.

    google_analytics_4:top_events
  • Resumo dos principais eventos

    Esta tabela fornece um resumo dos eventos que foram marcados como eventos principais.

    google_analytics_4:top_conversions
  • Principais origens das sessões

    Origem das sessões que tiveram os melhores desempenhos durante o período de análise.

    google_analytics_4:featured_channels
  • Plataforma 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_platform
  • UTM Origem

    Esta tabela fornece um resumo do desempenho das UTM fontes.

    google_analytics_4:utm_source
  • UTM Meio

    Esta tabela fornece um resumo do desempenho dos UTM meios.

    google_analytics_4:utm_medium
  • UTM Campanha

    Esta tabela fornece um resumo do desempenho das UTM campanhas.

    google_analytics_4:utm_campaignName
  • UTM Conteúdo

    Esta tabela fornece um resumo do desempenho do UTM conteúdo.

    google_analytics_4:utm_manualAdContent
  • UTM Termo

    Esta tabela fornece um resumo do desempenho dos UTM termos.

    google_analytics_4:utm_manualTerm
  • Visualizaçõ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.