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 aux agences et aux 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éateurs.
  2. Insights sur les thèmes de créateurs : obtenez des insights sur les créateurs pertinents qui publient des contenus sur des thèmes spécifiques.
  3. Insights sur les créateurs : obtenez 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. Tendances : obtenez des insights sur des tendances spécifiques, en fonction d'audiences ou de thèmes spécifiques.

La découverte de créateurs locaux (trouver des créateurs basés dans un pays donné ou qui publient des contenus depuis ce pays, et qui sont regardés dans ce pays) est possible lorsque vous utilisez la découverte de créateurs par thème 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
  • Utilisez l'API pour explorer les contenus et les créateurs YouTube afin d'identifier des opportunités publicitaires potentielles.
  • Effectuez une évaluation de présélection pour vérifier votre éligibilité.
  • Respecter les exigences concernant l'utilisation des données et accepter de se soumettre à des audits de données périodiques.
  • Signez un contrat de licence de données qui applique légalement les exigences d'utilisation des données.
  • Acceptez 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 méthode GenerateCreatorInsights. Cette méthode est limitée à cinq requêtes par seconde (RPS). Il 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 des 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 obtenir des attributs, comme KNOWLEDGE_GRAPH pour les thèmes d'intérêt.

    Depuis la version 23 de l'API Google Ads, 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.

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

    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 contiendrait les attributs d'entité Knowledge Graph pour "Soins de la peau" et "Soins des cheveux", et le deuxième groupe contiendrait 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 association avec audience_combinations.

  2. Insights sur les centres d'intérêt des créateurs : fournissez une liste de thèmes de contenu à l'aide du champ search_topics. L'API renvoie les créateurs pertinents qui publient 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 qu'un seul pays.

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

    Remarque : L'option search_brand est obsolète à partir de la version 24.2 et sera entièrement supprimée dans la version 25. Les utilisateurs doivent passer à l'utilisation de search_topics à la place.

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

Données supplémentaires et créateurs locaux

Par défaut, seules les données sur les insights clés 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 tagué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 concernant la découverte de créateurs locaux :

  • Définition : les créateurs locaux sont ceux qui sont basés dans le pays sélectionné ou qui publient des contenus depuis ce pays, et qui sont regardés dans ce pays.
  • Contrainte : La découverte de créateurs locaux n'est pas prise en charge 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 de 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 principaux.
  • local_creator_insights : liste d'objets YouTubeCreatorInsights pour les créateurs locaux. Cette valeur n'est renseignée 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 sur les créateurs
  • Liste des insights sur les chaînes YouTube

L'objet YouTubeMetrics contient les métriques suivantes :

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

Pour savoir 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 sur 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 canal
  • Langues associées au contenu de la chaîne
  • Score de pertinence (pour les recherches de tendances thématiques uniquement)

Pour générer des insights sur les tendances, envoyez une requête à la méthode GenerateTrendingInsights. Cette méthode est limitée à cinq requêtes par seconde (RPS). Il accepte deux types d'entrées selon que vous souhaitez obtenir des tendances d'audience ou des tendances de thèmes. 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 la variation 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 obtenir des attributs, comme KNOWLEDGE_GRAPH pour les thèmes d'intérêt.

    Les attributs KNOWLEDGE_GRAPH comportent un ou plusieurs tags InsightsKnowledgeGraphEntityCapabilities. Les attributs acceptés pour les insights sur les tendances comporteront des tags pertinents dans les 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 une procédure de liste d'autorisation indépendante.

    Vous trouverez d'autres informations sur ListAudienceInsightsAttributes dans le guide sur les insights sur l'audience.

  2. 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 le pourcentage de variation 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 la méthode ListAudienceInsightsAttributes, en fournissant les dimensions pour lesquelles vous souhaitez obtenir des attributs, comme KNOWLEDGE_GRAPH pour les thèmes d'intérêt.

    Depuis la version 23 de l'API Google Ads, 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.

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

    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 contiendrait les attributs d'entité Knowledge Graph pour "Soins de la peau" et "Soins des cheveux", et le deuxième groupe contiendrait 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 association avec audience_combinations.

  3. Tendances des thèmes : 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 la variation 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 demande de tendances utilise search_topics, le champ related_local_creators des objets TrendInsight renvoyés sera renseigné 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, l'incompatibilité avec sub_country_locations).

Précédent
Insights sur l'audience