Version API du graphe

Ce document a été mis à jour.
La traduction en Français (France) n’est pas encore terminée.

Anglais mis à jour : 11 sept.
Français (France) mis à jour : 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.

Lecture

Get metrics for Pages or Page posts.

Nouvelle version des Pages

This endpoint is supported for Nouvelle version des Pages.

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
}];

Pour apprendre à utiliser l’API Graph, consultez notre guide Utiliser l’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
}];

Pour apprendre à utiliser l’API Graph, consultez notre guide Utiliser l’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`	Nombre de personnes connectées à Facebook ayant vu les onglets de votre Page. (See possible types)	day, week
`page_tab_views_login_top`	Le nombre de fois où des personnes connectées à Facebook ont vu les onglets de votre Page. (See possible types)	day, week
`page_tab_views_logout_top`	Le nombre de personnes non connectées à Facebook qui ont vu les onglets de votre Page. (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`	Le nombre de clics sur les coordonnées de votre Page et le bouton call-to-action.	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*`	Le nombre de fois où des personnes ont interagi avec vos publications à travers des réactions, des commentaires, des partages et autres.	day, week, days_28
`page_fan_adds_by_paid_non_paid_unique`	Le nombre de comptes de l’Espace Comptes qui ont aimé votre Page pour la première fois, réparti par contenu payant ou organique. Cet indicateur est une estimation.	day
`page_lifetime_engaged_followers_unique*`	Une personne qui suit votre Page et qui a, au cours des 14 derniers jours, regardé une ou plusieurs de vos vidéos en direct ou précédemment enregistrées pendant au moins 1 minute et/ou interagi avec votre contenu vidéo au moins une fois via un commentaire, un partage, une réaction ou une mention J’aime.
`page_daily_follows*`	Le nombre de personnes que votre Page ou profil Facebook a été suivi au cours de la période sélectionnée.	day
`page_daily_follows_unique*`	Le nombre de comptes de l’Espace Comptes qui ont suivi votre Page au cours de la période sélectionnée. Cet indicateur est une estimation.	day, week, days_28
`page_daily_unfollows_unique*`	Le nombre de comptes de l’Espace Comptes qui ont arrêté de suivre votre Page au cours de la période sélectionnée. Cet indicateur est une estimation.	day, week, days_28
`page_follows*`	Le nombre total de followers de votre profil ou de votre Page Facebook. Ce nombre est calculé en prenant le nombre de personnes ayant commencé à vous suivre, et en lui soustrayant le nombre de personnes ayant cessé de vous suivre, pendant la durée d’existence entière de votre profil ou de votre Page Facebook.	day

Page Impressions

Metric Name	Description	Values for `period`
`page_impressions*`	Le nombre de fois où du contenu de votre Page ou la concernant s’est affiché sur l’écran d’une personne. Cela inclut les publications, les stories, les publicités, ainsi que d’autres contenus ou informations sur votre Page.	day, week, days_28
`page_impressions_unique*`	Le nombre de personnes pour lesquelles du contenu de votre Page ou la concernant s’est affiché à l’écran. Cela inclut les publications, les visites, les pubs, les informations sociales des personnes qui interagissent avec votre Page et plus encore. Cet indicateur est une estimation.	day, week, days_28
`page_impressions_paid*`	Le nombre de fois où du contenu sous forme de publication ou story de votre Page ou la concernant s’est affiché sur l’écran d’une personne via une distribution payée, comme une publicité.	day, week, days_28
`page_impressions_paid_unique*`	Le nombre de comptes de l’Espace Comptes qui ont vu vos publicités au moins une fois. La couverture est différente des impressions, qui peuvent inclure plusieurs vues de vos publicités par les mêmes comptes de l’Espace Comptes. Cet indicateur est une estimation.	day, week, days_28
`page_impressions_viral*`	Le nombre de fois où du contenu de votre Page ou la concernant et qui comprend des informations sociales s’est affiché sur l’écran d’une personne. Les informations sociales s’affichent lorsque l’ami(e) d’une personne a interagi avec votre Page, votre publication, ou votre story. Cela inclut le moment où l’ami(e) d’une personne aime votre Page ou commence à la suivre, interagit avec une publication, partage une photo de votre Page et la consulte. Cet indicateur est en développement.	day, week, days_28
`page_impressions_viral_unique*`	Cet indicateur comptabilise la couverture de la diffusion organique ou payante de votre Page Facebook et de son contenu lorsque ceux-ci sont accompagnés d’informations sociales. Les informations sociales apparaissent dans le Fil quand quelqu’un interagit avec votre Page, publication ou story. La couverture n’est comptabilisée qu’une seule fois si elle découle à la fois d’une diffusion organique et payante. Cet indicateur est une estimation et en développement.	day, week, days_28
`page_impressions_nonviral*`	Le nombre de fois où votre Page Facebook et son contenu sont apparus à l’écran sans être accompagnés d’informations sociales. Les informations sociales apparaissent dans le Fil quand quelqu’un interagit avec votre Page, publication ou story. Cet indicateur est en développement.	day, week, days_28
`page_impressions_nonviral_unique*`	Cet indicateur comptabilise la couverture de la diffusion organique ou payante de votre Page Facebook et de son contenu, à l’exception des fois où ceux-ci sont accompagnés d’informations sociales. Les informations sociales apparaissent dans le Fil quand quelqu’un interagit avec votre Page, publication ou story. La couverture n’est comptabilisée qu’une seule fois si elle découle à la fois d’une diffusion organique et payante. Cet indicateur est une estimation et en développement.	day, week, days_28

Page Posts

Metric Name	Description	Values for `period`
`page_posts_impressions*`	Nombre de fois où les publications de votre Page se sont affichées sur l’écran d’une personne. Par publication on entend aussi les statuts, les photos, les liens, les vidéos et plus encore.	day, week, days_28
`page_posts_impressions_unique*`	Le nombre de personnes pour lesquelles une des publications de votre Page s’est affichée à l’écran. Les publications incluent les statuts, les photos, les liens, les vidéos et plus encore.	day, week, days_28
`page_posts_impressions_paid*`	Le nombre de fois où votre Page Facebook et son contenu sont apparus à l’écran et où la cause est attribuée à vos publicités.	day, week, days_28
`page_posts_impressions_paid_unique*`	Le nombre de comptes de l’Espace Comptes qui ont vu une publication de votre Page au moins une fois grâce à vos publicités.	day, week, days_28
`page_posts_impressions_organic_unique*`	Le nombre de personnes pour lesquelles une des publications de votre Page s’est affichée à l’écran via une diffusion gratuite.	day, week, days_28
`page_posts_served_impressions_organic_unique`	Le nombre de personnes pour lesquelles les publications de votre Page ont été diffusées dans le Fil, qu’elles se soient affichées à l’écran ou non. Les publications incluent les statuts, les photos, les liens, les vidéos et plus encore.	day, week, days_28
`page_posts_impressions_viral*`	Le nombre de fois où les publications de votre Page comprenant des informations sociales se sont affichées sur l’écran d’une personne. Les informations sociales s’affichent quand l’ami(e) d’une personne a interagi avec votre Page ou votre publication. Cela inclut le moment où l’ami(e) d’une personne aime votre Page ou commence à la suivre, interagit avec une publication, partage une photo de votre Page et la visite.	day, week, days_28
`page_posts_impressions_viral_unique*`	Le nombre de personnes pour lesquelles une des publications de votre Page s’est affichée à l’écran avec des informations sociales. En tant que forme de distribution organique, les informations sociales s’affichent lorsque l’ami(e) d’une personne a interagi avec votre Page ou votre publication. Cela inclut le moment où l’ami(e) d’une personne aime votre Page ou commence à la suivre, interagit avec une publication, partage une photo de votre Page et la consulte.	day, week, days_28
`page_posts_impressions_nonviral*`	Le nombre de fois où les publications de votre Page se sont affichées sur l’écran d’une personne. Cela n’inclut pas le contenu créé à propos de votre Page et qui comprend des informations sociales. Les informations sociales s’affichent lorsque l’ami(e) d’une personne a interagi avec votre Page ou votre publication. Cela inclut le moment où l’ami(e) d’une personne aime votre Page ou commence à la suivre, interagit avec une publication, partage une photo de votre Page et la consulte.	day, week, days_28
`page_posts_impressions_nonviral_unique*`	Nombre de personnes pour lesquelles une publication de votre Page s’est affichée à l’écran. Cela ne comprend pas le contenu créé autour de votre Page et les informations sociales qui vont avec. En tant que moyen de distribution organique, les informations sociales s’affichent lorsque l’ami(e) d’une personne a interagi avec votre Page ou votre publication. Nous prenons notamment en compte si l’ami de quelqu’un aime votre Page ou commence à la suivre, interagit avec une publication, partage une photo de votre Page et la consulte.	day, week, days_28

Page Post Engagement

Metric Name	Description	Values for `period`
`post_clicks*`	Nombre de fois où des personnes ont cliqué n’importe où sur vos publications sans générer d’actualité.	lifetime
`post_clicks_by_type*`	Nombre de fois où on a cliqué n’importe où sur vos publications sans générer d’actualité, par type de consommation.	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*`	Nombre de fois où la publication de votre Page s’est affichée sur l’écran d’une personne. Les publications incluent les statuts, les photos, les liens, les vidéos et plus encore.	lifetime
`post_impressions_unique*`	Nombre de personnes pour qui la publication de votre Page s’est affichée à l’écran. Les publications incluent les statuts, les photos, les liens, les vidéos et autres. Cet indicateur est une estimation.	lifetime
`post_impressions_paid*`	Le nombre de fois où le contenu de votre Page est apparu à l’écran et où la cause est attribuée à vos publicités.	lifetime
`post_impressions_paid_unique*`	Le nombre de comptes de l’Espace Comptes qui ont vu votre publication au moins une fois grâce à vos publicités. Cet indicateur est une estimation.	lifetime
`post_impressions_fan*`	Le nombre de fois où le contenu de votre Page est apparu sur l’écran des comptes qui ont suivi ou aimé cette dernière.	lifetime
`post_impressions_fan_unique*`	Le nombre de comptes de l’Espace Comptes qui ont suivi ou aimé votre Page. Cet indicateur est une estimation.	lifetime
`post_impressions_organic*`	Le nombre de fois où votre publication est apparue à l’écran dans le cadre d’une diffusion organique.	lifetime
`post_impressions_organic_unique*`	Cet indicateur comptabilise la couverture de la diffusion organique de votre contenu Facebook, notamment des publications, stories et publicités. La couverture des partages n’est comptabilisée que pour le contenu organique. Cela comprend les cas où votre contenu est partagé en story ou republié. Cet indicateur est une estimation.	lifetime
`post_impressions_viral*`	Le nombre de fois où le contenu de votre Page est apparu à l’écran avec des informations sociales. Les informations sociales apparaissent dans le Fil quand quelqu’un interagit avec votre Page, publication ou story. Cet indicateur est en développement.	lifetime
`post_impressions_viral_unique*`	Cet indicateur calcule la couverture lorsque votre contenu Facebook a été partagé sous forme de republication ou de story. La couverture des partages ne compte que pour la diffusion organique. Cet indicateur est une estimation et en développement.	lifetime
`post_impressions_nonviral*`	Le nombre de fois où le contenu de votre Page est apparu à l’écran sans être accompagné d’informations sociales. Les informations sociales apparaissent dans le Fil quand quelqu’un interagit avec votre Page, publication ou story. Cet indicateur est en développement.	lifetime
`post_impressions_nonviral_unique*`	Cet indicateur comptabilise la couverture de la diffusion organique ou payante du contenu de votre Page lorsque celui-ci est accompagné d’informations sociales. Les informations sociales apparaissent dans le Fil quand quelqu’un interagit avec votre Page, publication ou story. La couverture n’est comptabilisée qu’une seule fois si elle découle à la fois d’une diffusion organique et payante. Cet indicateur est une estimation et en développement.	lifetime

