Insights sur les créateurs YouTube

Découvrez et récupérez des insights sur les créateurs YouTube grâce à la fonctionnalité Insights sur les créateurs. Cela peut être utile pour les agences et les annonceurs qui souhaitent trouver des créateurs pertinents pour leur audience cible.

L'API comporte quatre fonctions principales :

  1. Découverte de créateurs : trouvez des créateurs pertinents pour un ensemble donné de thèmes, de catégories démographiques, d'audiences ou d'attributs de créateur.
  2. Insights sur les thèmes des créateurs : récupérez des insights sur les créateurs pertinents qui créent du contenu sur des thèmes spécifiques.
  3. Insights sur les créateurs : récupérez des insights sur des chaînes YouTube spécifiques, comme le nombre d'abonnés, le nombre de vues et les données démographiques de l'audience.
  4. Insights sur les tendances : récupérez des insights sur des tendances spécifiques, en fonction d'audiences ou de thèmes spécifiques.

La découverte de créateurs locaux (recherche de créateurs basés dans un pays donné ou qui publient du contenu depuis ce pays et qui sont visionnés dans ce pays) est possible lorsque vous utilisez la découverte de créateurs basée sur des thèmes ou des insights sur les tendances en demandant des données supplémentaires. Vous pouvez également demander des insights sur le sentiment envers la marque pour les insights sur les tendances basés sur des thèmes en demandant des données supplémentaires.

Critères d'éligibilité

GenerateCreatorInsights est un composant privé de l'API Google Ads proposé avec une licence de données non exclusive et sans redevance. Les partenaires connectés peuvent utiliser les bibliothèques clientes Google Ads standards pour explorer les créateurs et les contenus YouTube. Pour être éligibles, les partenaires doivent remplir les conditions suivantes :

  • Disposer d'un outil de planification ou d'une interface utilisateur qui intégrera l'API Google Ads.
  • Utiliser l'API pour explorer les contenus et les créateurs YouTube afin d'identifier des opportunités publicitaires potentielles.
  • Réussir une évaluation de présélection pour vérifier leur éligibilité.
  • Respecter les exigences d'utilisation des données et accepter de se soumettre à des audits de données périodiques.
  • Signer un contrat de licence de données qui impose légalement les exigences d'utilisation des données.
  • Accepter les conditions d'utilisation de l'API Google Ads.

Pour plus d'informations, contactez votre représentant Google.

Générer des insights sur les créateurs

