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

TypeDescription

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.

SuffixDescription

_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ètreDescription
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

ErreurDescription
100Invalid parameter
190Invalid OAuth 2.0 Access Token
200Permissions error
80001There 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.
3001Invalid query
104Incorrect signature
368The action attempted has been deemed abusive or is otherwise disallowed

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.

See Also