Metrics

Métricas do Facebook pela API

Seu cliente conecta a conta do Facebook e seu produto consulta 40 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": "fb:page_reach",
      "component": "number_v1",
      "metrics": [
        "page_impressions_unique"
      ]
    }
  ]
}
Exemplo: "Soma do Alcance Diário da Página" em outubro, comparado a setembro.

Mais exemplos de chamadas no Facebook

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

Crescimento de seguidores

O gráfico descreve a evolução dos seguidores da página

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": "fb:follows_over_time",
      "component": "chart_v1",
      "metrics": [
        "page_follows"
      ],
      "dimensions": [
        "date"
      ]
    }
  ]
}

Tabela

Cidades com o maior número de seguidores

Cidades com o maior número de seguidores

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": "fb:page_follows_by_city",
      "component": "datatable_v1",
      "metrics": [
        "page_follows_city"
      ],
      "dimensions": [
        "city"
      ]
    }
  ]
}

Número

Visualizadores

O número de Contas Meta que visualizaram seu conteúdo pelo menos uma vez. O conteúdo inclui reels, publicações, stories, vídeos ao vivo e anúncios. Esta métrica é estimada e está em desenvolvimento.

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": "fb:page_reach_total",
      "component": "number_v1",
      "metrics": [
        "page_impressions_unique"
      ],
      "dimensions": [
        "total"
      ]
    }
  ]
}

Números