Pour générer des insights sur les créateurs, envoyez une requête à la GenerateCreatorInsights méthode. Cette méthode est limitée à cinq requêtes par seconde (RPS). Elle accepte différents types d'entrées selon que vous souhaitez découvrir des créateurs, rechercher des créateurs pertinents par thème ou obtenir des insights sur les créateurs. Vous devez fournir les pays à partir desquels vous souhaitez obtenir des données.

  1. Découverte de créateurs : vous pouvez fournir une liste d'attributs d'audience, tels que l'âge, le genre et les centres d'intérêt des utilisateurs (y compris les audiences d'affinité, sur le marché et d'événements de la vie). L'API renvoie une liste de créateurs dont les audiences correspondent à ces attributs. Vous pouvez également fournir des attributs de créateur pour filtrer les créateurs dont le contenu correspond spécifiquement aux attributs de créateur que vous avez saisis.

    Vous pouvez récupérer les attributs d'audience disponibles à l'aide de ListAudienceInsightsAttributes, en fournissant les dimensions pour lesquelles vous souhaitez des attributs, comme KNOWLEDGE_GRAPH pour les thèmes d'intérêt.

    Depuis l'API Google Ads v23, vous pouvez spécifier des relations complexes entre les attributs d'audience à l'aide de audience_combinations. Ce champ vous permet de définir des audiences avec une logique booléenne (ET/OU) qui n'est pas possible avec audience_attributes.

    Bien que audience_attributes soit adapté au ciblage basé sur une liste d'attributs combinés (avec l'opérateur OR) (par exemple, les utilisateurs intéressés par "sports" OU "voyages" OU ...), audience_combinations offre un contrôle plus précis. Chaque InsightsAudienceAttributeGroup dans audience_combinations combine des attributs avec un opérateur logique OR. Ces groupes sont ensuite combinés avec un opérateur logique AND.

    Par exemple, pour cibler une audience intéressée par ("Soins de la peau" OU "Soins des cheveux") ET aussi par "Cosmétiques", vous devez utiliser deux éléments InsightsAudienceAttributeGroup dans audience_combinations. "Soins de la peau", "Soins des cheveux" et "Cosmétiques" sont des thèmes d'intérêt, représentés par des entités Knowledge Graph (par exemple, /m/014trl pour les cosmétiques). Le premier groupe contient des attributs d'entité Knowledge Graph pour "Soins de la peau" et "Soins des cheveux", et le deuxième groupe contient l'attribut d'entité Knowledge Graph pour "Cosmétiques".

    Notez que si vous spécifiez des entités Knowledge Graph, des catégories de produits et services ou des centres d'intérêt des utilisateurs dans audience_attributes, vous ne pouvez pas utiliser audience_combinations. Si vous utilisez audience_combinations, vous devez spécifier ces attributs dans audience_combinations et non dans audience_attributes. Toutefois, vous pouvez toujours utiliser audience_attributes pour d'autres types d'attributs tels que les données démographiques en conjonction avec audience_combinations.

  2. Insights sur les thèmes des créateurs : fournissez une liste de thèmes de contenu à l'aide du search_topics champ. L'API renvoie les créateurs pertinents qui créent du contenu sur les thèmes spécifiés. Les données récupérées sont basées sur le pays spécifié dans country_locations. Notez que cette option ne permet de rechercher que dans un seul pays.

    Les entités compatibles dans le champ SearchTopics doivent être balisées avec la fonctionnalité CONTENT_TRENDING_INSIGHTS ou CREATOR_TOPIC_INSIGHTS. Utilisez la ListAudienceInsightsAttributes méthode pour récupérer les fonctionnalités d'entité compatibles.

    Remarque : L'option search_brand a été abandonnée dans la version 24.2 et supprimée dans la version 25. Utilisez search_topics plutôt.

  3. Insights sur les créateurs : fournissez une liste d'ID de chaînes YouTube à l'aide du search_channels champ. L'API renvoie des insights sur ces chaînes spécifiques.

Données supplémentaires et créateurs locaux

Par défaut, seules les données d'insight de base sont renvoyées. Vous pouvez demander des fonctionnalités facultatives et des données supplémentaires dans votre réponse en définissant le champ répété supplemental_data.

Par exemple, vous pouvez demander des données sur les créateurs locaux en ajoutant la valeur d'énumération LOCAL_CREATOR_DATA au champ supplemental_data. Si vous recherchez des créateurs à l'aide de search_topics (et que le thème est une entité Knowledge Graph balisée avec la fonctionnalité CREATOR_TOPIC_INSIGHTS), l'API remplira le champ local_creator_insights de la réponse avec les créateurs locaux qui ont accepté de partager leurs données de localisation.

Notez les spécifications suivantes pour la découverte de créateurs locaux :

  • Définition : les "créateurs locaux" sont des créateurs basés dans le pays sélectionné ou qui publient du contenu depuis ce pays et qui sont visionnés dans ce pays.
  • Contrainte : la découverte de créateurs locaux n'est pas possible lorsque sub_country_locations est défini dans la requête.
  • Fonctionnalités : vous pouvez récupérer la liste des entités Knowledge Graph compatibles et leurs fonctionnalités à l'aide de ListAudienceInsightsAttributes.

La méthode generateCreatorInsights renvoie un objet GenerateCreatorInsightsResponse. Cet objet contient les champs suivants :

  • creator_insights: liste d'objets YouTubeCreatorInsights correspondant à vos critères de base.
  • local_creator_insights: liste d'objets YouTubeCreatorInsights pour les créateurs locaux. Ce champ n'est rempli que si LOCAL_CREATOR_DATA a été demandé et que le critère utilisé était search_topics.

Chaque objet YouTubeCreatorInsights contient les informations suivantes sur un créateur :

  • Nom du créateur
  • Chaîne YouTube
  • Métriques totales du créateur
  • Liste des statistiques de la chaîne YouTube

