versión API Graph

Este documento se ha actualizado.
La traducción en Español (España) no está disponible todavía.

Actualización del documento en inglés: 11 sep.
Actualización del documento en Español (España): 26 oct. 2018

Page Insights

Represents insights for Facebook Pages and Page posts. Refer to our Pages API documentation.

On March 14, 2024, a number of the Page Insights metrics were deprecated for all API versions. The API returns an invalid metric error when calling any of these metrics. Read our blog to learn more.

Lectura

Get metrics for Pages or Page posts.

Nueva experiencia para las páginas

This endpoint is supported for Nueva experiencia para las páginas.

Limitations

Page Insights data is only available on Pages with 100 or more likes.
Most metrics will update once every 24 hours.
Only the last two years of insights data is available.
The values for period are calculated from the initial collection of the data point.
"Period" in the tables below only refers to the time frame for which the metric can be accessed in an aggregated form.
The value "lifetime" means the time period for which the insights data is available. By default, this time period is 2 years or shorter.
Only 90 days of insights can be viewed at one time when using the since and until parameters.
When using since and until, the since date data will be included in the first value returned.
Unique impression insights values are calculated independently.
- Total page reach may not always be exactly equal to the sum of paid and non-paid unique values.
- Total page reach may not always be exactly equal to the sum of viral_unique and organic_unique.
When an organic post is boosted, metrics for paid post impressions will include both organic and paid reach.
Demographic metrics, such as age, gender, and location, are only returned if there is data for 100 or more people.
Breakdown metrics for Page post and Page view insights will only return non-zero values.
Several video related metrics only return accurate values if the person requesting the metric is the Page video post creator.
If you reshare a video post of another Page and retrieve its insights, the metrics return a value of 0. Metrics that return 0 for resharers are denoted with "Returns 0 for reshared videos" in their description.
If you neglect to indicate a specific metric or metrics for the endpoint, you will receive an error response with code 3001, with subcode 1504028 and an error message that states: "No metric was specified to be fetched. Please specify one or more metrics to be fetched and try again."
Interactions on Reels are not included.

Requirements

Type	Description
Access Tokens	A Page access token requested by a person who can perform the ANALYZE task on the Page.
Features	Not applicable.
Permissions	`read_insights`, `pages_read_engagement`
Page Tasks	ANALYZE

Example

Single Metric Sample Request

Graph API Explorer

GET v21.0/{object-id}/insights/{metric} HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '{object-id}/insights/{metric}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "{object-id}/insights/{metric}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "{object-id}/insights/{metric}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"{object-id}/insights/{metric}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Si quieres aprender a usar la API Graph, lee nuestra guía "Uso de la API Graph".

Multiple Metric Sample Request

NOTE: If your request times out or some metrics are not returned, try reducing the number of metrics in your API request.

Graph API Explorer

GET v21.0/{object-id}/insights?metric={metric-1},{metric-2},{metric-3},... HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"{object-id}/insights?metric={metric-1},{metric-2},{metric-3},..."
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Si quieres aprender a usar la API Graph, lee nuestra guía "Uso de la API Graph".

Metrics

Metric names indicate whether a metric is for a Page or a Page post.

Suffix	Description
`_unique`	Indicates that the metric shows the number of unique users who performed a specific action, for example `page_impressions_unique`. Metrics generated with the `_unique` suffix are approximate and may not be 100% accurate.
`_login`	Indicates whether a person was logged into Facebook, for example, `page_tab_views_login_top`.
`_logout`	Indicates whether a person is logged out of Facebook, for example `page_views_logout`.
`_source`	Indicates that the metric will be broken down into a list of referral sources, for example `page_fans_by_like_source`. External referrals are broken down by domain. Internal referrals are broken down by Facebook-specific features such as Profile, Search, Requests, Suggestions, Stream, etc. In these cases the `value` returned will be an object containing a series of key-value pairs where the key is the source name and the value is the metric for that source.
`*`	Indicates that a metric is refreshed several times during the day, for example `page_impressions_unique*`.

Page Content

Most of the metrics below can be retrieved using post_activity_by_action_type, post_clicks_by_type, and page_consumptions_by_consumption_type.

Metric Name	Description	Values for `period`
`page_tab_views_login_top_unique`	Número de usuarios que han iniciado sesión en Facebook y han visto pestañas de tu página. (See possible types)	day, week
`page_tab_views_login_top`	Número de veces que los usuarios que han iniciado sesión en Facebook han visto las pestañas de tu página. (See possible types)	day, week
`page_tab_views_logout_top`	Número de veces que los usuarios que no han iniciado sesión en Facebook han visto pestañas de tu página. (See possible types)	day

Tab Types

Tab types for Page content metrics.

Name	Description
`allactivity`	Administrative tab
`app`	Custom created tab
`info`	About tab view
`insights`	Insights tab
`likes`	Likes tab
`locations`	Map tab
`photos`	Photos tab
`photos_albums`	Photos tab
`photos_stream`	Photos tab
`profile`	Pages timeline
`profile_info`	Info tab
`profile_likes`	Likes tab
`profile_photos`	Photos tab
`timeline`	Pages timeline
`events`	Events tab
`videos`	Videos tab
`wall`	Timeline

