
Le rapport final doit présenter trois groupes distincts de faits étayés : les résultats payants, les résultats organiques et les observations publiques datées. Reliez ces groupes à l’aide des identifiants vérifiés des publications. Combinez les valeurs uniquement lorsque leurs définitions permettent le calcul. Gardez visibles les données manquantes et les écarts non résolus.
La méthode ci-dessous propose une procédure de création de rapport. Les éléments fournis comprennent de la documentation publique, mais aucun rapport terminé ni aucune exécution de collecte testée.
1. Définissez la question avant de collecter les chiffres
Commencez par la question à laquelle le rapport du propriétaire doit répondre. Le lecteur a-t-il besoin de connaître la diffusion payante, la diffusion organique ou les réactions publiques ? La diffusion payante correspond à la distribution par la publicité. La diffusion organique correspond à la distribution que la source du propriétaire qualifie d’organique. Les réactions publiques correspondent aux compteurs visibles sur une publication publique.
Il s’agit de faits distincts à établir. La question publique sur les analyses organiques et payantes, consultée le 11 août 2026 ; un seul enregistrement de question fournie mentionne aussi les deux types de diffusion. Son extrait concerne le suivi payant sur LinkedIn. Il ne démontre aucune limite d’un produit Facebook et ne montre pas la fréquence de ce besoin.
Rédigez un court cahier des charges pour le rapport :
- Indiquez la question métier.
- Listez chaque indicateur demandé, c’est-à-dire chaque quantité à mesurer.
- Fixez la période du rapport et le fuseau horaire.
- Listez les publications et les publicités incluses dans le rapport.
- Indiquez la source nécessaire pour chaque fait demandé.
- Précisez si le résultat compte des actions, des enregistrements ou des personnes.
Par exemple, « interactions payantes pendant la période du rapport » et « mentions J’aime publiques observées aujourd’hui » sont deux demandes différentes. Une interaction est une action selon la définition conservée de la source. Une mention J’aime correspond à un compteur public précis. Aucun de ces libellés ne donne un nombre de personnes distinctes.
Utilisez le libellé exact de l’indicateur source dans tout le rapport. Ne remplacez pas plusieurs libellés différents par « engagement » pour ensuite les traiter comme équivalents.
2. Commencez par les rapports disponibles du propriétaire
Faites l’inventaire des fichiers du Gestionnaire de publicités, des Statistiques et des autres fichiers autorisés que le propriétaire peut fournir. Utilisez les fichiers qui existent réellement. Cette méthode ne garantit aucune option d’exportation, aucun chemin de menu ni aucun historique précis.
Pour chaque fichier, conservez son nom et notez ce qu’il couvre :
- Copiez les libellés exacts des indicateurs et leurs définitions disponibles.
- Notez les filtres de compte, de campagne, de publicité ou de publication sélectionnés.
- Notez la date de début, la date de fin et le fuseau horaire.
- Notez les paramètres d’attribution s’ils sont présents. Ces paramètres décrivent comment le rapport attribue les résultats à une publicité ou à une période.
- Identifiez l’unité de ligne : ce que représente une ligne.
- Notez les définitions manquantes, la couverture incomplète des données et les champs indisponibles.
L’unité de ligne est importante. Une ligne peut représenter une publicité, une publication ou le total d’un compte. Ajouter le total d’un compte aux lignes publicitaires qui le composent peut compter le même résultat une seconde fois.
Conservez les fichiers d’origine pour qu’un autre lecteur puisse vérifier les chiffres du rapport. Ne remplacez pas leurs libellés par des équivalents supposés.
Si le rapport payant manque, indiquez que le résultat payant est manquant. Si une définition organique manque de clarté, indiquez qu’elle reste à clarifier. Un outil de collecte publique ne peut pas fournir un indicateur de diffusion absent des données du propriétaire.
Un zéro enregistré a un autre sens. Utilisez zéro uniquement lorsqu’une source valide indique explicitement zéro pour l’indicateur et le périmètre demandés. Le périmètre désigne les contenus, les comptes, les dates et les filtres couverts par une valeur.
3. Construisez un registre des sources
Un registre des sources est un tableau qui relie chaque valeur du rapport à sa preuve. Construisez-le avant de calculer les totaux. Conservez la valeur source à côté de son libellé exact et de son périmètre.
Utilisez ces champs comme point de départ :
| Champ | Éléments à conserver |
|---|---|
| `source_record` | Une référence au fichier source et à la ligne ou au total d’origine |
| `source_metric` | Le libellé exact de l’indicateur dans cette source |
| `content_id` | L’identifiant vérifié de la publication, ou une valeur manquante s’il reste à vérifier |
| `ad_id` | L’identifiant de la publicité, si disponible |
| `period` | Les dates de début et de fin de mesure, le cas échéant |
| `scope` | Le type de diffusion, le compte, les filtres et l’unité de ligne |
| `observation_time` | La date et l’heure du relevé public, ou la mention « inconnues » si elles sont indisponibles |
| `precision` | Le caractère exact, arrondi ou de précision inconnue du nombre |
| `completeness_note` | Les champs manquants, la couverture partielle des données et les autres limites |
Conservez aussi la valeur numérique, le nom du fichier source, le fuseau horaire et les éventuels paramètres d’attribution. Gardez les définitions sources avec le registre. Ces champs sont proposés pour le rapport. Cela ne signifie pas que l’outil de collecte produit ce tableau.
N’utilisez pas un même champ de date à des fins différentes. La période du rapport indique l’intervalle couvert par un résultat du propriétaire. La date et l’heure d’observation indiquent quand vous avez relevé un compteur public. La date et l’heure de téléchargement du fichier ne remplacent aucune de ces informations.
Préservez les valeurs manquantes lors de l’importation des fichiers. Une cellule vide, un indicateur indisponible et un zéro enregistré doivent rester distincts. Si un fichier ne précise aucun fuseau horaire, notez cette lacune au lieu d’en choisir un sans le signaler.
Gardez la mention « arrondie » pour les valeurs arrondies. Ajouter des décimales dans un tableur ne rend pas la source plus précise.
4. Reliez les publicités aux publications sans copier les totaux des publications
Un identifiant de contenu désigne une publication précise. Un identifiant publicitaire désigne un enregistrement publicitaire. Gardez-les comme des clés distinctes. Une clé est une valeur qui sert à trouver et à relier des enregistrements.
Utilisez trois tables :
- Une table des publicités, avec chaque enregistrement publicitaire conservé et sa référence à la source du propriétaire.
- Une table des publications, avec un enregistrement vérifié pour chaque identifiant de publication publique.
- Une table de correspondance, avec les liens prouvés entre publicités et publications.
Une table de correspondance permet de relier plusieurs publicités à une publication sans copier plusieurs fois son compteur public.
Reliez une publicité à une publication uniquement si un enregistrement du propriétaire ou un lien source vérifié prouve cette relation. Un texte similaire, des images identiques ou des dates proches ne suffisent pas à établir le lien. Laissez toute relation non prouvée en suspens.
Une jointure est une opération qui relie les enregistrements correspondants de plusieurs tables. Lorsque deux publicités sont reliées à une publication, une vue issue d’une jointure peut afficher deux fois la valeur publique de cette publication. Cette vue peut servir à la vérification, mais elle ne constitue pas une source fiable pour calculer un total public.
Calculez les totaux publics à partir des enregistrements distincts des publications à la date et à l’heure d’observation choisies. « Distincts » signifie que chaque identifiant vérifié de publication apparaît une seule fois. Calculez les résultats publicitaires à partir des enregistrements compatibles du propriétaire. Ne supprimez pas un enregistrement publicitaire valide simplement parce qu’il partage une publication avec une autre publicité.
Vérifiez aussi si un fichier du propriétaire contient déjà des lignes de synthèse. Gardez chaque synthèse séparée des lignes détaillées qui servent à la produire.
5. Ajoutez un instantané public uniquement s’il est utile
Un instantané est un relevé effectué à un moment précis. Les instantanés publics peuvent apporter du contexte au rapport du propriétaire, mais ils ne le remplacent pas.
Le contrat de Facebook Metrics Scraper, vérifié le 25 octobre 2026 ; champs documentés, aucun test d’exécution décrit des compteurs publics et des identifiants de contenus. Il ne fournit ni répartition de la diffusion payante et organique du propriétaire, ni couverture, ni dépenses. La couverture mesure l’audience atteinte selon la définition d’une source. Les nombres d’actions publiques ne permettent pas d’établir cette audience.
Pour vérifier une publication publique connue, voici une petite entrée proposée :
{"maxItems":1,"mode":"knownUrls","startUrls":["https://www.facebook.com/reel/2645452435840671"]}Remplacez l’URL Facebook de l’exemple par l’URL du contenu public que vous avez vérifiée. L’exemple ne constitue pas une preuve sur votre campagne. `knownUrls` sélectionne des URL directes de contenus au moyen de `startUrls`. `maxItems` limite le nombre de lignes d’indicateurs. L’entrée fournie respecte la structure documentée ; aucune exécution n’a été effectuée pour ce guide. Le contrat vérifié ne prend pas en charge les URL des Stories Facebook.
Pour chaque relevé public collecté, conservez :
- `contentId` et `contentUrl` pour identifier le contenu.
- Les compteurs disponibles, avec leurs noms d’origine.
- `contentMetricStatus`, qui enregistre le statut, la précision et les détails de la source de chaque compteur.
- `status` et `statusReason`, qui décrivent le résultat de collecte de la ligne.
- `scrapedAt`, qui enregistre la date et l’heure d’observation.
Un nombre seul ne suffit pas. Lisez son statut et sa précision avant de l’utiliser. Gardez une valeur manquante pour un compteur indisponible. Ne la remplacez pas par zéro.
Le schéma d’entrée indique que `includeFailedRows` vaut false par défaut. Avec ce réglage, les lignes en échec, invalides ou sans indicateur public sont comptées dans le résumé d’exécution, mais ne sont pas ajoutées au jeu de données. Comparez votre liste de contenus demandés aux résultats disponibles. L’absence d’une ligne dans le jeu de données ne prouve pas qu’une publication n’a eu aucune activité.
L’outil collecte des données publiques. Vous devez construire séparément la table de correspondance, le registre des sources et le rapport de rapprochement. Le rapprochement consiste à vérifier si les résultats des sources peuvent être comparés ou combinés.
6. Vérifiez la compatibilité avant de faire les calculs
Deux nombres peuvent sembler liés tout en répondant à des questions différentes. Vérifiez leur compatibilité avant de les comparer, de les additionner ou de les soustraire.
| Point à vérifier | Question à résoudre |
|---|---|
| Identifiant | Les valeurs concernent-elles le même contenu vérifié ? |
| Indicateur | Leurs libellés exacts et leurs définitions correspondent-ils ? |
| Unité | Comptent-elles le même type d’action ou d’audience ? |
| Intervalle | Couvrent-elles des dates et des fuseaux horaires compatibles ? |
| Périmètre | Leurs comptes, leurs libellés de diffusion et leurs filtres correspondent-ils à la question ? |
| Précision | Les valeurs sont-elles exactes, arrondies ou de précision inconnue ? |
| Couverture des données | Tous les enregistrements nécessaires sont-ils présents ? |
| Chevauchement | La même action ou la même personne peut-elle être comptée dans les deux valeurs ? |
Un indicateur du propriétaire mesuré sur une période couvre un intervalle défini. Un compteur public cumulé correspond au total affiché à la date et à l’heure d’observation. Ce total public peut inclure une activité située hors de la période du rapport du propriétaire. Vérifier les deux le même jour ne rend pas leurs intervalles identiques.
Gardez la couverture séparée des nombres d’actions. Même si vous disposez de la couverture payante et de la couverture organique, leurs audiences peuvent se chevaucher. Ne les additionnez pas pour présenter le résultat comme un nombre de personnes uniques. Ne soustrayez pas l’une d’un compteur d’actions publiques pour inventer l’autre.
Un compteur public ne permet pas non plus d’établir si une publication a bénéficié d’une promotion payante. Utilisez les preuves du propriétaire pour répondre à cette question.
Si vous avez besoin d’un taux de réaction publique, consultez le guide du taux d’engagement Facebook sans accès administrateur. Il présente un autre calcul. Gardez ce calcul en dehors du présent rapprochement des données de diffusion.
Si vous avez besoin de mesurer les variations entre des relevés publics, consultez le guide de l’historique des indicateurs des publications Facebook. Un instantané actuel ne peut pas fournir un relevé passé manqué ni une répartition entre payant et organique.
7. Étudiez un exemple avec soin
Fiction originale ; aucun résultat de campagne réelle. Cet exemple montre comment traiter les enregistrements et respecter les limites des sources. Il ne décrit pas une exécution de collecte.
Deux lignes publicitaires, AD1 et AD2, correspondent à une seule publication publique, P1. Les sources disponibles étayent trois faits :
| Source | Valeur étayée | Unité et périmètre |
|---|---|---|
| Rapport payant du propriétaire | 40 | Interactions payantes sur la période, selon la définition conservée |
| Rapport organique du propriétaire | 70 | Interactions organiques sur la période, selon la définition conservée |
| Instantané public actuel de P1 | 100 | Mentions J’aime publiques cumulées à la date et à l’heure d’observation |
Conservez deux enregistrements publicitaires, un enregistrement de publication et deux liens de correspondance. La source payante étaye une valeur déclarée de 40. L’exemple ne fournit aucune répartition de ces interactions entre AD1 et AD2. N’inventez pas cette répartition et ne copiez pas 40 dans les deux lignes publicitaires comme résultat individuel.
Examinez maintenant le compteur public. Un affichage issu d’une jointure peut montrer P1 à côté d’AD1, puis à côté d’AD2. Additionner les valeurs de cet affichage donnerait :
100 mentions J’aime + 100 mentions J’aime = 200 mentions J’aime.
Ce calcul compte deux fois la même observation de publication. La section publique doit afficher une seule fois les 100 mentions J’aime de P1.
Les libellés des interactions payantes et organiques diffèrent aussi du libellé des mentions J’aime publiques. La soustraction des nombres donne :
100 − 40 = 60 sur le plan numérique.
Cela ne donne pas 60 mentions J’aime organiques. Le calcul mélange des mentions J’aime publiques cumulées et des interactions payantes sur une période.
De même, 40 + 70 = 110 sur le plan numérique. Mais les définitions fournies ne permettent pas d’établir un résultat combiné valide pour les interactions. Le nombre 110 n’a pas non plus à égaler les 100 mentions J’aime publiques de P1. Ce sont des faits différents issus des sources.
Les preuves permettent de présenter séparément 40 interactions payantes sur la période, 70 interactions organiques sur la période et 100 mentions J’aime publiques cumulées. Demandez des définitions et des intervalles compatibles avant de tenter de combiner les résultats.
8. Présentez des résultats distincts et un journal des points non résolus
Construisez le rapport autour des faits étayés par chaque source. Chaque section doit préciser sa source, son indicateur, sa période ou sa date et son heure d’observation, son périmètre et le caractère complet ou incomplet de ses données.
La section payante contient les résultats payants compatibles du propriétaire. La section organique contient ses résultats organiques compatibles. La section publique contient une seule fois chaque observation de publication sélectionnée. Présentez les valeurs publiques comme des compteurs publics, et non comme des résultats organiques.
Présentez les écarts non résolus dans un journal de rapprochement :
| Problème | Décision actuelle | Prochaine preuve nécessaire |
|---|---|---|
| La source payante est absente | Indiquer que le résultat payant est manquant | Un rapport autorisé du propriétaire pour le périmètre demandé |
| La relation entre publicité et publication n’est pas prouvée | Laisser la relation en suspens | Un enregistrement du propriétaire ou un lien source vérifié |
| Les définitions des interactions diffèrent | Garder les valeurs séparées | Les définitions exactes des deux indicateurs |
| La période du propriétaire et l’intervalle public diffèrent | Présenter des résultats distincts | Des preuves permettant une comparaison compatible |
| Le compteur public est indisponible | Garder la valeur manquante | Un relevé valide avec son statut |
| La valeur publique est arrondie | Conserver la note de précision | Une source plus précise si la décision l’exige |
Un écart seul ne prouve pas un retard, une erreur ou une activité manquante. Notez ce qui diffère et les preuves qui permettraient de résoudre cet écart. Si les preuves nécessaires restent indisponibles, conservez cette limite dans le rapport.
Ne forcez pas les trois sections à concorder au moyen d’une ligne d’ajustement. Un ajustement inexpliqué masque l’absence de preuves.
9. Vérifiez le rapport complet avant sa diffusion
Validez le rapport uniquement lorsque ces contrôles sont satisfaits :
- Chaque valeur affichée peut être reliée à un enregistrement source d’origine.
- Chaque total combiné utilise des unités, des périodes et des périmètres compatibles.
- Chaque lien entre publicité et publication repose sur une preuve.
- Chaque observation de publication publique contribue une seule fois à son total public.
- Les lignes publicitaires détaillées et les lignes de synthèse du propriétaire ne comptent pas les mêmes résultats deux fois.
- Les valeurs manquantes restent distinctes des zéros enregistrés.
- Les valeurs arrondies conservent leurs limites de précision.
- Les nombres d’actions ne sont pas présentés comme des nombres de personnes.
- Les données payantes ou organiques manquantes restent visibles.
- Chaque point non résolu précise la prochaine preuve nécessaire.
Ces contrôles permettent de produire un rapport dont les valeurs peuvent être vérifiées à partir des sources. Ils n’établissent ni l’attribution des ventes, ni le rendement publicitaire, ni une référence universelle de performance.
La prochaine décision dépend du point non résolu. Demandez des preuves au propriétaire lorsqu’une donnée de diffusion manque. Vérifiez un lien source lorsqu’un identifiant est incertain. Gardez les résultats séparés lorsque les définitions restent incompatibles.
Sources et lectures complémentaires
- Version par défaut 1.1.26 de Facebook Metrics Scraper et éléments fournis du README, vérifiés le 25 octobre 2026 ; documentation statique des entrées et des sorties, aucun test d’exécution
- Page publique du produit Facebook Metrics Scraper, éléments fournis vérifiés le 25 octobre 2026 ; adéquation documentée pour la collecte publique, aucune répartition de la diffusion payante ou organique
- Analyses organiques et payantes Facebook + LinkedIn, consulté le 11 août 2026 ; une seule question publique, extrait concernant LinkedIn, aucune estimation de la demande
Par Chronometrica · Mis à jour
Retour en haut ↑
