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 données 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 les thèmes ou les insights sur les tendances 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éaliser une évaluation préalable 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 applique 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 indiquer 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 "le sport" OU "les voyages" OU ...), audience_combinations offre un contrôle plus précis. Chaque InsightsAudienceAttributeGroup dans audience_combinations combine des attributs avec un opérateur OR logique. Ces groupes sont ensuite combinés avec un opérateur AND logique.

    Par exemple, pour cibler une audience intéressée par ("les soins de la peau" OU "les soins des cheveux") ET aussi par "les 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 les 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 combinaison 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 compatible 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 renseigné 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 insights sur 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 indiquer 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 au cours de 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 "le sport" OU "les voyages" OU ...), audience_combinations offre un contrôle plus précis. Chaque InsightsAudienceAttributeGroup dans audience_combinations combine des attributs avec un opérateur OR logique. Ces groupes sont ensuite combinés avec un opérateur AND logique.

    Par exemple, pour cibler une audience intéressée par ("les soins de la peau" OU "les soins des cheveux") ET aussi par "les 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 les 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 combinaison 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 au cours de la période de comparaison.

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.

Si votre requête de tendances utilise search_topics, le related_local_creators champ des objets TrendInsight renvoyés sera rempli 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).

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 au cours de la période de comparaison.
  • trend_data_points : points de données historiques pour la tendance. Ce champ n'est renseigné que pour les tendances utilisant search_topics.
  • related_videos : liste d'objets pour les vidéos tendances associées au thème de la tendance.AudienceInsightsAttributeMetadata Ce champ n'est renseigné que pour les tendances utilisant search_topics. Pour ces attributs, le champ imbriqué YouTubeVideoAttributeMetadata est renseigné. 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).
Précédent
Insights sur l'audience