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"
      ]
    }
  ]
}
Ejemplo: "Suma del Alcance Diario de la Página" en octubre, comparado con septiembre.

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_reach
  • 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.

    fb:page_reach_total
  • Total 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_views
  • Conversaciones 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_new
  • Conversaciones 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_reported
  • Número de publicaciones

    Número de publicaciones en tu página en el periodo analizado

    fb:page_posts_count
  • Total 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_shares
  • Total 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_comments
  • Total 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_unique
  • Tasa 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_engagements
  • Interacció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_engagements
  • Visualizadores 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_reach
  • Visualizaciones 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_organic
  • Visualizaciones 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_paid
  • Visualizaciones 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_follows
  • Visualizaciones 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_follows
  • Vistas 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_views
  • Visualizaciones 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_views
  • Visualizaciones 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_views
  • Número de reels

    Número de reels publicados en la cuenta durante el período analizado.

    fb:page_reels_count
  • Total 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_unique
  • Total 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_count
  • Tiempo 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_watched
  • Total 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_type
  • Total 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_comments
  • Total 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_shares
  • Tiempo 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_time
  • Seguidores 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_follows
  • Nuevos 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_follows
  • Total 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_reactions
  • Total 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_time
  • Evolució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_time
  • Conversaciones 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_time
  • Mejor 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_city
  • Países con el mayor número de seguidores

    Países con el mayor número de seguidores

    fb:page_follows_by_country
  • Rendimiento 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_type
  • Publicaciones destacadas

    Publicaciones que tuvieron mayor impacto en tu audiencia. No se considera las reacciones en publicaciones compartidas de tu publicación.

    fb:page_posts
  • Reels 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.