31 métricas

  • Soma do Alcance Diário da Página

    Soma dos alcances únicos diários da sua página ou sobre ela. Se um usuário viu um conteúdo da sua página em dois dias diferentes, ele será contado duas vezes. Isso inclui postagens, check-ins, anúncios, informações sociais sobre pessoas que interagiram com a sua página, por exemplo. Essa métrica é um valor aproximado.

    fb:page_reach
  • Visualizadores

    O número de Contas Meta que visualizaram seu conteúdo pelo menos uma vez. O conteúdo inclui reels, publicações, stories, vídeos ao vivo e anúncios. Esta métrica é estimada e está em desenvolvimento.

    fb:page_reach_total
  • Total de visualizações da página

    O número de vezes que qualquer conteúdo da sua Página ou sobre sua Página entrou na tela de uma pessoa. Isso inclui postagens, stories, anúncios, bem como outros conteúdos ou informações da sua Página.

    fb:page_media_views
  • Conversas por mensagem iniciadas

    Número de vezes que contas enviaram mensagens para sua empresa pela primeira vez ou após um período de inatividade.

    fb:page_messages_new
  • Conversas Denunciadas

    O número de conversas da sua página que foram denunciadas por motivos como spam ou conteúdo inadequado.

    fb:page_messages_reported
  • Número de postagens

    Número de postagens na página no período analisado

    fb:page_posts_count
  • Total de compartilhamentos das publicações

    Número de vezes que suas publicações foram compartilhadas, desde o momento em que foram postadas até a geração do relatório. Esta métrica é calculada somando o total de compartilhamentos de cada publicação listada na tabela "Postagens em Destaque".

    fb:page_posts_shares
  • Total de comentários nas publicações

    Número de vezes que suas publicações receberam comentários, desde o momento em que foram postadas até a geração do relatório. Esta métrica é calculada somando o total de comentários de cada publicação listada na tabela "Postagens em Destaque".

    fb:page_posts_comments
  • Total de visualizadores das postagens

    Soma do total de visualizadores de cada uma das suas postagens do período analisado desde quando foram postadas até o momento da geração do relatório. Essa métrica é um valor aproximado. E por ser a soma dos visualizadores de cada postagem, se um usuário viu mais de uma postagem, ele será contado mais de uma vez. Essa métrica é calculada somando o total de visualizadores de cada postagem listada na tabela "Postagens em Destaque".

    fb:page_posts_impressions_unique
  • Taxa de engajamento das postagens

    A taxa de engajamento das postagens no Facebook é determinada pela divisão do engajamento total das postagens pelo número total de impressões da postagem, multiplicado por 100. São considerados os resultados de qualquer publicação no período de análise selecionado, independentemente da data que ela foi publicada. Esse engajamento abrange todas as interações que as pessoas têm com seus anúncios e publicações enquanto eles estão sendo exibidos. Ele pode envolver ações como reações, comentários, compartilhamentos, resgates de ofertas, visualizações de fotos ou vídeos, ou cliques em links.

    fb:page_post_rate_engagements
  • Engajamento das postagens

    O número de vezes que as pessoas engajaram com suas publicações durante o período analisado, independentemente da data que elas foram postadas, por meio de reações, comentários, compartilhamentos e muito mais.

    fb:page_post_engagements
  • Visualizadores orgânicos das postagens

    Soma dos visualizadores orgânicos de cada uma das suas publicações no período analisado, desde a data em que foram postadas até o momento em que o relatório foi gerado. Esta métrica é um valor aproximado e, por ser uma soma, se um usuário viu mais de uma publicação, ele será contado mais de uma vez. Esta métrica é calculada somando os visualizadores orgânicos de cada publicação listada na tabela "Postagens em Destaque".

    fb:page_post_organic_reach
  • Visualizações orgânicas da página

    O número de vezes que um conteúdo de publicação ou story da sua página ou sobre ela apareceu na tela de uma pessoa por meio de distribuição não paga.

    fb:page_media_views_organic
  • Visualizações pagas da página

    O número de vezes que um post ou conteúdo de story da sua Página apareceu na tela de uma pessoa por meio de distribuição paga.

    fb:page_media_view_paid
  • Visualizações de não seguidores

    O número de vezes que um post ou conteúdo de story da sua Página apareceu na tela de uma pessoa que não segue sua Página.

    fb:page_media_view_non_follows
  • Visualizações de seguidores

    O número de vezes que um post ou conteúdo de story da sua Página apareceu na tela de uma pessoa que segue sua Página.

    fb:page_media_view_follows
  • Visualizações dos Reels

    O número de vezes que seus vídeos foram visualizados no período analisado, independentemente de quando o conteúdo foi publicado por pelo menos 3 segundos ou quase sua duração total, se eles forem menores que 3 segundos. Esse valor contabiliza cada visualização de um vídeo e exclui replays.

    fb:total_video_views
  • Visualizações pagas de Reels

    Número de vezes que seus vídeos promovidos foram visualizados durante o período analisado, independentemente de quando foram publicados, por pelo menos 3 segundos ou quase toda a sua duração, se tiverem menos de 3 segundos. Este valor contabiliza cada visualização de vídeo e exclui reprises.

    fb:paid_video_views
  • Visualizações orgânicas de Reels

    Número de vezes que seus vídeos foram visualizados durante o período analisado, independentemente de quando foram publicados, por meio de alcance orgânico, por pelo menos 3 segundos ou quase toda a sua duração, se tiverem menos de 3 segundos. Este valor contabiliza cada visualização de vídeo e exclui reprises.

    fb:organic_video_views
  • Número de Reels

    Número de reels postados na conta durante o período analisado.

    fb:page_reels_count
  • Total de visualizadores dos Reels

    Soma dos visualizadores de cada Reel publicado no período analisado, desde a postagem até o momento em que o relatório foi gerado. Esta métrica é um valor aproximado e, como é a soma dos visualizadores de cada Reel, se um usuário visualizar mais de um, ele será contado mais de uma vez. Esta métrica é calculada somando os visualizadores de cada Reel listado na tabela "Reels em Destaque".

    fb:post_impressions_unique
  • Total de visualizações de Reels

    Soma das visualizações de cada Reel publicado no período analisado, desde a postagem até o momento em que o relatório foi gerado. As visualizações são o número de vezes que seu Reel começou a ser exibido após uma impressão ter sido contada. É calculada somando o número de reproduções de cada Reel listado na tabela "Reels em Destaque".

    fb:blue_reels_play_count
  • Tempo médio total de visualizações dos reels

    Tempo médio de reprodução do seu vídeo. Esta métrica é calculada dividindo o tempo de visualizações pelo número de visualizações iniciais. Uma visualização inicial ocorre quando o vídeo começa a ser reproduzido pela primeira vez em uma sessão.

    fb:post_video_avg_time_watched
  • Total de curtidas nos Reels

    Soma das curtidas orgânicas de cada Reel publicado no período analisado, desde a postagem até o momento em que o relatório foi gerado. Esta métrica é calculada somando as curtidas de cada Reel listado na tabela "Reels em Destaque".

    fb:post_video_likes_by_reaction_type
  • Total de comentários nos Reels

    Soma dos comentários recebidos em cada Reel publicado durante o período analisado, considerando os comentários desde a publicação até a geração do relatório. Esta métrica é calculada somando os comentários de cada Reel listado na tabela "Reels em Destaque".

    fb:post_video_social_actions_comments
  • Total de compartilhamentos dos Reels

    Soma dos compartilhamentos de cada Reel publicado durante o período analisado, desde a publicação até a geração do relatório. Esta métrica é calculada somando os compartilhamentos de cada Reel listado na tabela "Reels em Destaque".

    fb:post_video_social_actions_shares
  • Tempo total de exibição dos Reels

    Número total de minutos em que seus Reels foram assistidos desde a publicação até a geração do relatório, incluindo reprises.

    fb:post_video_view_time
  • Seguidores da página

    O número de seguidores da sua página do Facebook. Isso é calculado como o número de seguidores menos o número de pessoas que deixaram de seguir.

    fb:page_follows
  • Novos seguidores da página

    Variação líquida no número de seguidores da página. O cálculo é feito subtraindo o número de seguidores no último dia do período de análise do total de seguidores no dia anterior ao primeiro dia da análise.

    fb:net_page_follows
  • Total de reações das postagens do período

    Número de vezes que suas postagens realizadas no período receberam alguma reação, com os resultados sendo considerados desde que foram postadas até o momento da geração do relatório. Não são consideradas as reações nos compartilhamentos dos seus posts. Esta métrica é calculada somando as reações totais de cada publicação listada na tabela "Postagens em Destaque".

    fb:page_posts_all_reactions
  • Reações no período

    Número total de reações ao seu conteúdo (incluindo anúncios) durante o período analisado, independentemente de quando o conteúdo foi publicado. O botão de reações de uma publicação permite que as pessoas expressem diferentes reações ao seu conteúdo: Curtir, Amei, Haha, Uau, Triste ou Bravo. O conteúdo pode ter formatos como publicações e Reels, entre outros.

    fb:page_all_reactions