Page CTA Clicks

Metric Name	Description	Values for `period`
`page_total_actions`	Número de clics en la información de contacto de tu página y el botón de llamada a la acción.	day, week, days_28

Page Engagement

The "like" reaction counts include both "like" and "care" reactions.

Metric Name	Description	Values for `period`
`page_post_engagements*`	Número de veces que las personas han interactuado con tus publicaciones al indicar que les gustan, comentarlas, compartirlas, etc.	day, week, days_28
`page_fan_adds_by_paid_non_paid_unique`	Número de cuentas del Centro de cuentas que han indicado que les gusta tu página por primera vez, desglosado en función de si el Me gusta de página se ha atribuido a contenido de pago u orgánico. Esta métrica es una estimación.	day
`page_lifetime_engaged_followers_unique*`	Alguien que sigue tu página y que, en los últimos 14 días, ha visto uno o más de tus vídeos en directo o grabados anteriormente durante al menos un minuto y ha interactuado con su contenido como mínimo una vez, ya sea través de un comentario, contenido compartido, una reacción o un Me gusta.
`page_daily_follows*`	Número de veces que se ha empezado a seguir a tu página o perfil de Facebook en el periodo de tiempo seleccionado.	day
`page_daily_follows_unique*`	Número de cuentas del Centro de cuentas que han empezado a seguir tu página en el periodo de tiempo seleccionado. Esta métrica es una estimación.	day, week, days_28
`page_daily_unfollows_unique*`	Número de cuentas del Centro de cuentas que han dejado de seguir tu página en el periodo de tiempo seleccionado. Esta métrica es una estimación.	day, week, days_28
`page_follows*`	Número de seguidores de tu página o perfil de Facebook. Se trata del número de personas que han empezado a seguirte menos el número de personas que han dejado de seguirte desde que has creado la página o el perfil de Facebook.	day

Page Impressions

Metric Name	Description	Values for `period`
`page_impressions*`	Número de veces que se ha mostrado contenido de tu página o sobre ella en la pantalla de una persona, como publicaciones, historias, anuncios y otro tipo de contenido o información de tu página.	day, week, days_28
`page_impressions_unique*`	Número de personas a las que se ha mostrado en pantalla algún contenido de tu página o sobre ella. Incluye publicaciones, visitas, anuncios, información social de personas que interactúan con tu página, etc. Esta métrica es una estimación.	day, week, days_28
`page_impressions_paid*`	Número de veces que alguna publicación o historia de tu página o sobre ella se ha mostrado en la pantalla de una persona por medio de distribución pagada (por ejemplo, en forma de anuncio).	day, week, days_28
`page_impressions_paid_unique*`	Número de cuentas del Centro de cuentas que han visto tus anuncios al menos una vez. El alcance es diferente de las impresiones, que pueden incluir varias visualizaciones de tus anuncios por parte de una misma cuenta del Centro de cuentas. Esta métrica es una estimación.	day, week, days_28
`page_impressions_viral*`	Número de veces que se ha mostrado en la pantalla de una persona contenido de tu página o sobre esta con información social adjunta. La información social se muestra cuando un amigo de una persona ha interactuado con tu página o publicación, como al hacer clic en "Me gusta" o seguir tu página, interactuar con una publicación, compartir una foto de tu página y registrar una visita en ella. Esta métrica es en desarrollo.	day, week, days_28
`page_impressions_viral_unique*`	Con esta métrica se contabiliza el alcance de la distribución orgánica o de pago de tu página de Facebook y de su contenido cuando se han mostrado con información social adjunta. Dicha información aparece en el feed después de que alguien interactúe con tu página, publicación o historia. El alcance solo se contabiliza una vez si se produce en la distribución tanto orgánica como de pago. Esta métrica es una estimación y en desarrollo.	day, week, days_28
`page_impressions_nonviral*`	Número de veces que tu página de Facebook y su contenido han estado en pantalla, sin incluir las veces en que se han mostrado con información social adjunta. Dicha información aparece en el feed después de que alguien interactúe con tu página, publicación o historia. Esta métrica es en desarrollo.	day, week, days_28
`page_impressions_nonviral_unique*`	Con esta métrica se contabiliza el alcance de la distribución orgánica o de pago de tu página de Facebook y de su contenido, sin incluir las veces en que se han mostrado con información social adjunta. Dicha información aparece en el feed después de que alguien interactúe con tu página, publicación o historia. El alcance solo se contabiliza una vez si se produce en la distribución tanto orgánica como de pago. Esta métrica es una estimación y en desarrollo.	day, week, days_28

Page Posts

