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 les créateurs les plus populaires pour un ensemble donné de thèmes, de données démographiques, d'audiences ou d'attributs de créateurs.
  2. Insights sur les marques de créateurs : récupérez des insights sur les créateurs associés à une marque spécifique.
  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.

Critères d'éligibilité

ContentCreatorInsightsService.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 préliminaire 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 ContentCreatorInsightsService.GenerateCreatorInsights. Cette méthode est limitée à cinq requêtes par seconde (QPS) et accepte trois types d'entrées selon que vous souhaitez améliorer la visibilité des créateurs, obtenir des insights sur les marques de créateurs 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 AudienceInsightsService.ListAudienceInsightsAttributes en fournissant les dimensions pour lesquelles vous souhaitez obtenir des attributs, comme KNOWLEDGE_GRAPH pour les thèmes d'intérêt.

    À partir de 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" OU "voyages" OU …, 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 pour la peau", "Soins pour les 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 second 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 marques de créateurs : indiquez une marque pour rechercher les principaux créateurs. L'API renvoie des insights sur les chaînes correspondantes.

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

La méthode generateCreatorInsights renvoie un objet GenerateCreatorInsightsResponse. Cet objet contient une liste d'objets YouTubeCreatorInsights. 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)

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 (âge, genre et centres d'intérêt des utilisateurs, par exemple)

    répartition)

  • 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 ContentCreatorInsightsService.GenerateTrendingInsights. Cette méthode est limitée à cinq requêtes par seconde (RPS) et 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 AudienceInsightsService.ListAudienceInsightsAttributes en fournissant les dimensions pour lesquelles vous souhaitez obtenir des attributs, comme KNOWLEDGE_GRAPH pour les thèmes d'intérêt.

    À partir de 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" OU "voyages" OU …, 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 pour la peau", "Soins pour les 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 second 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. 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.

Précédent
Insights sur l'audience