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 :
- Découverte de créateurs : trouvez les meilleurs créateurs pour un ensemble donné de thèmes, de données démographiques, d'audiences ou d'attributs de créateurs.
- Insights sur les marques de créateurs : récupérez des insights sur les créateurs associés à une marque spécifique.
- 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.
- Insights sur les tendances : récupérez 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.
- Utiliser l'API pour explorer les contenus et les créateurs YouTube afin d'identifier des opportunités publicitaires potentielles.
- Réussir 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 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
ContentCreatorInsightsService.GenerateCreatorInsights
méthode. Cette méthode est limitée à cinq requêtes par seconde (RPS) et accepte trois types d'entrées selon que vous souhaitez découvrir des créateurs, obtenir des insights sur les marques de créateurs ou obtenir des insights sur les créateurs. Vous devez fournir les pays à partir desquels vous souhaitez obtenir des données.
- Découverte de créateurs : vous pouvez fournir une liste d'attributs d'audience, tels que l'âge, le sexe et les centres d'intérêt (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éateurs pour filtrer les créateurs dont le contenu correspond spécifiquement aux attributs de créateurs que vous avez saisis.
- Insights sur les marques de créateurs : fournissez une marque pour rechercher les meilleurs créateurs. L'API renvoie des insights sur les chaînes correspondantes.
- Insights sur les créateurs : fournissez une liste d'ID de chaînes YouTube. L'API renvoie des insights sur ces chaînes 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 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_2)
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 sexe 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)
Générer des insights sur les tendances
Pour générer des insights sur les tendances, envoyez une requête à la
ContentCreatorInsightsService.GenerateTrendingInsights
méthode. 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 par thème.
Vous devez fournir le pays spécifique à partir duquel vous souhaitez obtenir des tendances.
- Tendances d'audience : vous pouvez fournir une liste d'attributs d'audience, tels que l'âge, le sexe et les centres d'intérêt (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.
- 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 la variation en pourcentage de la valeur de la tendance au cours de la période de comparaison.