Metrics
Métriques YouTube via l'API
Votre client connecte son compte YouTube et votre produit interroge 51 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": "youtube:views",
"component": "number_v1",
"metrics": [
"views"
]
}
]
}Plus d'exemples d'appels YouTube
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
Abonnés gagnés par jour
La différence du nombre total d'abonnés, obtenue en soustrayant le nombre d'abonnés perdus avec le nombre de nouveaux abonnés sur la période analysée.
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": "youtube:subscribers_by_day",
"component": "chart_v1",
"metrics": [
"subscribersGained"
],
"dimensions": [
"day"
]
}
]
}Tableau
Vidéos à la une
Vidéos qui ont eu le plus grand impact sur votre audience sur la période analysée.
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": "youtube:engaging_videos",
"component": "datatable_v1",
"metrics": [
"views",
"likes",
"subscribersGained",
"publishedAt"
],
"dimensions": [
"video"
]
}
]
}Chiffre
Mentions J'aime (Total)
Nombre total de 'j'aime' reçus sur les vidéos, shorts ou diffusions en direct de la chaîne pendant la période du rapport.
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": "youtube:likes",
"component": "number_v1",
"metrics": [
"likes"
]
}
]
}Chiffres
42 métriques
Vues (Total)
Nombre total de fois que les vidéos, shorts ou diffusions en direct de la chaîne ont été visionnés pendant la période du rapport.
youtube:viewsMentions J'aime (Total)
Nombre total de 'j'aime' reçus sur les vidéos, shorts ou diffusions en direct de la chaîne pendant la période du rapport.
youtube:likesMentions Je n'aime pas (Total)
Nombre total de 'je n'aime pas' reçus sur les vidéos, shorts ou diffusions en direct de la chaîne pendant la période du rapport.
youtube:dislikesCommentaires (Total)
Nombre total de commentaires reçus sur les vidéos, shorts ou diffusions en direct de la chaîne pendant la période du rapport.
youtube:commentsPartages (Total)
Nombre total de fois que les vidéos, shorts ou diffusions en direct de la chaîne ont été partagés par les spectateurs pendant la période du rapport.
youtube:sharesAbonnés gagnés (par jour)
Nombre total de nouveaux abonnés acquis grâce aux vidéos, shorts ou diffusions en direct de la chaîne pendant la période du rapport.
youtube:subscribers_gainedAbonnés perdus (Total)
Nombre total d'abonnés ayant cessé de suivre la chaîne, comptabilisés à partir des vidéos, shorts ou diffusions en direct de la chaîne pendant la période du rapport.
youtube:subscribers_lostAbonnés pendant la période
Variation nette des abonnés. La différence entre le nombre de nouveaux abonnés et le nombre d'abonnés perdus au cours de la période analysée.
youtube:subscribers_variationMinutes estimées regardées (par jour)
Temps total (en heures) que les spectateurs ont passé à regarder les vidéos, shorts ou diffusions en direct de la chaîne.
youtube:estimated_minutes_watchedPourcentage moyen de visualisation
Pourcentage moyen de la lecture des vidéos vues sur la chaîne, sur la période analysée.
youtube:average_view_percentageDurée moyenne de visualisation
La durée moyenne, en seconde, de la lecture des vidéos.
youtube:average_view_durationVues sur la chaîne
Nombre total de vues sur la chaîne au fil du temps.
youtube:view_countAbonnement à la chaîne
Nombre total d'abonnés sur la chaîne au fil du temps. Youtube peut prendre du temps à mettre à jour cet indicateur, ou arrondir sa valeur, il se peut donc que ce soit légèrement différent du véritable nombre.
youtube:subscriber_countVidéos de la chaîne
Nombre total de vidéos sur la chaîne au fil du temps.
youtube:video_countVidéos du canal sur la période
Total de vidéos publiées sur la période analysée.
youtube:video_count_in_periodImpressions publicitaires
Nombre d'impressions publicitaires diffusées sur les vidéos de votre chaîne. Disponible uniquement pour les chaînes monétisées (Programme Partenaire YouTube). Ne correspond pas aux impressions des miniatures de YouTube Studio.
youtube:impressionsRevenus estimés
Revenu net total estimé de Google, y compris toutes les sources publicitaires et autres sources non publicitaires, pour la période et la région sélectionnées. Cette estimation de revenu est sujette à des ajustements de fin de mois et n'inclut pas la publicité vendue et servie par des partenaires.
youtube:estimed_revenueTDC
Vues divisées par les impressions publicitaires. Disponible uniquement pour les chaînes monétisées (Programme Partenaire YouTube). Ne correspond pas au taux de clics des miniatures de YouTube Studio.
youtube:ctrVues (Shorts)
Nombre total de fois que vos shorts ont été visionnés pendant la période d'examen.
youtube:views_shortsTemps total visionné (Shorts)
Temps total (en heures) que les utilisateurs ont regardé vos shorts pendant la période analysée.
youtube:estimated_minutes_watched_shortsMentions J'aime (Shorts)
Le nombre de fois que les utilisateurs ont indiqué qu'ils aimaient un short en lui donnant une évaluation positive pendant la période analysée.
youtube:likes_shortsMentions Je n'aime pas (Shorts)
Le nombre de fois que les utilisateurs ont indiqué qu'ils n'aimaient pas un short en lui donnant une évaluation négative pendant la période analysée.
youtube:dislikes_shortsCommentaires (Shorts)
Le nombre de fois que les utilisateurs ont commenté un short pendant la période analysée.
youtube:comments_shortsPartages (Shorts)
Le nombre de fois que les utilisateurs ont partagé un short via le bouton 'Partager' pendant la période analysée.
youtube:shares_shortsAbonnés gagnés (Shorts)
Le nombre de fois que les utilisateurs se sont abonnés à la chaîne après avoir regardé un short pendant la période analysée.
youtube:subscribers_gained_shortsAbonnés perdus (Shorts)
Le nombre de fois que les utilisateurs se sont désabonnés de la chaîne après avoir regardé un short pendant la période analysée.
youtube:subscribers_lost_shortsVues (En Direct)
Nombre total de fois que votre live a été visionné pendant la période d'examen.
youtube:views_live_streamTemps de visionnage (Live)
Durée totale (en heures) pendant laquelle les utilisateurs ont regardé votre live pendant la période analysée.
youtube:estimated_minutes_watched_live_streamMentions J'aime (Live)
Le nombre de fois que les utilisateurs ont indiqué qu'ils aimaient un live en lui attribuant une évaluation positive pendant la période analysée.
youtube:likes_live_streamMentions Je n'aime pas (Live)
Le nombre de fois que les utilisateurs ont indiqué qu'ils n'aimaient pas un live en lui attribuant une évaluation négative pendant la période analysée.
youtube:dislikes_live_streamCommentaires (En direct)
Le nombre de fois que les utilisateurs ont commenté une diffusion en direct pendant la période analysée.
youtube:comments_live_streamPartages (En Direct)
Le nombre de fois que les utilisateurs ont partagé un live via le bouton 'Partager' pendant la période analysée.
youtube:shares_live_streamAbonnés gagnés (En Direct)
Le nombre de fois que les utilisateurs se sont abonnés à la chaîne après avoir regardé un live pendant la période analysée.
youtube:subscribers_gained_live_streamAbonnés perdus (En Direct)
Le nombre de fois que les utilisateurs se sont désabonnés de la chaîne après avoir regardé un live pendant la période analysée.
youtube:subscribers_lost_live_streamVues (Vidéo)
Nombre de fois que le contenu de la catégorie "Vidéos" a été visionné pendant la période analysée. Cette métrique n’inclut pas les vues des Shorts ou des diffusions en direct.
youtube:views_video_on_demandTemps de visionnage (Vidéo)
Temps total, en heures, que les spectateurs ont passé à regarder du contenu dans la catégorie "Vidéos" pendant la période analysée. Cette métrique n’inclut pas le temps de visionnage des Shorts ou des diffusions en direct.
youtube:estimated_minutes_watched_video_on_demandMentions J'aime (Vidéo)
Nombre de fois que le contenu de la catégorie "Vidéos" a reçu une mention "J’aime" pendant la période analysée. Cette métrique n’inclut pas les vues des Shorts ou des diffusions en direct.
youtube:likes_video_on_demandMentions Je n'aime pas (Vidéo)
Nombre de fois que le contenu de la catégorie "Vidéos" a reçu une mention "Je n’aime pas" pendant la période analysée. Cette métrique n’inclut pas les vues des Shorts ou des diffusions en direct.
youtube:dislikes_video_on_demandCommentaires (Vidéo)
Nombre de fois que les utilisateurs ont commenté un contenu de la catégorie "Vidéos" pendant la période analysée. Cette métrique n'inclut pas les commentaires sur les Shorts ou les diffusions en direct.
youtube:comments_video_on_demandPartages (Vidéo)
Nombre de fois que les utilisateurs ont partagé du contenu de la catégorie "Vidéos" en utilisant le bouton "Partager" pendant la période analysée. Cette métrique n’inclut pas les partages de Shorts ou des diffusions en direct.
youtube:shares_video_on_demandAbonnés gagnés (Vidéo)
Nombre total de nouveaux abonnés acquis grâce au contenu de la catégorie "Vidéos" pendant la période analysée. Cette métrique n’inclut pas les abonnés gagnés grâce aux Shorts ou aux diffusions en direct.
youtube:subscribers_gained_video_on_demandAbonnés perdus (Vidéo)
Nombre total d’abonnés qui se sont désabonnés de la chaîne en raison du contenu de la catégorie "Vidéos" pendant la période analysée. Cette métrique n’inclut pas les abonnés perdus en raison des Shorts ou des diffusions en direct.
youtube:subscribers_lost_video_on_demand
Graphiques
5 métriques
Abonnés gagnés par jour
La différence du nombre total d'abonnés, obtenue en soustrayant le nombre d'abonnés perdus avec le nombre de nouveaux abonnés sur la période analysée.
youtube:subscribers_by_dayDurée de visualisation de la chaîne
Durée de visualisation de la chaîne en heures. Cela inclut les vidéos publiques, privées, non répertoriées et supprimées.
youtube:channel_display_time% de viewers par Âge et par Genre
Ce graphique montre le pourcentage de viewers qui ont regardé les vidéos de votre chaîne, organisés par âge et par genre.
youtube:viewers_by_age_and_genderPourcentage de spectateurs par genre
Ce graphique vous permet de vérifier le pourcentage de vues des vidéos publicitaires, regroupées par genre.
youtube:views_by_genderPourcentage de spectateurs par groupe d'âge
Ce graphique vous permet de vérifier le pourcentage de vues des vidéos publicitaires, regroupées par tranche d'âge.
youtube:views_by_age
Tableaux
4 métriques
Vidéos à la une
Vidéos qui ont eu le plus grand impact sur votre audience sur la période analysée.
youtube:engaging_videosToutes les vidéos sur la période
Vidéos publiées sur la période analysée.
youtube:all_videosVues par pays
Le public de votre chaîne par zone géographique. Les données sont basées sur l'adresse IP.
youtube:most_accessed_countriesShorts les plus performants
Performance des Shorts les plus regardés pendant la période analysée.
youtube:performance_shorts
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