Metric Name	Description	Values for `period`
`page_posts_impressions*`	Número de veces que las publicaciones de tu página se han mostrado en la pantalla de una persona, incluidos estados, fotos, enlaces, vídeos, etc.	day, week, days_28
`page_posts_impressions_unique*`	Número de personas a las que se ha mostrado en pantalla alguna publicación de tu página, incluidos estados, fotos, enlaces, vídeos, etc.	day, week, days_28
`page_posts_impressions_paid*`	Número de veces que tu página de Facebook y su contenido han estado en pantalla, como resultado de tus anuncios.	day, week, days_28
`page_posts_impressions_paid_unique*`	Número de cuentas del Centro de cuentas que han visto publicaciones de tu página al menos una vez, atribuido a tus anuncios.	day, week, days_28
`page_posts_impressions_organic_unique*`	Número de personas a las que se ha mostrado en pantalla alguna publicación de tu página a través de distribución no pagada.	day, week, days_28
`page_posts_served_impressions_organic_unique`	Número de personas a las que se han entregado las publicaciones de tu página en el feed, independientemente de si se han mostrado en pantalla o no, incluidos estados, fotos, enlaces, vídeos, etc.	day, week, days_28
`page_posts_impressions_viral*`	Número de veces que las publicaciones de tu página se han mostrado en la pantalla de una persona con información social adjunta. La información social se muestra cuando un amigo de una persona ha interactuado con tu página o publicación, como al hacer clic en "Me gusta" o seguir tu página, interactuar con una publicación, compartir una foto de tu página y registrar una visita en ella.	day, week, days_28
`page_posts_impressions_viral_unique*`	Número de personas a las que se ha mostrado en pantalla alguna publicación de tu página con información social adjunta. Como forma de distribución orgánica, la información social se muestra cuando un amigo de una persona ha interactuado con tu página o publicación, como al hacer clic en "Me gusta" o seguir tu página, interactuar con una publicación, compartir una foto de tu página y registrar una visita en ella.	day, week, days_28
`page_posts_impressions_nonviral*`	Número de veces que se han mostrado en la pantalla de una persona las publicaciones de tu página. No incluye contenido creado sobre tu página con información social asociada. Se muestra información social cuando el amigo de una persona interactúa con tu página o publicación, por ejemplo, indica que le gusta tu página o la sigue, interactúa con una publicación, comparte una foto de tu página o registra una visita en ella.	day, week, days_28
`page_posts_impressions_nonviral_unique*`	Número de personas a las que se ha mostrado en pantalla alguna publicación de tu página. No incluye el contenido creado sobre tu página con información social adjunta. Como forma de distribución orgánica, la información social se muestra cuando un amigo de una persona ha interactuado con tu página o publicación, como al hacer clic en "Me gusta" o seguir tu página, interactuar con una publicación, compartir una foto de tu página y registrar una visita en ella.	day, week, days_28

Page Post Engagement

Metric Name	Description	Values for `period`
`post_clicks*`	Número de veces que las personas han hecho clic en algún lugar de tus publicaciones sin generar ninguna historia.	lifetime
`post_clicks_by_type*`	Número de veces que las personas han hecho clic en algún lugar de tus publicaciones sin generar ninguna historia, por tipo de consumo.	lifetime

Negative Feedback Types

Negative feedback types for page_negative_feedback_by_type metrics.

Name	Description
`hide_clicks`	Hide this story
`hide_all_clicks`	Hide all posts from this page
`report_spam_clicks`	Report an object as a spam
`unlike_page_clicks`	Unlike a page

Page Post Impressions

Metric Name	Description	Values for `period`
`post_impressions*`	Número de veces que la publicación de tu página se ha mostrado en la pantalla de una persona, incluidos estados, fotos, enlaces, vídeos, etc.	lifetime
`post_impressions_unique*`	Número de personas a las que se ha mostrado en pantalla la publicación de tu página, incluidos estados, fotos, enlaces, vídeos, etc. Esta métrica es una estimación.	lifetime
`post_impressions_paid*`	Número de veces que el contenido de tu página ha estado en pantalla, como resultado de tus anuncios.	lifetime
`post_impressions_paid_unique*`	Número de cuentas del Centro de cuentas que han visto tu publicación al menos una vez, atribuido a tus anuncios. Esta métrica es una estimación.	lifetime
`post_impressions_fan*`	Número de veces que el contenido de tu página ha estado en pantalla para las cuentas que han seguido tu página o han indicado que les gusta.	lifetime
`post_impressions_fan_unique*`	Número de cuentas del Centro de cuentas que han seguido o han indicado que les gusta tu página. Esta métrica es una estimación.	lifetime
`post_impressions_organic*`	Número de veces que tu publicación ha estado en pantalla a través de la distribución orgánica.	lifetime
`post_impressions_organic_unique*`	Con esta métrica, se calcula el alcance de la distribución orgánica de tu contenido de Facebook, lo que incluye publicaciones, historias y anuncios. El alcance del contenido compartido se contabiliza solo para el contenido orgánico, que incluye casos en los que el contenido se comparte como una historia o en los que se vuelve a compartir. Esta métrica es una estimación.	lifetime
`post_impressions_viral*`	Número de veces que el contenido de tu página ha estado en pantalla con información social adjunta. Dicha información aparece en el feed después de que alguien interactúe con tu página, publicación o historia. Esta métrica es en desarrollo.	lifetime
`post_impressions_viral_unique*`	Esta métrica calcula el alcance que ha tenido tu contenido de Facebook cuando se ha compartido como publicación repetida o historia. El alcance del contenido compartido solo computa a efectos de distribución orgánica. Esta métrica es una estimación y en desarrollo.	lifetime
`post_impressions_nonviral*`	Número de veces que el contenido de tu página ha estado en pantalla, sin incluir las veces en que se ha mostrado con información social adjunta. Dicha información aparece en el feed después de que alguien interactúe con tu página, publicación o historia. Esta métrica es en desarrollo.	lifetime
`post_impressions_nonviral_unique*`	Con esta métrica se contabiliza el alcance de la distribución orgánica o de pago del contenido de tu página, sin incluir las veces en que se ha mostrado con información social adjunta. Dicha información aparece en el feed después de que alguien interactúe con tu página, publicación o historia. El alcance solo se contabiliza una vez si se produce en la distribución tanto orgánica como de pago. Esta métrica es una estimación y en desarrollo.	lifetime

