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"
]
}
]
}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_reachVisualizadores
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_totalTotal 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_viewsConversas 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_newConversas Denunciadas
O número de conversas da sua página que foram denunciadas por motivos como spam ou conteúdo inadequado.
fb:page_messages_reportedNúmero de postagens
Número de postagens na página no período analisado
fb:page_posts_countTotal 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_sharesTotal 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_commentsTotal 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_uniqueTaxa 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_engagementsEngajamento 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_engagementsVisualizadores 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_reachVisualizaçõ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_organicVisualizaçõ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_paidVisualizaçõ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_followsVisualizaçõ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_followsVisualizaçõ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_viewsVisualizaçõ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_viewsVisualizaçõ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_viewsNúmero de Reels
Número de reels postados na conta durante o período analisado.
fb:page_reels_countTotal 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_uniqueTotal 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_countTempo 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_watchedTotal 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_typeTotal 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_commentsTotal 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_sharesTempo 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_timeSeguidores 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_followsNovos 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_followsTotal 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_reactionsReaçõ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_timeEvoluçã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_timeConversas 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_timeMelhor 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_cityPaíses com o maior número de seguidores
Países com o maior número de seguidores
fb:page_follows_by_countryPerformance 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_typePostagens 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_postsReels 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.
