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"
      ]
    }
  ]
}
Exemple : « Vues (Total) » en octobre, comparé à septembre.

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:views
  • 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.

    youtube:likes
  • Mentions 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:dislikes
  • Commentaires (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:comments
  • Partages (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:shares
  • Abonné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_gained
  • Abonné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_lost
  • Abonné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_variation
  • Minutes 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_watched
  • Pourcentage 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_percentage
  • Durée moyenne de visualisation

    La durée moyenne, en seconde, de la lecture des vidéos.

    youtube:average_view_duration
  • Vues sur la chaîne

    Nombre total de vues sur la chaîne au fil du temps.

    youtube:view_count
  • Abonnement à 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_count
  • Vidéos de la chaîne

    Nombre total de vidéos sur la chaîne au fil du temps.

    youtube:video_count
  • Vidéos du canal sur la période

    Total de vidéos publiées sur la période analysée.

    youtube:video_count_in_period
  • Impressions 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:impressions
  • Revenus 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_revenue
  • TDC

    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:ctr
  • Vues (Shorts)

    Nombre total de fois que vos shorts ont été visionnés pendant la période d'examen.

    youtube:views_shorts
  • Temps total visionné (Shorts)

    Temps total (en heures) que les utilisateurs ont regardé vos shorts pendant la période analysée.

    youtube:estimated_minutes_watched_shorts
  • Mentions 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_shorts
  • Mentions 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_shorts
  • Commentaires (Shorts)

    Le nombre de fois que les utilisateurs ont commenté un short pendant la période analysée.

    youtube:comments_shorts
  • Partages (Shorts)

    Le nombre de fois que les utilisateurs ont partagé un short via le bouton 'Partager' pendant la période analysée.

    youtube:shares_shorts
  • Abonné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_shorts
  • Abonné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_shorts
  • Vues (En Direct)

    Nombre total de fois que votre live a été visionné pendant la période d'examen.

    youtube:views_live_stream
  • Temps 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_stream
  • Mentions 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_stream
  • Mentions 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_stream
  • Commentaires (En direct)

    Le nombre de fois que les utilisateurs ont commenté une diffusion en direct pendant la période analysée.

    youtube:comments_live_stream
  • Partages (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_stream
  • Abonné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_stream
  • Abonné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_stream
  • Vues (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_demand
  • Temps 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_demand
  • Mentions 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_demand
  • Mentions 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_demand
  • Commentaires (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_demand
  • Partages (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_demand
  • Abonné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_demand
  • Abonné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_day
  • Duré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_gender
  • Pourcentage 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_gender
  • Pourcentage 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_videos
  • Toutes les vidéos sur la période

    Vidéos publiées sur la période analysée.

    youtube:all_videos
  • Vues 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_countries
  • Shorts 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.