Page Post Reactions

The "like" reaction counts include both "like" and "care" reactions.

Metric Name	Description	Values for `period`
`post_reactions_like_total`	Número total de reacciones "Me gusta" de una publicación.	lifetime
`post_reactions_love_total`	Número total de reacciones "Me encanta" de una publicación.	lifetime
`post_reactions_wow_total`	Número total de reacciones "Me asombra" de una publicación.	lifetime
`post_reactions_haha_total`	Número total de reacciones "Me divierte" de una publicación.	lifetime
`post_reactions_sorry_total`	Número total de reacciones "Me entristece" de una publicación.	lifetime
`post_reactions_anger_total`	Número total de reacciones "Me enfada" de una publicación.	lifetime
`post_reactions_by_type_total`	Total de reacciones a las publicaciones por tipo.	lifetime

Page Reactions

The "like" reaction counts include both "like" and "care" reactions.

Metric Name	Description	Values for `period`
`page_actions_post_reactions_like_total*`	Reacciones "Me encanta" totales diarias de una página.	day, week, days_28
`page_actions_post_reactions_love_total*`	Diario: reacciones "Me encanta" totales de una página.	day, week, days_28
`page_actions_post_reactions_wow_total*`	Total de reacciones "Me asombra" diarias en las publicaciones de una página.	day, week, days_28
`page_actions_post_reactions_haha_total*`	Total de reacciones "Me divierte" diarias en las publicaciones de una página.	day, week, days_28
`page_actions_post_reactions_sorry_total*`	Diario: número total de reacciones "Me entristece" de publicaciones en una página.	day, week, days_28
`page_actions_post_reactions_anger_total*`	Total de reacciones "Me enfada" diarias en la publicación de una página.	day, week, days_28
`page_actions_post_reactions_total`	Total de reacciones diarias a las publicaciones de una página por tipo.	day

Page User Demographics

Metric Name	Description	Values for `period`
`page_fans`	Número total de personas que han indicado que les gusta tu página.	day
`page_fans_locale`	Datos de idioma totales sobre las personas a las que les gusta tu página basados en el idioma predeterminado del usuario seleccionado al acceder a Facebook.	day
`page_fans_city`	Datos de lugares de Facebook totales, clasificados por ciudad, sobre las personas a las que les gusta tu página.	day
`page_fans_country`	Número de personas, por países, a las que les gusta tu página. Solo se incluyen los 45 países en los que haya más personas a las que les guste tu página.	day
`page_fan_adds`	Número de personas nuevas a las que les ha gustado tu página.	day
`page_fan_adds_unique`	Número de cuentas del Centro de cuentas que han indicado por primera vez que les gusta tu página. Esta métrica es una estimación.	day, week, days_28
`page_fan_removes`	Ya no me gusta de tu página.	day
`page_fan_removes_unique*`	Ya no me gusta de tu página.	day, week, days_28

Page Like Sources

Source types for page_fans_by_like_source and page_fans_by_like_source_unique metrics.

Name	Description
`Ads`	Page likes that came from people who saw your Page or post in an ad.
`News Feed`	Page likes that came from people who saw content posted by your Page or about your Page in News Feed.
`Page Suggestions`	Page likes that came from people saw your Page in a list of suggested Pages.
`Restored Likes from Reactivated Accounts`	Page likes that came from people who reactivated their Facebook profile.
`Search`	Page likes that came from people who saw you Page or post in search.
`Your Page`	Page likes that came from people who visited your Page.

Page Video Views

