Metrics
Métricas de Facebook con la API
Tu cliente conecta su cuenta de Facebook y tu producto consulta 40 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.
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"
]
}
]
}Más ejemplos de llamadas a Facebook
El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).
Gráfico
Crecimiento de los seguidores
El gráfico describe la evolución de los seguidores de la 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"
]
}
]
}Tabla
Ciudades con el mayor número de seguidores
Ciudades con el mayor 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
El número de Cuentas Meta que han visto su contenido al menos una vez. El contenido incluye reels, publicaciones, stories, videos en vivo y anuncios. Esta métrica es estimada y está en desarrollo.
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
Suma del Alcance Diario de la Página
Suma de los alcances únicos diários de tu página o sobre ella. Si un usuario vió un contenido de tu página en dos días diferentes, él será contado dos veces. Eso no incluye publicaciones, check-ins, anuncios, informaciones sociales sobre personas que interectúan con tu página, por ejemplo. Esa métrica es un valor aproximado.
fb:page_reachVisualizadores
El número de Cuentas Meta que han visto su contenido al menos una vez. El contenido incluye reels, publicaciones, stories, videos en vivo y anuncios. Esta métrica es estimada y está en desarrollo.
fb:page_reach_totalTotal de visualizaciones de medios
El número de veces que cualquier contenido de tu Página o sobre tu Página apareció en la pantalla de una persona. Esto incluye publicaciones, historias, anuncios, así como otro contenido o información de tu Página.
fb:page_media_viewsConversaciones por mensaje iniciadas
Número de veces que las cuentas enviaron mensajes a tu empresa por primera vez o después de un período de inactividad.
fb:page_messages_newConversaciones denunciadas de la página
El número de conversaciones en tu página que han sido denunciadas por usuarios por razones como spam, o por tener contenido inapropiado.
fb:page_messages_reportedNúmero de publicaciones
Número de publicaciones en tu página en el periodo analizado
fb:page_posts_countTotal de comparticiones de publicaciones
Número de veces que tus publicaciones fueron compartidas, desde que fueron publicadas hasta el momento en que se generó el informe. Esta métrica se calcula sumando el total de veces que cada publicación listada en la tabla "Publicaciones destacadas" fue compartida.
fb:page_posts_sharesTotal de comentarios en publicaciones
Número de veces que tus publicaciones recibieron un comentario, desde que fueron publicadas hasta el momento en que se generó el informe. Esta métrica se calcula sumando el total de comentarios de cada publicación listada en la tabla "Publicaciones destacadas".
fb:page_posts_commentsTotal de visualizadores de las publicaciones
Suma del total de visualizadores de cada una de tus publicaciones durante el período analizado, desde que fueron publicadas hasta el momento en que se generó el informe. Esta métrica es un valor aproximado. Y como es la suma de los visualizadores de cada publicación, si un usuario vio más de una, se contará más de una vez. Esta métrica se calcula sumando el total de visualizadores de cada publicación listada en la tabla "Publicaciones destacadas".
fb:page_posts_impressions_uniqueTasa de interacción de la publicación
La tasa de interacción de las publicaciones en Facebook se determina dividiendo la interacción total de la publicación entre el número total de impresiones de la misma, multiplicado por 100. Esto tiene en cuenta los resultados de cualquier publicación durante el período de análisis seleccionado, sin importar la fecha en que se publicó. Esta interacción incluye todas las acciones que las personas realizan con tus anuncios y publicaciones mientras se muestran, como reacciones, comentarios, compartidos, redenciones de ofertas, visualizaciones de fotos o videos, o clics en enlaces.
fb:page_post_rate_engagementsInteracción con la publicación
Número de veces que las personas interactuaron con tus publicaciones durante el período del informe, sin importar cuándo se publicaron, a través de reacciones, comentarios, compartidos y más.
fb:page_post_engagementsVisualizadores orgánicos de las publicaciones
Suma de los visualizadores orgánicos de cada una de tus publicaciones del período analizado, desde que fueron publicadas hasta el momento en que se generó el informe. Esta métrica es un valor aproximado y, como es la suma de los visualizadores de cada publicación, si un usuario vio más de una, se contará más de una vez. Esta métrica se calcula sumando los visualizadores orgánicos de cada publicación listada en la tabla "Publicaciones destacadas".
fb:page_post_organic_reachVisualizaciones orgánicas de medios de la página
La cantidad de veces que una publicación o el contenido de una historia de su página o acerca de ella apareció en la pantalla de una persona a través de una distribución no paga.
fb:page_media_views_organicVisualizaciones pagadas de medios de la página
El número de veces que un post o contenido de historia de tu Página apareció en la pantalla de una persona mediante distribución paga.
fb:page_media_view_paidVisualizaciones de medios de no seguidores
El número de veces que un post o contenido de historia de tu Página apareció en la pantalla de una persona que no sigue tu Página.
fb:page_media_view_non_followsVisualizaciones de medios de seguidores
El número de veces que un post o contenido de historia de tu Página apareció en la pantalla de una persona que sigue tu Página.
fb:page_media_view_followsVistas de Reels
Número de veces que tus videos fueron vistos durante el período analizado, sin importar si el contenido se reprodujo durante al menos 3 segundos o casi toda su duración si es más corto de 3 segundos. Este valor contabiliza cada visualización y excluye las repeticiones.
fb:total_video_viewsVisualizaciones pagadas de Reels
Número de veces que tus videos promocionados fueron vistos durante el período analizado, sin importar cuándo fueron publicados, durante al menos 3 segundos o casi toda su duración si son más cortos de 3 segundos. Este valor contabiliza cada visualización y excluye las repeticiones.
fb:paid_video_viewsVisualizaciones orgánicas de Reels
Número de veces que tus videos fueron vistos durante el período analizado, sin importar cuándo fueron publicados, mediante alcance orgánico, durante al menos 3 segundos o casi toda su duración si son más cortos de 3 segundos. Este valor contabiliza cada visualización y excluye las repeticiones.
fb:organic_video_viewsNúmero de reels
Número de reels publicados en la cuenta durante el período analizado.
fb:page_reels_countTotal de visualizadores de los Reels
Suma de los visualizadores de cada Reel publicado durante el período analizado, desde su publicación hasta el momento en que se generó el informe. Esta métrica es un valor aproximado. Y como es la suma de los visualizadores de cada Reel, si un usuario vio más de uno, se contará más de una vez. Esta métrica se calcula sumando los visualizadores de cada Reel listado en la tabla "Reels destacados".
fb:post_impressions_uniqueTotal de visualizaciones de Reels
Suma de las reproducciones de cada Reel publicado durante el período analizado, desde su publicación hasta el momento en que se generó el informe. Las reproducciones son el número de veces que tu Reel comienza a reproducirse después de que ya se haya contado una impresión. Esta métrica contabiliza las sesiones de Reel con 1 milisegundo o más de tiempo de reproducción y excluye las repeticiones. Se calcula sumando el número de reproducciones de cada Reel listado en la tabla "Reels destacados".
fb:blue_reels_play_countTiempo promedio de visualización de los Reels
Tiempo promedio de reproducción de tu video. Esta métrica se calcula dividiendo el tiempo total de visualización entre el número de visualizaciones iniciales. Una visualización inicial es cuando tu video comienza a reproducirse por primera vez en una sesión de video.
fb:post_video_avg_time_watchedTotal de me gusta en los Reels
Suma de los me gusta orgánicos de cada Reel publicado durante el período analizado, desde su publicación hasta el momento en que se generó el informe. Esta métrica se calcula sumando los me gusta de cada Reel listado en la tabla "Reels destacados".
fb:post_video_likes_by_reaction_typeTotal de comentarios en los Reels
Suma de los comentarios recibidos en cada Reel publicado durante el período analizado, considerando los comentarios desde su publicación hasta la generación del informe. Esta métrica se calcula sumando los comentarios de cada Reel listado en la tabla "Reels destacados".
fb:post_video_social_actions_commentsTotal de veces compartidos los Reels
Suma de las veces que se compartió cada Reel publicado durante el período analizado, desde su publicación hasta la generación del informe. Esta métrica se calcula sumando los compartidos de cada Reel listado en la tabla "Reels destacados".
fb:post_video_social_actions_sharesTiempo total de visualización de los Reels
Número total de minutos que tus Reels fueron visualizados desde su publicación hasta la generación del informe, incluyendo repeticiones.
fb:post_video_view_timeSeguidores de la página
El número de seguidores de tu página de Facebook. Esto se calcula como el número de seguidores menos el número de personas que dejaron de seguir.
fb:page_followsNuevos seguidores de la página
Cambio neto en el número de seguidores de la página. El cálculo se realiza restando el número de seguidores del último día del período de análisis del total de seguidores del día anterior al primer día del análisis.
fb:net_page_followsTotal de reacciones en las publicaciones
Número de veces que tus publicaciones recibieron una reacción, desde que fueron publicadas hasta el momento en que se generó el informe. No se tienen en cuenta las reacciones a las publicaciones compartidas. Esta métrica se calcula sumando las reacciones totales de cada publicación listada en la tabla "Publicaciones destacadas".
fb:page_posts_all_reactionsTotal de reacciones del período
Número total de reacciones a tu contenido (incluyendo anuncios) durante el período analizado, sin importar cuándo se publicó el contenido. El botón de reacciones de una publicación permite que las personas expresen diferentes reacciones a tu contenido: Me gusta, Me encanta, Haha, Wow, Triste o Enojado. El contenido puede tener formatos como publicaciones y Reels, entre otros.
fb:page_all_reactions
Gráficos
4 métricas
Crecimiento de los seguidores
El gráfico describe la evolución de los seguidores de la página
fb:follows_over_timeEvolución de las visualizaciones de la página
El gráfico muestra la evolución de los espectadores únicos totales de la página, de las visualizaciones de medios orgánicos y de las visualizaciones de medios pagados a lo largo del tiempo. Tras la migración de la API de Meta en junio de 2026, las líneas Orgánico y Pagado representan el total de visualizaciones de medios separadas por tipo de distribución, y no espectadores únicos.
fb:reach_over_timeConversaciones por mensaje iniciadas a lo largo del tiempo
Número de veces que las cuentas enviaron mensajes a tu empresa por primera vez o después de un período de inactividad, agrupadas por día.
fb:page_messages_new_over_timeMejor día para publicaciones
Este gráfico muestra qué día tuvo el mejor rendimiento considerando las impresiones de las publicaciones en su Página de Facebook.
fb:page_fans_online_per_day
Tablas
5 métricas
Ciudades con el mayor número de seguidores
Ciudades con el mayor número de seguidores
fb:page_follows_by_cityPaíses con el mayor número de seguidores
Países con el mayor número de seguidores
fb:page_follows_by_countryRendimiento por tipo de publicación
Rendimiento para cada tipo de publicación. Con esta tabla puedes entender mejor cuales publicaciones son más eficaces y generan más comprmetimiento entre tus seguidores.
fb:page_posts_performance_by_typePublicaciones destacadas
Publicaciones que tuvieron mayor impacto en tu audiencia. No se considera las reacciones en publicaciones compartidas de tu publicación.
fb:page_postsReels destacados
Reels que tuvieron mayor impacto en tu audiencia.
fb:page_reels
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
