Metrics

Métricas do Google Business Profile pela API

Seu cliente conecta a conta do Google Business Profile e seu produto consulta 26 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": "gmb:total_reviews_in_period",
      "component": "number_v1",
      "metrics": [
        "total_reviews_in_period"
      ]
    }
  ]
}
Exemplo: "Total de avaliações no período" em outubro, comparado a setembro.

Mais exemplos de chamadas no Google Business Profile

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

Avaliações por classificação

O número de avaliações recebidas pelo negócio por classificação

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": "gmb:reviews_by_rating",
      "component": "chart_v1",
      "metrics": [
        "reviews_by_rating"
      ]
    }
  ]
}

Tabela

Pesquisas por palavras-chave

As palavras-chave usadas para encontrar o negócio, ordenadas por impressões. O Google informa volumes baixos apenas como um limite máximo (ex.: < 15).

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": "gmb:keywords_searches",
      "component": "datatable_v1",
      "metrics": [
        "keywords_searches"
      ]
    }
  ]
}

Número

Avaliação média no período

A avaliação média do negócio no período

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": "gmb:average_rating_in_period",
      "component": "number_v1",
      "metrics": [
        "average_rating_in_period"
      ]
    }
  ]
}

Números

15 métricas

  • Total de avaliações no período

    O número de avaliações recebidas pelo negócio

    gmb:total_reviews_in_period
  • Avaliação média no período

    A avaliação média do negócio no período

    gmb:average_rating_in_period
  • Tempo médio de resposta

    O tempo médio para responder a uma avaliação

    gmb:average_reply_time
  • Taxa de resposta às avaliações

    A porcentagem de avaliações que foram respondidas

    gmb:rate_replied_reviews
  • Avaliações aguardando resposta

    O número de avaliações do período que ainda não foram respondidas

    gmb:reviews_awaiting_reply
  • Taxa de avaliações com comentário

    A porcentagem de avaliações que foram comentadas

    gmb:rate_commented_reviews
  • Total de visualizações

    Número de vezes que sua empresa foi visualizada

    gmb:total_views
  • Visualizações de pesquisa

    Número de vezes que sua empresa foi visualizada no Google Search

    gmb:total_search_views
  • Visualizações no Maps

    Número de vezes que sua empresa foi visualizada no Google Maps

    gmb:total_map_views
  • Total de ações

    Número de vezes que clicaram no seu site, número de telefone, solicitaram rotas, iniciaram conversas, realizaram agendamentos e pedidos.

    gmb:total_actions
  • Solicitações de rotas

    Número de vezes que solicitaram rotas

    gmb:total_directions_actions
  • Ligações

    Número de vezes que clicaram no seu número de telefone

    gmb:total_calls_actions
  • Cliques em website

    Número de vezes que clicaram no seu site

    gmb:total_website_clicks_actions
  • Agendamentos

    O número de agendamentos recebidos do Perfil da Empresa.

    gmb:total_bookings_actions
  • Pedidos

    O número de pedidos de comida recebidos do Perfil da Empresa.

    gmb:total_food_orders_actions

Gráficos

9 métricas

  • Avaliações por classificação

    O número de avaliações recebidas pelo negócio por classificação

    gmb:reviews_by_rating
  • Avaliações ao longo do tempo

    O número de avaliações recebidas pelo negócio por tempo

    gmb:reviews_over_time
  • Avaliações com comentários ao longo do tempo

    O número de comentários de avaliação recebidos pelo negócio por tempo

    gmb:review_comments_over_time
  • Respostas ao longo do tempo

    O número de respostas recebidas pelo negócio por tempo

    gmb:review_replies_over_time
  • Visualizações diárias

    Visualizações diárias totais, do Google Search e Google Maps.

    gmb:daily_views
  • Ações diárias

    Este gráfico mostra as ações diárias dos clientes, por tipo.

    gmb:daily_actions
  • Pesquisas diárias

    Número de vezes que seu site foi encontrado no Google Search por pesquisa direta ou descoberta.

    gmb:daily_searches
  • Visualizações de pesquisa e no Maps

    Número de vezes que sua empresa foi visualizada nas pesquisas e no Maps

    gmb:search_maps_views
  • Visualizações de pesquisa em computadores e dispositivos móveis

    Número de vezes que seu site foi visualizado por pesquisa no computador ou no celular.

    gmb:search_types_searches

Tabelas

2 métricas

  • Pesquisas por palavras-chave

    As palavras-chave usadas para encontrar o negócio, ordenadas por impressões. O Google informa volumes baixos apenas como um limite máximo (ex.: < 15).

    gmb:keywords_searches
  • Resumo de avaliações

    Avaliações recebidas no Perfil da Empresa, incluindo nota, data, autor e comentário (quando disponível).

    gmb:review_summary

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.