Metric Name	Description	Values for `period`
`page_video_views`	Número de veces que se han reproducido los vídeos de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. En una única instancia de reproducción de vídeo, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_by_uploaded_hosted*`	Reproducciones de vídeo diarias en el nivel de página desglosadas por todos los tipos de variantes subidas a la página y alojadas en la página.	day, week, days_28
`page_video_views_paid`	Número de veces que se han reproducido los vídeos promocionados de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. Para cada impresión de un vídeo, se contarán las reproducciones por separado y se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_views_organic`	Número de veces que se han reproducido los vídeos de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos, por alcance orgánico. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducirlo.	day, week, days_28
`page_video_views_by_paid_non_paid*`	Número de veces que se han reproducido los vídeos de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos, desglosado por totales, pagadas y no pagadas. Durante una única instancia de reproducción de un vídeo, se excluirá el tiempo invertido en volver a reproducirlo.	day, week, days_28
`page_video_views_autoplayed`	Número de veces que se han reproducido los vídeos de tu página automáticamente durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, week, days_28
`page_video_views_click_to_play`	Número de veces que se han reproducido los vídeos de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos, después de que las personas hayan hecho clic en ellos. Durante una única instancia de reproducción de vídeo se excluirá el tiempo invertido en volver a reproducirlo.	day, week, days_28
`page_video_views_unique`	Número de personas que han reproducido los vídeos de tu página durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, week, days_28
`page_video_repeat_views`	Número de veces que los vídeos de tu página se han vuelto a reproducir durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos.	day, week, days_28
`page_video_complete_views_30s`	Número de veces que se han reproducido los vídeos de tu página durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, week, days_28
`page_video_complete_views_30s_paid`	Número de veces que los vídeos promocionados de tu página se han reproducido durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. Por cada impresión de un vídeo, se contarán las reproducciones por separado y se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, week, days_28
`page_video_complete_views_30s_organic`	Número de veces que se han reproducido los vídeos de tu página durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos, por alcance orgánico. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, week, days_28
`page_video_complete_views_30s_autoplayed`	Número de veces que se han reproducido los vídeos de tu página automáticamente durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. Durante una única instancia de reproducción de vídeo se excluirá el tiempo invertido en volver a reproducirlo.	day, week, days_28
`page_video_complete_views_30s_click_to_play`	Número de veces que se han reproducido los vídeos de tu página durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos, después de que las personas hayan hecho clic en ellos. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, week, days_28
`page_video_complete_views_30s_unique`	Número de personas que han reproducido los vídeos de tu página durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. En una única instancia de reproducción de vídeo, se excluirá el tiempo de las reproducciones repetidas.	day, week, days_28
`page_video_complete_views_30s_repeat_views`	Número de veces que los vídeos de tu página se han vuelto a reproducir durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos.	day, week, days_28
`post_video_complete_views_30s_autoplayed`	Número de veces que se han reproducido tus vídeos durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo. Devuelve 0 para los vídeos que se han vuelto a compartir.	lifetime
`post_video_complete_views_30s_clicked_to_play`	Número de veces que se han reproducido tus vídeos durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos, después de que las personas hayan hecho clic en ellos. En una única instancia de reproducción de vídeo, se excluirá el tiempo de las reproducciones repetidas. Devuelve 0 para los vídeos compartidos.	lifetime
`post_video_complete_views_30s_organic`	Número de veces que se han reproducido tus vídeos durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos, por alcance orgánico. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo. Devuelve 0 para los vídeos que se han vuelto a compartir.	lifetime
`post_video_complete_views_30s_paid`	Número de veces que se han reproducido tus vídeos promocionados durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. Por cada impresión de un vídeo, se contarán las reproducciones por separado y se excluirá el tiempo invertido en volver a reproducirlo. Devuelve 0 para los vídeos que se han vuelto a compartir.	lifetime
`post_video_complete_views_30s_unique`	Número de personas que han reproducido tus vídeos durante al menos 30 segundos, o casi en su totalidad si duran menos de 30 segundos. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime
`page_video_views_10s`	Obsoleto en versiones posteriores a la API Graph v18: número de veces que se han reproducido los vídeos de tu página durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. En una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, week, days_28
`page_video_views_10s_paid`	Obsoleto en versiones posteriores a la API Graph v18: número de veces que se han reproducido los vídeos promocionados de tu página durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. Por cada impresión de un vídeo, se contarán las reproducciones por separado y se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, week, days_28
`page_video_views_10s_organic`	Obsoleto en versiones posteriores a la API Graph v18: número de veces que los vídeos de tu página se han reproducido durante al menos 10 segundos, o casi en su totalidad si duran menos 10 segundos, por alcance orgánico. En una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, week, days_28
`page_video_views_10s_autoplayed`	Obsoleto en versiones posteriores a la API Graph v18: número de veces que se han reproducido los vídeos de tu página durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. En una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, week, days_28
`page_video_views_10s_click_to_play`	Obsoleto en versiones posteriores a la API Graph v18: número de veces que los vídeos de tu página se han reproducido durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos, después de que las personas hayan hecho clic en Reproducir. En una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, week, days_28
`page_video_views_10s_unique`	Obsoleto en versiones posteriores a la API Graph v18: número de personas que han visto los vídeos de tu página durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. En una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, week, days_28
`page_video_views_10s_repeat`	Obsoleto en versiones posteriores de la API Graph v18: número de veces que los vídeos de tu página se han vuelto a reproducir durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos.	day, week, days_28
`page_video_view_time`	Tiempo total, en milisegundos, durante el que las personas han visto el vídeo de tu página.	day
`page_uploaded_3s_to_15s_views_rate*`	Porcentaje de reproducción de 3 a 15 segundos. Medición realizada sobre la base de todos los activos de vídeo subidos, incluida cualquier actividad en publicaciones estándar o en varias publicaciones, o en publicaciones compartidas desde ellas.
`page_uploaded_views_15s_count*`	Número total de visualizaciones de al menos 15 segundos del vídeo de tu página.
`page_uploaded_views_60s_excludes_shorter_unique_count_by_is_60s_returning_viewer*`	Daily video 60-second unique views on a page for uploaded videos by 60-second returning viewers. This metric counts only for videos that are 60 seconds or longer. 60-second returning viewers are the users who had 60-second view last week and a 60-second view this week.

