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.
Get metrics for Pages or Page posts.
period
are calculated from the initial collection of the data point.since
and until
parameters. since
and until
, the since
date data will be included in the first value
returned.viral_unique
and organic_unique
.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."Type | Description |
---|---|
A Page access token requested by a person who can perform the ANALYZE task on the Page. | |
Not applicable. | |
| |
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
}];
NOTE: If your request times out or some metrics are not returned, try reducing the number of metrics in your API request.
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
}];
Metric names indicate whether a metric is for a Page or a Page post.
Suffix | Description |
---|---|
| Indicates that the metric shows the number of unique users who performed a specific action, for example |
| Indicates whether a person was logged into Facebook, for example, |
| Indicates whether a person is logged out of Facebook, for example |
| Indicates that the metric will be broken down into a list of referral sources, for example |
| Indicates that a metric is refreshed several times during the day, for example |
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 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 |
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 |
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 |
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 |
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 |
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 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 |
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 |
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 |
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 |
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 |
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. |
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. |
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 |
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 |
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 |
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 |
Metric Name | Description | Values for period |
---|---|---|
| The total number of times an ad was shown during ad breaks in crossposted videos. | day |
| 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 |
| 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 |
| The total number of times an ad was shown during ad breaks in your videos. | day, lifetime |
| 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 |
| 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 |
| 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è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 |
La lecture à partir de cette arête renverra un résultat au format JSON :
{ "
data
": [], "paging
": {} }
data
paging
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 |