Metrics
Métriques Facebook via l'API
Votre client connecte son compte Facebook et votre produit interroge 40 métriques par le même endpoint que les autres plateformes. Chaque métrique a un identifiant (reference_key) qui figure dans l'appel.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "fb:page_reach",
"component": "number_v1",
"metrics": [
"page_impressions_unique"
]
}
]
}Plus d'exemples d'appels Facebook
Le même endpoint pour chaque type de métrique. Les champs metrics et dimensions de chaque élément viennent du catalogue de la plateforme (GET /api/metrics/{integration_slug}).
Graphique
Augmentation du nombre de followers
Le graphique décrit l’évolution des abonnés de la page
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "fb:follows_over_time",
"component": "chart_v1",
"metrics": [
"page_follows"
],
"dimensions": [
"date"
]
}
]
}Tableau
Villes avec le plus grand nombre d’abonnés
Villes avec le plus grand nombre d’abonnés
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "fb:page_follows_by_city",
"component": "datatable_v1",
"metrics": [
"page_follows_city"
],
"dimensions": [
"city"
]
}
]
}Chiffre
Visionneurs
Le nombre de Comptes Meta qui ont vu votre contenu au moins une fois. Le contenu inclut des reels, des publications, des stories, des vidéos en direct et des annonces. Cette métrique est estimée et est en cours de développement.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "fb:page_reach_total",
"component": "number_v1",
"metrics": [
"page_impressions_unique"
],
"dimensions": [
"total"
]
}
]
}Chiffres
31 métriques
Somme de la portée quotidienne de la page
La somme des couvertures quotidiennes de votre page ou à propos de celle-ci. Si un utilisateur a vu le contenu de votre page deux jours différents, cela sera compté deux fois. Cela inclut les publications, les localisations, les publicités, les informations sociales sur les personnes qui ont interagi avec votre page, par exemple. Cet indicateur est une valeur approximative.
fb:page_reachVisionneurs
Le nombre de Comptes Meta qui ont vu votre contenu au moins une fois. Le contenu inclut des reels, des publications, des stories, des vidéos en direct et des annonces. Cette métrique est estimée et est en cours de développement.
fb:page_reach_totalTotal des vues de médias
Le nombre de fois qu'un contenu de votre Page ou concernant votre Page est apparu 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.
fb:page_media_viewsConversations par message commencées
Nombre de fois que des comptes ont envoyé un message à votre entreprise pour la première fois ou après une période d’inactivité.
fb:page_messages_newConversations de Signalement de Pages
Le nombre de conversations sur votre page qui ont été signalées pour des raisons telles que spam ou contenu inapproprié.
fb:page_messages_reportedNombre de publications
Nombre total de publications sur votre page sur la période analysée.
fb:page_posts_countTotal des partages de publication
Nombre de fois que vos publications ont été partagées, depuis leur publication jusqu’à la génération du rapport. Cette métrique est calculée en additionnant le nombre total de partages de chaque publication répertoriée dans le tableau « Publications en vedette ».
fb:page_posts_sharesTotal de commentaires sur les publications
Nombre de fois que vos publications ont reçu un commentaire, depuis leur publication jusqu’à la génération du rapport. Cette métrique est calculée en additionnant le nombre total de commentaires de chaque publication répertoriée dans le tableau « Publications en vedette ».
fb:page_posts_commentsTotal des visionneurs des publications
Somme du nombre total de visionneurs de chacune de vos publications pour la période analysée, depuis leur publication jusqu’à la génération du rapport. Cette métrique est une valeur approximative. Et comme il s’agit de la somme des visionneurs de chaque publication, si un utilisateur a vu plusieurs publications, il sera compté plusieurs fois. Cette métrique est calculée en additionnant le nombre total de visionneurs de chaque publication répertoriée dans le tableau « Publications en vedette ».
fb:page_posts_impressions_uniqueTaux d’engagement des publications
Le taux d’engagement des publications Facebook est déterminé en divisant l’engagement total d’une publication par le nombre total d’impressions de celle-ci, puis en multipliant le résultat par 100. Cela prend en compte les résultats de toute publication pendant la période d’analyse sélectionnée, quelle que soit sa date de publication. Cet engagement couvre toutes les interactions des utilisateurs avec vos annonces et publications lorsqu’elles sont affichées, comme les réactions, commentaires, partages, réclamations d’offres, vues de photos ou de vidéos, ou clics sur des liens.
fb:page_post_rate_engagementsEngagement des publications
Nombre de fois que les utilisateurs ont interagi avec vos publications pendant la période du rapport, quelle que soit leur date de publication, à travers des réactions, commentaires, partages et autres interactions.
fb:page_post_engagementsVisionneurs organiques des publications
Somme des visionneurs organiques de chacune de vos publications pour la période analysée, depuis leur publication jusqu’à la génération du rapport. Cette métrique est une valeur approximative. Et comme il s’agit de la somme des visionneurs de chaque publication, si un utilisateur a vu plusieurs publications, il sera compté plusieurs fois. Cette métrique est calculée en additionnant les visionneurs organiques de chaque publication répertoriée dans le tableau « Publications en vedette ».
fb:page_post_organic_reachVues organiques des médias de la page
Le nombre de fois qu'un contenu de publication ou d'histoire de ou à propos de votre page est apparu sur l'écran d'une personne via une distribution non rémunérée.
fb:page_media_views_organicVues payantes des médias de la page
Le nombre de fois qu'un post ou contenu de story de votre Page est apparu sur l'écran d'une personne via une distribution payante.
fb:page_media_view_paidVues des médias des non-abonnés
Le nombre de fois qu'un post ou contenu de story de votre Page est apparu sur l'écran d'une personne qui ne suit pas votre Page.
fb:page_media_view_non_followsVues des médias des abonnés
Le nombre de fois qu'un post ou contenu de story de votre Page est apparu sur l'écran d'une personne qui suit votre Page.
fb:page_media_view_followsVues des Reels
Nombre de fois que vos vidéos ont été visionnées durant la période analysée, qu’elles aient été regardées pendant au moins 3 secondes ou presque toute leur durée si elles sont plus courtes que 3 secondes. Cette valeur compte chaque vue d’une vidéo et exclut les relectures.
fb:total_video_viewsVues payantes des Reels
Nombre de fois que vos vidéos promues ont été visionnées durant la période analysée, quelle que soit leur date de publication, pendant au moins 3 secondes ou presque toute leur durée si elles sont plus courtes que 3 secondes. Cette valeur compte chaque vue d’une vidéo et exclut les relectures.
fb:paid_video_viewsVues organiques des Reels
Nombre de fois que vos vidéos ont été visionnées durant la période analysée via la portée organique, qu’elles aient été regardées pendant au moins 3 secondes ou presque toute leur durée si elles sont plus courtes que 3 secondes. Cette valeur compte chaque vue d’une vidéo et exclut les relectures.
fb:organic_video_viewsNombre de reels
Nombre de reels publiées sur le compte au cours de la période analysée.
fb:page_reels_countTotal des visionneurs des Reels
Somme des visionneurs de chaque Reel publié pendant la période analysée, depuis sa publication jusqu’à la génération du rapport. Cette métrique est une valeur approximative. Et comme il s’agit de la somme des visionneurs de chaque Reel, si un utilisateur a regardé plusieurs Reels, il sera compté plusieurs fois. Cette métrique est calculée en additionnant les visionneurs de chaque Reel répertorié dans le tableau « Reels en vedette ».
fb:post_impressions_uniqueTotal des vues de Reels
Somme des lectures de chaque Reel publié pendant la période analysée, depuis sa publication jusqu’à la génération du rapport. Les lectures correspondent au nombre de fois qu’un Reel commence à être lu après qu’une impression a déjà été comptée. Cette métrique compte les sessions de Reel de 1 milliseconde ou plus de lecture et exclut les relectures. Elle est calculée en additionnant le nombre de lectures de chaque Reel répertorié dans le tableau « Reels en vedette ».
fb:blue_reels_play_countTemps moyen de visionnage des Reels
Temps moyen de lecture de votre vidéo. Cette métrique est calculée en divisant le temps total de visionnage par le nombre de vues initiales. Une vue initiale correspond au moment où votre vidéo commence à être lue pour la première fois dans une session vidéo.
fb:post_video_avg_time_watchedTotal des mentions J’aime sur les Reels
Somme des mentions J’aime organiques pour chaque Reel publié pendant la période analysée, depuis sa publication jusqu’à la génération du rapport. Cette métrique est calculée en additionnant les mentions J’aime de chaque Reel répertorié dans le tableau « Reels en vedette ».
fb:post_video_likes_by_reaction_typeTotal des commentaires sur les Reels
Somme des commentaires reçus sur chaque Reel publié durant la période analysée, en tenant compte des commentaires depuis la publication jusqu’à la génération du rapport. Cette métrique est calculée en additionnant les commentaires de chaque Reel répertorié dans le tableau « Reels en vedette ».
fb:post_video_social_actions_commentsTotal des partages des Reels
Somme des partages de chaque Reel publié durant la période analysée, depuis leur publication jusqu’à la génération du rapport. Cette métrique est calculée en additionnant les partages de chaque Reel répertorié dans le tableau « Reels en vedette ».
fb:post_video_social_actions_sharesTemps total de visionnage des Reels
Nombre total de minutes pendant lesquelles vos Reels ont été visionnés depuis leur publication jusqu’à la génération du rapport, y compris les relectures.
fb:post_video_view_timeFollowers de la page
Le nombre d'abonnés de votre page Facebook. Ce chiffre est calculé en soustrayant le nombre de désabonnements du nombre d'abonnements.
fb:page_followsNouveaux abonnés de la page
Changement net du nombre d’abonnés à la page. Le calcul est effectué en soustrayant le nombre d’abonnés du dernier jour de la période d’analyse du total d’abonnés du jour précédant le premier jour de l’analyse.
fb:net_page_followsTotal des réactions sur les publications
Nombre de fois que vos publications ont reçu une réaction, depuis leur publication jusqu’à la génération du rapport. Les réactions aux partages de vos publications ne sont pas prises en compte. Cette métrique est calculée en additionnant le nombre total de réactions de chaque publication répertoriée dans le tableau « Publications en vedette ».
fb:page_posts_all_reactionsTotal des réactions de la période
Nombre total de réactions à votre contenu (y compris les publicités) durant la période analysée, quelle que soit la date de publication du contenu. Le bouton de réactions d’une publication permet aux utilisateurs d’exprimer différentes réactions : J’aime, J’adore, Haha, Wouah, Triste ou En colère. Le contenu peut avoir différents formats tels que publications et Reels, entre autres.
fb:page_all_reactions
Graphiques
4 métriques
Augmentation du nombre de followers
Le graphique décrit l’évolution des abonnés de la page
fb:follows_over_timeÉvolution des vues de page
Le graphique montre l'évolution des spectateurs uniques totaux de la page, des vues de médias organiques et des vues de médias payés au fil du temps. Après la migration de l'API de Meta en juin 2026, les lignes Organique et Payé représentent le total des vues de médias séparées par type de distribution, et non des spectateurs uniques.
fb:reach_over_timeConversations par message commencées au fil du temps
Nombre de fois que des comptes ont envoyé un message à votre entreprise pour la première fois ou après une période d’inactivité, regroupées par jour.
fb:page_messages_new_over_timeMeilleur jour pour les publications
Ce graphique montre quel jour a eu les meilleures performances en tenant compte des impressions des publications sur votre Page Facebook.
fb:page_fans_online_per_day
Tableaux
5 métriques
Villes avec le plus grand nombre d’abonnés
Villes avec le plus grand nombre d’abonnés
fb:page_follows_by_cityPays avec le plus grand nombre d’abonnés
Pays avec le plus grand nombre d’abonnés
fb:page_follows_by_countryPerformance par type de publication
Performance sur chaque type de publication. Avec ce tableau vous pouvez mieux comprendre quels types de publications engagent le plus vos followers.
fb:page_posts_performance_by_typePublications à la une
Publications qui ont eu le plus fort impact sur votre public. Les réactions sur les partages ne sont pas prises en compte.
fb:page_postsReels en vedette
Reels qui ont eu le plus fort impact sur votre public.
fb:page_reels
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