Page Views

Metric Name	Description	Values for `period`
`page_views_total*`	Número de veces que las personas que han iniciado sesión y las que no lo han hecho han visto el perfil de una página.	day, week, days_28

Page Video Posts

Metric Name	Description	Values for `period`
`post_video_avg_time_watched`	Tiempo medio, en milisegundos, que las personas han visto tus vídeos. Solo está disponible para los vídeos creados después del 25 de agosto de 2016. Devuelve 0 para los vídeos que se han vuelto a compartir.	lifetime
`post_video_complete_views_organic`	Número de veces que se han reproducido tus vídeos desde el principio hasta el 97 % de su duración o más, por alcance orgánico. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo. Devuelve 0 para los vídeos que se han vuelto a compartir.	lifetime
`post_video_complete_views_organic_unique`	Número de personas que han reproducido tus vídeos desde el principio hasta el 97 % de su duración o más, por alcance orgánico. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo. Devuelve 0 para los vídeos que se han vuelto a compartir.	lifetime
`post_video_complete_views_paid`	Número de veces que se han reproducido tus vídeos promocionados desde el principio hasta el 97 % de su duración o más. Por cada impresión de un vídeo, se contarán las reproducciones por separado y se excluirá el tiempo invertido en volver a reproducir el vídeo. Devuelve 0 para los vídeos que se han vuelto a compartir.	lifetime
`post_video_complete_views_paid_unique`	Número de personas que han reproducido tus vídeos promocionados desde el principio hasta el 97 % de su duración o más. Por cada impresión de un vídeo, se contarán las reproducciones por separado y se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime
`post_video_retention_graph*`	Número de veces que se han reproducido tus vídeos en cada intervalo como porcentaje de las reproducciones totales. Los vídeos se dividen en 40 intervalos iguales. Esta métrica no incluye las impresiones mientras el vídeo estaba en directo. Es posible que en los gráficos de retención se muestren más impresiones hacia el final del vídeo que al principio. Ten en cuenta que las personas pueden tener comportamientos como empezar a ver el vídeo a la mitad, avanzar, guardarlo y volver a verlo desde ese punto, u otros similares.	lifetime
`post_video_retention_graph_clicked_to_play`	Número de veces que se han reproducido tus vídeos en cada intervalo como porcentaje de las reproducciones totales, después de que las personas hayan hecho clic en ellos. Los vídeos se dividen en 40 intervalos iguales. Esta métrica no incluye las impresiones mientras el vídeo estaba en directo. Es posible que en los gráficos de retención se muestren más impresiones hacia el final del vídeo que al principio. Ten en cuenta que las personas pueden tener comportamientos como empezar a ver el vídeo a la mitad, avanzar, guardarlo y volver a verlo desde ese punto, u otros similares.	lifetime
`post_video_retention_graph_autoplayed`	Número de veces que se han reproducido tus vídeos automáticamente en cada intervalo como porcentaje del total de reproducciones automáticas. Los vídeos se dividen en 40 intervalos iguales. Esta métrica no incluye las impresiones mientras el vídeo estaba en directo. Es posible que en los gráficos de retención se muestren más impresiones hacia el final del vídeo que al principio. Ten en cuenta que las personas pueden tener comportamientos como empezar a ver el vídeo a la mitad, avanzar, guardarlo y volver a verlo desde ese punto, u otros similares.	lifetime
`post_video_views_organic`	Número de veces que se han reproducido tus vídeos durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos, por alcance orgánico. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime, day
`post_video_views_organic_unique`	Número de personas que han reproducido tus vídeo durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos, por alcance orgánico. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime
`post_video_views_paid`	Número de veces que se han reproducido tus vídeos promocionados durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. Por cada impresión de un vídeo, se contarán las reproducciones por separado y se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime, day
`post_video_views_paid_unique`	Número de personas que han reproducido tus vídeos promocionados durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. Por cada impresión de un vídeo, se contarán las reproducciones por separado y se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime
`post_video_length`	Duración, en milisegundos, de una publicación con vídeo.	lifetime
`post_video_views`	Número de veces que se han reproducido tus vídeos durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. En una única instancia de reproducción de vídeo, se excluirá el tiempo de las reproducciones repetidas. Esto incluye las reproducciones en directo.	lifetime, day
`post_video_views_unique`	Número de personas que han reproducido tus vídeos durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	day, lifetime
`post_video_views_autoplayed`	Número de veces que se han reproducido tus vídeos automáticamente durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. En una única instancia de reproducción de vídeo, se excluirá el tiempo de las reproducciones repetidas.	lifetime
`post_video_views_clicked_to_play`	Número de veces que se han reproducido tus vídeos durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos, después de que las personas hayan hecho clic en ellos. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime
`post_video_views_15s*`	Número de veces que se han reproducido tus vídeos durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime
`post_video_views_60s_excludes_shorter*`	Número de veces que se han reproducido los vídeos de tu página durante al menos 30 segundos. Esta métrica solo se contabiliza para los vídeos que duran 60 segundos o más. En una única instancia de reproducción de vídeo, se excluirá el tiempo de las reproducciones repetidas.	lifetime, day
`post_video_views_10s`	Obsoleto en versiones posteriores a la API Graph v18: número de veces que se han reproducido tus vídeos durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. En una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime, day
`post_video_views_10s_unique`	Obsoleto en versiones posteriores a la API Graph v18: número de personas que han reproducido tus videos durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. Por cada impresión de un vídeo, se contarán las reproducciones por separado y se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime
`post_video_views_10s_autoplayed`	Obsoleto en versiones posteriores a la API Graph v18: número de veces que se han reproducido automáticamente tus vídeos durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. En una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime
`post_video_views_10s_clicked_to_play`	Obsoleto en versiones posteriores a la API Graph v18: número de veces que tus vídeos se han reproducido durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos, después de que las personas hayan hecho clic en Reproducir. En una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime
`post_video_views_10s_organic`	Obsoleto en versiones posteriores a la API Graph v18: número de veces que tus vídeos se han reproducido durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos, por alcance orgánico. En una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime
`post_video_views_10s_paid`	Obsoleto en versiones posteriores a la API Graph v18: número de veces que se han reproducido tus vídeos promocionados durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. Por cada impresión de un vídeo, se contarán las reproducciones por separado y se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime, day
`post_video_views_10s_sound_on`	Obsoleto en versiones posteriores a la API Graph v18: número de veces que se han reproducido tus vídeos con sonido durante al menos 10 segundos, o casi en su totalidad si duran menos de 10 segundos. En una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime
`post_video_views_sound_on`	Número de veces que se han reproducido tus vídeos con el sonido activado durante al menos 3 segundos, o casi en su totalidad si duran menos de 3 segundos. Durante una única instancia de reproducción de vídeo, se excluirá el tiempo invertido en volver a reproducir el vídeo.	lifetime
`post_video_view_time`	Tiempo total, en milisegundos, que se han reproducido tus vídeos, incluidos los vídeos reproducidos durante menos de 3 segundos y las reproducciones repetidas. Devuelve 0 para los vídeos que se han vuelto a compartir.	lifetime, day
`post_video_view_time_organic`	Tiempo total, en milisegundos, que tus vídeos se han reproducido por alcance orgánico. Devuelve 0 para los vídeos que se han vuelto a compartir.	lifetime, day
`post_video_view_time_by_age_bucket_and_gender`	Tiempo total, en milisegundos, que tus vídeos se han reproducido para las audiencias principales, por edad y sexo.	lifetime
`post_video_view_time_by_region_id`	Tiempo total, en milisegundos, que se han reproducido tus vídeos en los 45 lugares con más interacción, (región, país).	lifetime, day
`post_video_views_by_distribution_type`	Número de veces que se han reproducido tus vídeos por tipo de distribución; de propiedad de una página o compartida.	lifetime
`post_video_view_time_by_distribution_type`	Tiempo total, en milisegundos, que se han reproducido tus vídeos por tipo de distribución; de propiedad de una página o compartida.	lifetime
`post_video_view_time_by_country_id`	Número total de minutos que se han reproducido tus vídeos en los 45 lugares con más interacción, (país).	lifetime
`post_video_views_live*`	Número total de personas que han reproducido tu vídeo durante más de 3 segundos durante el streaming en vivo.	lifetime
`post_video_social_actions_count_unique*`	Recuento único de acciones sociales (reacciones, comentarios y contenido compartido) de una publicación de vídeo.	lifetime, day
`post_video_live_current_viewers*`	Número de espectadores que están viendo el vídeo actualmente. Esta métrica solo se cuenta en publicaciones en directo. Devuelve 0 para publicaciones que ya no están en directo.
`post_video_15s_to_60s_excludes_shorter_views_rate*`	Porcentaje de reproducciones de 60 segundos de un vídeo. Esta métrica se calcula solo para los vídeos que tengan una duración mínima de 60 segundos.
`post_video_views_by_live_status*`	Lifetime 3S Video Views broken down by live status: live or VOD

