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"
      ]
    }
  ]
}
Exemple : « Somme de la portée quotidienne de la page » en octobre, comparé à septembre.

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_reach
  • 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.

    fb:page_reach_total
  • Total 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_views
  • Conversations 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_new
  • Conversations 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_reported
  • Nombre de publications

    Nombre total de publications sur votre page sur la période analysée.

    fb:page_posts_count
  • Total 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_shares
  • Total 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_comments
  • Total 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_unique
  • Taux 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_engagements
  • Engagement 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_engagements
  • Visionneurs 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_reach
  • Vues 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_organic
  • Vues 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_paid
  • Vues 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_follows
  • Vues 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_follows
  • Vues 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_views
  • Vues 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_views
  • Vues 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_views
  • Nombre de reels

    Nombre de reels publiées sur le compte au cours de la période analysée.

    fb:page_reels_count
  • Total 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_unique
  • Total 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_count
  • Temps 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_watched
  • Total 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_type
  • Total 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_comments
  • Total 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_shares
  • Temps 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_time
  • Followers 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_follows
  • Nouveaux 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_follows
  • Total 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_reactions
  • Total 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_time
  • Conversations 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_time
  • Meilleur 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_city
  • Pays avec le plus grand nombre d’abonnés

    Pays avec le plus grand nombre d’abonnés

    fb:page_follows_by_country
  • Performance 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_type
  • Publications à 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_posts
  • Reels 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.