
Un Actor est un programme de collecte de données hébergé. Une Task est un préréglage d'entrée enregistré. L'Actor collecte les lignes sources, et le lecteur fait l'analyse.
Préparez votre Task publique actuelle et la collecte native
La version publique 1.1.2 de YouTube Metrics accepte des URL de vidéos connues dans `startUrls` et un `maxItems` fini. Remplacez la liste enregistrée de trois vidéos par une seule URL directe connue de la vidéo visée, et réglez `maxItems` sur 1. N'utilisez pas une entrée de chaîne pour laisser entendre que tout son historique de mises en ligne est disponible.
Utilisez un JSON d'entrée valide comme celui-ci :
JSON
{"startUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"], "maxItems": 1}Les champs du jeu de données collecté sont `inputUrl`, `postId`, `postUrl`, `postType`, `isShort`, `publishedAt`, `channelId`, `channelUrl`, `views`, `postMetricStatus`, `status` et `scrapedAt`. `postMetricStatus` est un tableau de `metric`, `value`, `status` et `precision`. Le statut de disponibilité est present, unavailable ou not_attempted, et il reste strictement séparé de la précision (`exact`, `display_rounded`, `likely_rounded`, `unavailable`, `unknown`). Les compteurs publics peuvent être exacts, ou affichés et arrondis, selon ce que rapporte le statut de la mesure. Les valeurs manquantes restent inconnues et ne doivent pas être traitées comme zéro. Les métadonnées facultatives ne sont pas garanties pour chaque source.
Les champs `OUTPUT` — `providedUrls`, `videoUrls`, `channelUrls`, `maxItems`, `resolvedUrls`, `metricRows`, `datasetRows`, `metadataOnlyRows`, `noPublicMetricRows`, `blockedRows`, `failedRows` et `statusCounts` — décrivent l'exécution de la collecte et la disponibilité des mesures, pas la compatibilité sémantique. Le contrôle actuel sur deux vidéos connues a renvoyé des identifiants sources, des URL, une identité de chaîne, des dates de publication, des compteurs publics et une disponibilité des mesures qui correspondent. Cela prouve une extraction bornée des métadonnées et des compteurs, pas les analyses privées de Studio, les spectateurs uniques, la durée regardée, le chevauchement d'audience ni les compteurs historiques au même âge. Une route Shorts fournie renvoyait à une vidéo musicale ordinaire plus ancienne. Ne certifiez pas le format du contenu à partir de la route, ni d'une valeur `postType` ou `isShort` non revue. Vérifiez manuellement le format requis par rapport à la source réelle.
Huit étapes pour harmoniser les mesures entre plateformes
- Énoncez d'abord la question d'analyse exacte, en précisant si vous comparez des démarrages de lecture, des personnes distinctes ou des fenêtres d'observation précises.
- Définissez l'unité comme ce qu'un compteur compte, le grain comme une vidéo, une publication, un compte ou un rapport, et la fenêtre comme la période ou la limite d'âge.
- Définissez cumulatif comme tous les comptages accumulés jusqu'au moment observé, et compatibilité comme le fait de répondre à la même question énoncée et aux mêmes règles sémantiques.
- Constituez une fiche de définition pour chaque mesure native, avec la plateforme, l'Actor, le champ natif, l'URL de la définition principale, la date de contrôle, la version documentée, les valeurs brutes et la précision.
- Gardez complètement séparés des définitions connues les sens inconnus, les champs sources non vérifiés et les définitions non résolues.
- Définissez R comme la compatibilité que le lecteur doit évaluer lui-même : elle exige, pour chaque paire visée, la correspondance de la définition, de la version, de l'unité, du grain, de la fenêtre, de la précision et de la portée.
- Évaluez chaque paire selon R. Enregistrez le statut compatible, incompatible ou non résolu, avec les conditions en échec. Évitez un regroupement transitif entre des questions différentes.
- Rejetez les affirmations non vérifiées, comme les spectateurs uniques, la performance uniquement organique, la supériorité causale ou les taux d'engagement universels, lorsque les mesures sous-jacentes ne les soutiennent pas.
Constituez les fiches de définition natives
Énoncez d'abord votre question exacte. Par exemple, demander quel élément compte le plus d'événements publics de démarrage de lecture au jour 7 diffère de demander quelle plateforme a atteint le plus de personnes distinctes. Un compteur peut soutenir la première question sans soutenir une question d'audience de personnes distinctes.
Constituez une fiche de définition pour chaque mesure native. Incluez la plateforme, l'Actor, le champ natif, l'URL directe de la définition principale, la date de contrôle, la version documentée, l'événement ou l'unité compté, le grain de l'élément ou du compte, la base cumulative ou à fenêtre fixe, les limites d'observation, la précision, et la portée publique, propriétaire ou payante et organique. Conservez le nombre source inchangé à côté de sa fiche de définition.
Lisez la définition principale actuelle qui correspond avant d'utiliser une étiquette familière. La page actuelle des mesures d'engagement de YouTube indique que les vues se comptent au démarrage de la lecture, pour tous les formats, à partir du 24 août 2026 YouTube Metrics. Son ancienne page Shorts enregistre le changement du 31 mars 2025 sur les démarrages et les relectures des Shorts YouTube Shorts. N'utilisez pas l'ancien contraste de formats comme la règle actuelle du format long. Ne supposez pas que tous les anciens compteurs cumulatifs ont été reconstruits sous une seule définition.
La page d'aide anglaise actuelle de X décrit le total des vues d'une publication, y compris les vues répétées, et indique qu'elles ne sont pas toutes uniques X View Counts. Ce n'est pas une mesure de démarrage de lecture vidéo. Conservez la source anglaise exacte et la version, car les pages d'autres locales peuvent différer. Pour le champ public général des vues de TikTok, ce contrôle n'a pas établi, à partir d'une source principale, de seuil correspondant pour l'événement de publication publique. Sa valeur reste un compteur natif observé, dont la définition sémantique n'est pas résolue. N'empruntez pas un seuil de vue d'Ads Manager ni une règle de vue qualifiée de Creator Rewards.
Évaluez la compatibilité avec la règle R
Définissez R comme la compatibilité que le lecteur doit évaluer lui-même pour la définition, la version, l'unité, le grain, la fenêtre, la précision et la portée énoncés. Les deux fiches de définition doivent être connues et sémantiquement équivalentes pour l'événement et l'unité demandés. Leurs versions documentées doivent être compatibles. Leur grain, leur fenêtre, leur précision et leur portée doivent soutenir le calcul demandé. R est une règle de décision du lecteur, pas une preuve fournie par un Actor. Des noms de plateforme identiques ne rendent pas R vrai, et des noms de plateforme différents ne rendent pas R faux.
Évaluez chaque paire et enregistrez compatible pour la question, incompatible pour la question, ou définition ou portée non résolue, avec la condition en échec. Une sémantique requise et inconnue ne peut pas être traitée comme une définition connue et égale. Ne formez un groupe de comparaison autorisé que lorsque chaque membre visé satisfait la règle. Ne reliez pas deux fiches incompatibles seulement parce que chacune ressemble à une troisième sous des questions différentes.
Ne faites que la comparaison autorisée par le groupe. Une différence entre des compteurs d'événements publics compatibles est une différence de ces événements observés. Elle ne signifie pas plus de personnes, une performance uniquement organique, ni une supériorité de plateforme. Les compteurs publics peuvent inclure des contributions publicitaires. L'absence d'une répartition entre payant et organique ne peut pas répondre à une question uniquement organique.
Matrice de compatibilité complète, fiction originale
Toutes les mesures, les dates et les éléments de cette section sont une fiction originale. La question porte sur les compteurs publics cumulatifs de démarrages de lecture vidéo, pour des éléments confirmés manuellement à l'âge de 7 jours, sous la politique contemporaine (après le 24 août 2026), sans restriction uniquement organique. Ce sont des fiches de sens créées par le lecteur, pas des champs d'Actor.
Tableau 1 : fiches de définition natives (fiction originale)
| ID d'élément | Plateforme / Actor | Champ natif et URL source | Date de contrôle et version | Unité comptée et grain | Fenêtre et limites | Précision et portée | Valeur comptée et notes |
|---|---|---|---|---|---|---|---|
| Y1 | YouTube / Metrics Scraper | `views` (YouTube Metrics) | 2026-10-13 / Politique postérieure au 24 août 2026 | Démarrages de lecture / Vidéo unique | Âge de 7 jours (publié le 2026-08-25) | Exacte / Publique | 1000 |
| Y2 | YouTube / Metrics Scraper | `views` (YouTube Metrics) | 2026-10-13 / Politique postérieure au 24 août 2026 | Démarrages de lecture / Vidéo unique | Âge de 7 jours (publié le 2026-08-26) | Exacte / Publique | 800 |
| X1 | X / Post Metrics | `views` (X Help) | 2026-10-13 / Anglais actuel | Vues de publication / Publication unique | Âge comparable (7 jours) | Affichée / Publique | 1000 |
| T1 | TikTok / TikTok Metrics | `views` (Définition non résolue) | 2026-10-13 / Version inconnue | Vues non vérifiées / Publication unique | Âge comparable (7 jours) | Inconnue / Publique | 1000 (Sémantique non résolue) |
| Y3 | YouTube / Metrics Scraper | `views` (YouTube Metrics) | 2026-10-13 / Historique à cheval sur le changement de définition | Démarrages de lecture / Vidéo unique | l'historique cumulatif chevauche une limite de version liée à un changement de définition | Exacte / Publique | L'historique cumulatif traverse une limite de version liée à un changement de définition |
| Y4 | YouTube / Metrics Scraper | `views` (YouTube Metrics) | 2026-10-13 / Politique postérieure au 24 août 2026 | Démarrages de lecture / Agrégat de chaîne | Grain du total de la chaîne | Exacte / Publique | Total agrégé de la chaîne |
| Y5 (Rapport) | YouTube / Studio (Propriétaire) | Rapport des spectateurs uniques | 2026-10-13 / Rapport propriétaire | Personnes distinctes / Rapport vidéo | Fenêtre d'âge de 7 jours | Exacte / Propriétaire | Comptage de spectateurs uniques, données du propriétaire (fiche de rapport séparée) |
Tableau 2 : matrice de décision des paires selon la règle R
| Paire testée | Question déclarée et cible | Statut de compatibilité et condition en échec | Action / notes sur le groupe autorisé |
|---|---|---|---|
| {Y1, Y2} | Démarrages de lecture vidéo publics et cumulatifs à l'âge de 7 jours | Compatible (Toutes les conditions sont remplies) | Groupe autorisé `{Y1, Y2}`. Différence : 200 événements de démarrage de lecture observés (pas 200 personnes distinctes). Note : si la question devient les personnes distinctes, Y1 et Y2 échouent tous les deux. |
| {Y1, X1} | Démarrages de lecture vidéo publics et cumulatifs à l'âge de 7 jours | Incompatible (Écart d'unité : vues de publication X contre démarrages de lecture vidéo) | Gardez-les séparés ; ne les combinez pas et ne les comparez pas directement. |
| {Y1, T1} | Démarrages de lecture vidéo publics et cumulatifs à l'âge de 7 jours | Définition ou portée non résolue (Définition contrôlée de l'événement public manquante) | Une sémantique requise et inconnue ne peut pas être traitée comme connue. |
| {Y1, Y3} | Démarrages de lecture vidéo publics et cumulatifs à l'âge de 7 jours | Version ou historique non résolu (L'historique cumulatif chevauche un changement de définition) | Incertitude sur l'historique de version, plutôt qu'incompatibilité. |
| {Y1, Y4} | Démarrages de lecture vidéo publics et cumulatifs à l'âge de 7 jours | Incompatible (Écart de grain : vidéo unique contre agrégat de chaîne) | Fiche source séparée ; ce n'est pas une ligne de contrôle d'une vidéo directe. |
| {Y1, Y5} | Démarrages de lecture vidéo publics et cumulatifs à l'âge de 7 jours | Incompatible (Écart d'unité et de portée : démarrages de lecture contre spectateurs uniques des données du propriétaire) | Fiche de rapport propriétaire séparée ; écart de portée. |
Sources et lectures complémentaires
Par Chronometrica · Mis à jour
Retour en haut ↑