Stories

Page and Post Stories and "People talking about this".

Metric Name	Description	Values for `period`
`post_activity_by_action_type*`	Número de historias sobre tu publicación de la página, por tipo de acción.	lifetime
`post_activity_by_action_type_unique*`	Número de personas que han creado una historia acerca de la publicación de tu página, por tipo de acción.	lifetime

Page Story Types

Name	Description
`checkin`	Page checkins
`coupon`	Offer claims
`event`	RSVPing to event
`fan`	Page likes
`mention`	Page mentions
`page post`	Posts by a Page
`question`	Question answers
`user post`	Posts by people on a Page
`other`	Other types

Video Ad Breaks

Metric Name	Description	Values for period
`page_daily_video_ad_break_ad_impressions_by_crosspost_status`	The total number of times an ad was shown during ad breaks in crossposted videos.	day
`page_daily_video_ad_break_cpm_by_crosspost_status`	The average amount paid by advertisers for 1,000 of impressions of their ads in a crossposted videos. This is a gross number and includes the amount paid to Facebook.	day
`page_daily_video_ad_break_earnings_by_crosspost_status`	An estimate of the amount you earned from ad breaks in a crossposted videos, based on the number of impressions and CPM of ads shown. Actual payments may differ if there are content ownership claims or other adjustments.	day
`post_video_ad_break_ad_impressions`	The total number of times an ad was shown during ad breaks in your videos.	day, lifetime
`post_video_ad_break_earnings`	An estimate of the amount you earned from ad breaks in your videos, based on the number of impressions and CPM of ads shown. Actual payments may differ if there are content ownership claims or other adjustments.	day, lifetime
`post_video_ad_break_ad_cpm`	The average amount paid by advertisers for 1,000 impressions of their ads in your videos. This number also includes the amount paid to Facebook.	day, lifetime
`creator_monetization_qualified_views`	The number of views of your videos that will receive a payout. To qualify for payout, your Page or profile must generate ad revenue in the current earning period. You must also be following the Partner Monetization Policies and Content Monetization Policies. There are additional factors which may disqualify a view for payout.	day,lifetime