Page Post Reactions

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

Metric Name	Description	Values for `period`
`post_reactions_like_total`	Nombre de réactions J’aime d’une publication.	lifetime
`post_reactions_love_total`	Total de réactions J’adore d’une publication.	lifetime
`post_reactions_wow_total`	Total de réactions Wouah d’une publication.	lifetime
`post_reactions_haha_total`	Total de réactions Haha d’une publication.	lifetime
`post_reactions_sorry_total`	Total de réactions « Triste » d’une publication.	lifetime
`post_reactions_anger_total`	Total de réactions Grr d’une publication.	lifetime
`post_reactions_by_type_total`	Total des réactions à la publication par type.	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*`	Total par jour des réactions J’aime sur une Page.	day, week, days_28
`page_actions_post_reactions_love_total*`	Total par jour des réactions J’adore sur une page.	day, week, days_28
`page_actions_post_reactions_wow_total*`	Total des réactions Wouah sur une Page par jour.	day, week, days_28
`page_actions_post_reactions_haha_total*`	Total par jour des réactions « Haha » sur une page.	day, week, days_28
`page_actions_post_reactions_sorry_total*`	Total par jour des réactions désolées sur une page.	day, week, days_28
`page_actions_post_reactions_anger_total*`	Total par jour des réactions de colère sur une page.	day, week, days_28
`page_actions_post_reactions_total`	Total par jour et par type des réactions sur une page.	day

Page User Demographics

Metric Name	Description	Values for `period`
`page_fans`	Nombre total de personnes qui ont aimé votre page.	day
`page_fans_locale`	Ensemble de données linguistiques des personnes qui aiment votre page en fonction de la langue par défaut sélectionnée à l’accès à Facebook.	day
`page_fans_city`	Ensemble des données Facebook de localisation des personnes qui aiment votre Page, triées par ville.	day
`page_fans_country`	Le nombre de personnes, agrégées par pays, qui aiment votre Page. Seuls les 45 pays comprenant le plus de personnes qui aiment votre page sont inclus.	day
`page_fan_adds`	Le nombre de nouvelles personnes qui ont aimé votre Page.	day
`page_fan_adds_unique`	Le nombre de comptes de l’Espace Comptes qui ont aimé votre Page pour la première fois. Cet indicateur est une estimation.	day, week, days_28
`page_fan_removes`	Retrait des J’aime de votre Page.	day
`page_fan_removes_unique*`	Retrait des J’aime de votre Page.	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`	Le nombre de fois où les vidéos de votre Page ont été lues pendant au moins 3 secondes (ou presque en totalité lorsqu’elles sont plus courtes). Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_views_by_uploaded_hosted*`	Vues de vidéos quotidiennes sur une page réparties selon les variantes hébergées et importées sur la page.	day, week, days_28
`page_video_views_paid`	Le nombre de fois où les vidéos promues de votre Page ont été lues pendant au moins 3 secondes (ou presque en totalité lorsqu’elles sont plus courtes). Pour chaque impression de vidéo, nous comptons les vues séparément et excluons les temps de relecture.	day, week, days_28
`page_video_views_organic`	Le nombre de fois où les vidéos de votre Page ont été lues pendant au moins 3 secondes (ou presque en totalité si elles sont plus courtes), par couverture organique. Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_views_by_paid_non_paid*`	Nombre de fois où les vidéos de votre Page ont été lues pendant au moins 3 secondes, ou presque en totalité si elles sont plus courtes, en fonction de leur origine payante ou organique.Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_views_autoplayed`	Nombre de fois où les vidéos de votre Page ont été lues de manière automatique pendant au moins 3 secondes (ou presque en totalité si elles font moins de 3 secondes). Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_views_click_to_play`	Le nombre de fois où les vidéos de votre Page ont été lues pendant au moins 3 secondes (ou presque en totalité si elles sont plus courtes), après le clic sur le bouton de lecture. Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_views_unique`	Nombre de personnes qui ont vu les vidéos de votre Page pendant au moins 3 secondes (ou presque en totalité si elles sont plus courtes). Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_repeat_views`	Le nombre de fois où les vidéos de votre Page ont été relues pendant au moins 3 secondes, ou presque en totalité si elles sont plus courtes.	day, week, days_28
`page_video_complete_views_30s`	Le nombre de fois où les vidéos de votre Page ont été lues pendant au moins 30 secondes (ou presque en totalité si elles sont plus courtes). Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_complete_views_30s_paid`	Nombre de fois où les vidéos promues de votre Page ont été lues pendant au moins 30 secondes (ou presqu’en totalité si elles sont plus courtes). Pour chaque impression de vidéo, nous comptons les vues séparément et excluons les temps de relecture.	day, week, days_28
`page_video_complete_views_30s_organic`	Le nombre de fois où les vidéos de votre Page ont été lues pendant au moins 30 secondes (ou presque en totalité si elles sont plus courtes), par couverture organique. Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_complete_views_30s_autoplayed`	Le nombre de fois où votre Page a lu automatiquement des vidéos pendant au moins 30 secondes (ou presque en totalité si elles sont plus courtes). Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_complete_views_30s_click_to_play`	Nombre de fois où vos vidéos ont été lues pendant au moins 30 secondes (ou presque en totalité si elles sont plus courtes), après le clic sur le bouton de lecture. Pour une même lecture vidéo, on exclut les temps de relecture.	day, week, days_28
`page_video_complete_views_30s_unique`	Nombre de personnes qui ont vu les vidéos de votre Page pendant au moins 30 secondes (ou presque en totalité si elles sont plus courtes). Pour une même lecture vidéo, on exclut les temps de relecture.	day, week, days_28
`page_video_complete_views_30s_repeat_views`	Nombre de fois où les vidéos de votre Page ont été relues pendant au moins 30 secondes (ou presque en totalité si elles sont plus courtes).	day, week, days_28
`post_video_complete_views_30s_autoplayed`	Le nombre de fois où vos vidéos ont été lues de manière automatique pendant au moins 30 secondes (ou presque en totalité si elles font moins de 30 secondes). Pour une même lecture vidéo, nous excluons les temps de relecture. Le 0 correspond aux vidéos repartagées.	lifetime
`post_video_complete_views_30s_clicked_to_play`	Le nombre de fois où vos vidéos ont été lues pendant au moins 30 secondes (ou presque en totalité si elles font moins de 30 secondes), après le clic sur le bouton de lecture. Pour une même lecture vidéo, nous excluons les temps de relecture. Le 0 correspond aux vidéos repartagées.	lifetime
`post_video_complete_views_30s_organic`	Le nombre de fois où vos vidéos ont été lues pendant au moins 30 secondes (ou presque en totalité si elles font moins de 30 secondes), par couverture organique. Pour une même lecture vidéo, nous excluons les temps de relecture. Le 0 correspond aux vidéos repartagées.	lifetime
`post_video_complete_views_30s_paid`	Le nombre de fois où vos vidéos promues ont été lues avec le son pendant au moins 30 secondes (ou presque en totalité si elles font moins de 30 secondes). Pour chaque impression de vidéo, nous comptons les vues séparément et excluons les temps de relecture. Le 0 correspond aux vidéos repartagées.	lifetime
`post_video_complete_views_30s_unique`	Nombre de personnes qui ont vu vos vidéos pendant au moins 30 secondes ou presque en totalité si elles sont plus courtes. Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime
`page_video_views_10s`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de fois où les vidéos de votre Page ont été lues pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes). Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_views_10s_paid`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de fois où les vidéos promues de votre Page ont été lues pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes). Pour chaque impression de vidéo, nous comptons les vues séparément et excluons les temps de relecture.	day, week, days_28
`page_video_views_10s_organic`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de fois où les vidéos de votre Page ont été lues pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes), par couverture organique. Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_views_10s_autoplayed`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de fois où les vidéos de votre Page ont été lues automatiquement pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes). Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_views_10s_click_to_play`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de fois où les vidéos de votre Page ont été lues pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes), après que les personnes ont cliqué sur Lecture. Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_views_10s_unique`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de personnes qui ont vu les vidéos de votre Page pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes). Pour une même lecture vidéo, nous excluons les temps de relecture.	day, week, days_28
`page_video_views_10s_repeat`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de fois où les vidéos de votre Page ont été relues pendant au moins 10 secondes, ou presque en totalité si elles sont plus courtes.	day, week, days_28
`page_video_view_time`	La durée totale (en millisecondes) de lecture de la vidéo de votre Page.	day
`page_uploaded_3s_to_15s_views_rate*`	Taux de visionnage de 3 à 15 secondes. Mesuré sur toutes les ressources vidéo importées, ce qui inclut toute activité sur les publications/crosspostages ou leur partage.
`page_uploaded_views_15s_count*`	Nombre total de vues de vidéo pour les visiteurs ayant regardé au moins 15 secondes de la vidéo de votre Page.
`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*`	Nombre de fois où le profil d’une Page a été vu par des personnes connectées et non connectées.	day, week, days_28

Page Video Posts

Metric Name	Description	Values for `period`
`post_video_avg_time_watched`	La durée moyenne, en millisecondes, pendant laquelle les spectateurs ont regardé vos vidéos. Disponible uniquement pour les vidéos créées après le 1er septembre 2019. Renvoie 0 pour les vidéos repartagées.	lifetime
`post_video_complete_views_organic`	Le nombre de fois où vos vidéos ont été lues depuis le début jusqu’à 97 % de leur durée, ou plus, par couverture organique. Pour une même lecture vidéo, nous excluons les temps de relecture. Le 0 correspond aux vidéos repartagées.	lifetime
`post_video_complete_views_organic_unique`	Le nombre de personnes qui ont vu vos vidéos du début jusqu’à 97 % de leur durée ou plus, par couverture organique. Pour une même lecture vidéo, nous excluons les temps de relecture. Le 0 correspond aux vidéos repartagées.	lifetime
`post_video_complete_views_paid`	Le nombre de fois où vos vidéos promues ont été lues du début jusqu’à 97 % de leur durée, ou plus. Pour chaque impression de vidéo, nous comptons les vues séparément et excluons les temps de relecture. Le 0 correspond aux vidéos repartagées.	lifetime
`post_video_complete_views_paid_unique`	Le nombre de personnes qui ont vu vos vidéos promues du début jusqu’à 97 % de leur durée, ou plus. Pour chaque impression de vidéo, nous comptons les vues séparément et excluons les temps de relecture.	lifetime
`post_video_retention_graph*`	Le nombre de fois où vos vidéos ont été lues à chaque intervalle en tant que pourcentage de toutes les vues. Les vidéos sont divisées en 40 intervalles égaux. Cet indicateur ne prend pas en compte les vues de vidéos en direct. Les graphiques de rétention peuvent afficher plus d’impressions à un instant T de la vidéo qu’au début. Les gens peuvent notamment commencer la vidéo au milieu, en ignorer une partie, l’enregistrer et la regarder de nouveau à partir de ce point, ou autres comportements du même type.	lifetime
`post_video_retention_graph_clicked_to_play`	Le nombre de fois où vos vidéos ont été lues à chaque intervalle en tant que pourcentage de toutes les vues, après le clic sur le bouton de lecture. Les vidéos sont divisées en 40 intervalles égaux. Cet indicateur ne prend pas en compte les vues de vidéos en direct. Les graphiques de rétention peuvent afficher plus de vues à un instant T de la vidéo qu’au début. Les gens peuvent notamment commencer la vidéo au milieu, en ignorer une partie, l’enregistrer et la regarder de nouveau à partir de ce point, ou autres comportements du même type.	lifetime
`post_video_retention_graph_autoplayed`	Le nombre de fois où vos vidéos ont été lues automatiquement à chaque intervalle en tant que pourcentage de toutes les vues automatiques. Les vidéos sont divisées en 40 intervalles égaux. Cet indicateur ne prend pas en compte les vues de vidéos en direct. Les graphiques de rétention peuvent afficher plus de vues à un instant T de la vidéo qu’au début. Les gens peuvent notamment commencer la vidéo au milieu, en ignorer une partie, l’enregistrer et la regarder de nouveau à partir de ce point, ou autres comportements du même type.	lifetime
`post_video_views_organic`	Le nombre de fois où vos vidéos ont été lues pendant au moins 3 secondes (ou presque en totalité si elles sont plus courtes), par couverture organique. Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime, day
`post_video_views_organic_unique`	Le nombre de personnes qui ont vu vos vidéos pendant au moins 3 secondes, ou presque en totalité si elles sont plus courtes, par couverture organique. Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime
`post_video_views_paid`	Le nombre de fois où vos vidéos promues ont été lues pendant au moins 3 secondes ou presque en totalité si elles sont plus courtes. Pour chaque impression de vidéo, nous comptons les vues séparément et excluons les temps de relecture.	lifetime, day
`post_video_views_paid_unique`	Le nombre de personnes qui ont vu vos vidéos promues pendant au moins 3 secondes ou presque en totalité si elles sont plus courtes. Pour chaque impression de vidéo, nous comptons les vues séparément et excluons les temps de relecture.	lifetime
`post_video_length`	La durée, en millisecondes, d’une publication vidéo.	lifetime
`post_video_views`	Le nombre de fois où vos vidéos ont été lues pendant au moins 3 secondes (ou presque en totalité si elles font moins de 3 secondes). Pour une même lecture vidéo, nous excluons les temps de relecture. Cela inclut les vues en direct.	lifetime, day
`post_video_views_unique`	Le nombre de personnes qui ont vu vos vidéos pendant au moins 3 secondes (ou presque en totalité si elles sont plus courtes). Pour une même lecture vidéo, nous excluons les temps de relecture.	day, lifetime
`post_video_views_autoplayed`	Le nombre de fois où vos vidéos ont été lues de manière automatique pendant au moins 3 secondes (ou presque en totalité si elles font moins de 3 secondes). Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime
`post_video_views_clicked_to_play`	Le nombre de fois où vos vidéos ont été lues pendant au moins 3 secondes, ou presque en totalité si elles sont plus courtes, après le clic sur le bouton de lecture. Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime
`post_video_views_15s*`	Le nombre de fois où vos vidéos ont été lues pendant au moins 15 secondes ou presque en totalité si elles sont plus courtes. Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime
`post_video_views_60s_excludes_shorter*`	Le nombre de fois où vos vidéos ont été lues pendant au moins 60 secondes. Cet indicateur n’est calculé que pour les vidéos de 60 secondes ou plus. Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime, day
`post_video_views_10s`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de fois où vos vidéos ont été lues pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes). Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime, day
`post_video_views_10s_unique`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de personnes qui ont vu vos vidéos pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes). Pour chaque impression de vidéo, nous comptons les vues séparément et excluons les temps de relecture.	lifetime
`post_video_views_10s_autoplayed`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de fois où vos vidéos ont été lues automatiquement pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes). Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime
`post_video_views_10s_clicked_to_play`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de fois où vos vidéos ont été lues pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes), après que les personnes ont cliqué sur Lecture. Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime
`post_video_views_10s_organic`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de fois où vos vidéos ont été lues pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes), par couverture organique. Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime
`post_video_views_10s_paid`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de fois où vos vidéos promues ont été lues pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes). Pour chaque impression de vidéo, nous comptons les vues séparément et excluons les temps de relecture.	lifetime, day
`post_video_views_10s_sound_on`	Obsolète au-dessus de la v18 de l’API Graph : Le nombre de fois où vos vidéos ont été lues avec le son pendant au moins 10 secondes (ou presque en totalité si elles sont plus courtes). Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime
`post_video_views_sound_on`	Le nombre de fois où vos vidéos ont été lues avec le son activé pendant au moins 3 secondes (ou presque en totalité si elles font moins de 3 secondes). Pour une même lecture vidéo, nous excluons les temps de relecture.	lifetime
`post_video_view_time`	La durée totale (en millisecondes) de lecture de vos vidéos, dont les vidéos lues pendant moins de 3 secondes et les relectures. Le 0 correspond aux vidéos repartagées.	lifetime, day
`post_video_view_time_organic`	La durée totale (en millisecondes) de lecture de vos vidéos, par couverture organique. Le 0 correspond aux vidéos repartagées.	lifetime, day
`post_video_view_time_by_age_bucket_and_gender`	La durée totale (en millisecondes) de lecture de vos vidéos pour vos audiences principales, par âge et genre.	lifetime
`post_video_view_time_by_region_id`	La durée totale (en millisecondes) de lecture de vos vidéos pour vos 45 lieux principaux, région - pays.	lifetime, day
`post_video_views_by_distribution_type`	Le nombre de fois où vos vidéos ont été lues, par type de diffusion (sur la Page ou partagée).	lifetime
`post_video_view_time_by_distribution_type`	La durée totale (en millisecondes) de lecture de vos vidéos, par type de diffusion (sur la Page ou partagée).	lifetime
`post_video_view_time_by_country_id`	Nombre total de minutes de lecture de vos vidéos pour vos 45 pays principaux ; pays.	lifetime
`post_video_views_live*`	Le nombre global de personnes qui ont vu votre vidéo pendant plus de 3 secondes lors de sa diffusion en direct.	lifetime
`post_video_social_actions_count_unique*`	Nombre d’actions sociales (réactions, commentaires, partages) uniques sur une publication vidéo.	lifetime, day
`post_video_live_current_viewers*`	Le nombre de spectateurs qui regardent actuellement une vidéo en direct. Cet indicateur n’est renvoyé que pour les publications en direct. L’indicateur est de 0 pour les publications « était en direct ».
`post_video_15s_to_60s_excludes_shorter_views_rate*`	Taux de visionnage de 15 à 60 s d’une vidéo. Ne sont comptabilisées comme 60 s que les vidéos de 60 s et plus.
`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*`	Le nombre d’actualités créées à propos de votre publication de Page par type d’action.	lifetime
`post_activity_by_action_type_unique*`	Nombre de personnes qui ont créé une actualité liée à la publication de votre Page, par type d’action.	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

Paramètres

Paramètre	Description
`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	Par défaut : `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

Champs

La lecture à partir de cette arête renverra un résultat au format JSON :

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

`data`

Une liste de nœuds InsightsResult.

`paging`

Pour plus de détails à propos de la pagination, voir Guide de l’API Graph.

Error Codes

Erreur	Description
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

Création

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.

Mise à jour

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.

Suppression

Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.

Page Insights

Lecture

Nouvelle version des Pages

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

Paramètres

Champs

data

paging

Error Codes

Création

Mise à jour

Suppression

See Also

`data`

`paging`