Gráficos

4 métricas

  • Crescimento de seguidores

    O gráfico descreve a evolução dos seguidores da página

    fb:follows_over_time
  • Evolução das visualizações da página

    O gráfico mostra a evolução dos espectadores únicos totais da página, das visualizações de mídia orgânica e das visualizações de mídia paga ao longo do tempo. Após a migração da API do Meta em junho de 2026, as linhas Orgânico e Pago representam o total de visualizações de mídia separadas por tipo de distribuição, e não espectadores únicos.

    fb:reach_over_time
  • Conversas por mensagem iniciadas ao longo do tempo

    Número de vezes que contas enviaram mensagens para sua empresa pela primeira vez ou após um período de inatividade, agrupadas por dia.

    fb:page_messages_new_over_time
  • Melhor dia para postagens

    Este gráfico mostra qual dia teve melhor desempenho considerando as Impressões das publicações na sua Página do Facebook.

    fb:page_fans_online_per_day

Tabelas

5 métricas

  • Cidades com o maior número de seguidores

    Cidades com o maior número de seguidores

    fb:page_follows_by_city
  • Países com o maior número de seguidores

    Países com o maior número de seguidores

    fb:page_follows_by_country
  • Performance por tipo de postagem

    Performance para cada tipo de postagem. Com esta tabela você poderá entender melhor quais tipos de postagens estão performando melhor, quais engajam mais seus seguidores.

    fb:page_posts_performance_by_type
  • Postagens em destaque

    Postagens que tiveram o maior impacto na sua audiência. Não são consideradas as reações nos compartilhamentos dos seus posts.

    fb:page_posts
  • Reels em Destaque

    Reels que tiveram o maior impacto na sua audiência.

    fb:page_reels

Veja o Connect aplicado ao seu produto.

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