Parámetros

Parámetro	Descripción
`breakdown` list<A valid breakdown for an insights endpoint>	breakdown for marketing messages metrics. This is currently in development.
`date_preset` enum{today, yesterday, this_month, last_month, this_quarter, maximum, data_maximum, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, last_week_mon_sun, last_week_sun_sat, last_quarter, last_year, this_week_mon_today, this_week_sun_today, this_year}	Preset a date range, like lastweek, yesterday. If since or until presents, it does not work.
`metric` list<A valid metric for an insights endpoint>	The list of metrics that needs to be fetched
`period` enum {day, week, days_28, month, lifetime, total_over_range}	The aggregation period
`show_description_from_api_doc` boolean	Valor predeterminado: `false` If set to true, then an additional description of the metric, retrieved from the API doc(https://developers.facebook.com/docs/graph-api/reference/insights) will be included in the returned data
`since` datetime	Lower bound of the time range to consider
`until` datetime	Upper bound of the time range to consider

Campos

La lectura de este perímetro mostrará un resultado formateado con JSON:

{
    "data": [],
    "paging": {}
}

`data`

Una lista de nodos de InsightsResult.

`paging`

Para obtener más detalles sobre la paginación, consulta la Guía de la API Graph.

Error Codes

Error	Descripción
100	Invalid parameter
190	Invalid OAuth 2.0 Access Token
200	Permissions error
80001	There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
3001	Invalid query
104	Incorrect signature
368	The action attempted has been deemed abusive or is otherwise disallowed
2500	Error parsing graph query

Creando

No puedes realizar esta operación en este extremo.

Actualizando

No puedes realizar esta operación en este extremo.

Eliminando

No puedes realizar esta operación en este extremo.

Page Insights

Lectura

Nueva experiencia para las páginas

Limitations

Requirements

Example

Single Metric Sample Request

Multiple Metric Sample Request

Metrics

Page Content

Tab Types

Page CTA Clicks

Page Engagement

Page Impressions

Page Posts

Page Post Engagement

Negative Feedback Types

Page Post Impressions

Page Post Reactions

Page Reactions

Page User Demographics

Page Like Sources

Page Video Views

Page Views

Page Video Posts

Stories

Page Story Types

Video Ad Breaks

Parámetros

Campos

data

paging

Error Codes

Creando

Actualizando

Eliminando

See Also

`data`

`paging`