L'objet YouTubeMetrics contient les métriques suivantes :

  • Nombre d'abonnés
  • Nombre de vues
  • Nombre de vidéos
  • Est un créateur de Shorts actif
  • Opportunités de partenariat (à partir de la version 23)

Pour déterminer si un créateur est éligible aux partenariats de contenu de marque original, vérifiez partnership_opportunities. Un créateur est éligible si la liste contient la valeur CREATOR_PARTNERSHIPS.

L'objet YouTubeChannelInsights contient les informations suivantes sur une chaîne YouTube :

  • Nom de la chaîne
  • ID de la chaîne
  • URL de la chaîne
  • Description de la chaîne
  • Métriques de la chaîne
  • Attributs de l'audience de la chaîne (tels que la répartition par âge, par genre et par centres d'intérêt des utilisateurs)
  • Vidéos les plus regardées
  • Type de chaîne
  • Langues associées au contenu de la chaîne
  • Score de pertinence (pour les recherches de tendances par thème uniquement)
  • Indique si le créateur a donné son consentement pour partager des métriques non publiques

Pour générer des insights sur les tendances, envoyez une requête à la GenerateTrendingInsights méthode. Cette méthode est limitée à cinq requêtes par seconde (RPS). Elle accepte deux types d'entrées selon que vous souhaitez obtenir des tendances d'audience ou des tendances par thème. Vous devez fournir le pays spécifique à partir duquel vous souhaitez obtenir des tendances.

  1. Tendances d'audience : vous pouvez fournir une liste d'attributs d'audience, tels que l'âge, le genre et les centres d'intérêt des utilisateurs (y compris les audiences d'affinité, sur le marché et d'événements de la vie). L'API renvoie une liste d'insights sur les tendances pour ces audiences, y compris des métriques telles que l'évolution en pourcentage de la valeur de la tendance sur la période de comparaison.

    Vous pouvez récupérer les attributs d'audience disponibles à l'aide de ListAudienceInsightsAttributes, en fournissant les dimensions pour lesquelles vous souhaitez des attributs, comme KNOWLEDGE_GRAPH pour les thèmes d'intérêt.

    Depuis l'API Google Ads v23, vous pouvez spécifier des relations complexes entre les attributs d'audience à l'aide de audience_combinations. Ce champ vous permet de définir des audiences avec une logique booléenne (ET/OU) qui n'est pas possible avec audience_attributes.

    Bien que audience_attributes soit adapté au ciblage basé sur une liste d'attributs combinés (avec l'opérateur OR) (par exemple, les utilisateurs intéressés par "sports" OU "voyages" OU ...), audience_combinations offre un contrôle plus précis. Chaque InsightsAudienceAttributeGroup dans audience_combinations combine des attributs avec un opérateur logique OR. Ces groupes sont ensuite combinés avec un opérateur logique AND.

    Par exemple, pour cibler une audience intéressée par ("Soins de la peau" OU "Soins des cheveux") ET aussi par "Cosmétiques", vous devez utiliser deux éléments InsightsAudienceAttributeGroup dans audience_combinations. "Soins de la peau", "Soins des cheveux" et "Cosmétiques" sont des thèmes d'intérêt, représentés par des entités Knowledge Graph (par exemple, /m/014trl pour les cosmétiques). Le premier groupe contient des attributs d'entité Knowledge Graph pour "Soins de la peau" et "Soins des cheveux", et le deuxième groupe contient l'attribut d'entité Knowledge Graph pour "Cosmétiques".

    Notez que si vous spécifiez des entités Knowledge Graph, des catégories de produits et services ou des centres d'intérêt des utilisateurs dans audience_attributes, vous ne pouvez pas utiliser audience_combinations. Si vous utilisez audience_combinations, vous devez spécifier ces attributs dans audience_combinations et non dans audience_attributes. Toutefois, vous pouvez toujours utiliser audience_attributes pour d'autres types d'attributs tels que les données démographiques en conjonction avec audience_combinations.

    Les attributs KNOWLEDGE_GRAPH comportent un ou plusieurs InsightsKnowledgeGraphEntityCapabilities tags. Les attributs compatibles avec les insights sur les tendances comportent des tags pertinents dans leurs métadonnées de réponse.

    Notez que les développeurs ayant accès à ContentCreatorInsightsService auront également accès automatiquement à AudienceInsightsService.ListAudienceInsightsAttributes. Les autres points de terminaison de AudienceInsightsService nécessitent un processus de liste d'autorisation indépendant.

    Vous trouverez de la documentation supplémentaire sur ListAudienceInsightsAttributes dans le guide Insights sur l'audience.

  2. Tendances par thème : fournissez une liste de thèmes de contenu. L'API renvoie une liste d'insights sur les tendances pour ces thèmes, y compris des métriques telles que l'évolution en pourcentage de la valeur de la tendance sur la période de comparaison. Vous pouvez également demander des insights sur le sentiment envers la marque pour les thèmes de marque en demandant des données supplémentaires.

Comme pour la génération d'insights sur les créateurs, vous pouvez demander des fonctionnalités facultatives dans les insights sur les tendances en définissant le champ répété supplemental_data sur LOCAL_CREATOR_DATA ou BRAND_SENTIMENT_DATA.

Si votre requête de tendance utilise search_topics, la définition de supplemental_data sur LOCAL_CREATOR_DATA remplira le related_local_creators champ des objets TrendInsight renvoyés avec les créateurs locaux associés au thème demandé qui ont accepté de partager leurs données de localisation. La découverte de créateurs locaux est soumise à la même définition et aux mêmes contraintes (par exemple, elle n'est pas compatible avec sub_country_locations).

Si votre requête de tendance utilise search_topics, la définition de supplemental_data sur BRAND_SENTIMENT_DATA remplira le brand_sentiment_insights champ des objets TrendInsight renvoyés lorsque le thème d'entité Knowledge Graph demandé possède la fonctionnalité BRAND. Un thème de marque est une entité balisée avec la BRAND fonctionnalité. Vous pouvez récupérer les fonctionnalités d'entité compatibles à l'aide de la ListAudienceInsightsAttributes méthode.

La mesure du sentiment envers la marque implique l'utilisation de modèles d'IA (basés sur Gemini) pour analyser le contenu vidéo YouTube lié à la marque, en classant le sentiment comme positif, négatif ou neutre. Seul le contenu vidéo lui-même est analysé. Les commentaires des utilisateurs ne sont pas inclus.

La méthode GenerateTrendingInsights renvoie une liste d'objets TrendInsight, chacun contenant les éléments suivants :

  • trend_attribute : AudienceInsightsAttributeMetadata principal pour la tendance.
  • trend_metrics : métriques de la tendance, telles que l'évolution en pourcentage sur la période de comparaison.
  • trend_data_points : points de données historiques pour la tendance. Ce champ n'est rempli que pour les tendances utilisant search_topics.
  • related_videos : liste d'objetsAudienceInsightsAttributeMetadata pour les vidéos tendances associées au thème de la tendance. Ce champ n'est rempli que pour les tendances utilisant search_topics. Pour ces attributs, le champ imbriqué YouTubeVideoAttributeMetadata est rempli. Il contient des métadonnées au niveau de la vidéo (telles que l'URL de la vidéo, l'URL de la miniature et le nombre de vues ou de J'aime) et des métadonnées au niveau de la chaîne (telles que l'ID de la chaîne, le nom et l'URL de la chaîne).
  • brand_sentiment_insights : liste d'objetsBrandSentimentInsight pour la tendance. Ce champ n'est rempli que lorsque la requête de tendance utilise search_topics, que le thème d'entité Knowledge Graph possède la fonctionnalité BRAND et que BRAND_SENTIMENT_DATA est demandé dans supplemental_data. Chaque objet BrandSentimentInsight contient les éléments suivants :
    • month : mois que représente le sentiment envers la marque au format YYYY-MM.
    • has_insufficient_data: indique si les données sont insuffisantes pour calculer le sentiment envers la marque.
    • sentiment_distributions: répartition du sentiment entre positif, négatif et neutre, calculée comme la proportion de vues pour les vidéos correspondant à la marque avec chaque sentiment.
    • sentiment_summaries: résumés générés par l'IA de ce qui était positif et négatif dans le contenu lié à la marque, ainsi que des exemples de vidéos pour chaque sentiment. Les résumés ne sont générés que pour les sentiments positifs et négatifs, et non pour les sentiments neutres.
Précédent
Insights sur l'audience