Découvrez et récupérez des insights sur les créatrices et 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 a quatre fonctions principales:
- Visibilité des 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éateur.
- 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:obtenez des insights sur des chaînes YouTube spécifiques, comme leur nombre d'abonnés, le nombre de vues et les données démographiques de leur audience.
- Insights sur les 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 libre de droits. Les partenaires signés peuvent utiliser les bibliothèques clientes Google Ads standards pour découvrir 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 ;
- Utilisez l'API pour explorer les contenus et les créateurs YouTube afin d'identifier des opportunités publicitaires potentielles.
- Effectuez une évaluation préalable pour vous assurer de votre éligibilité.
- Respectez les exigences d'utilisation des données et soyez prêt à subir 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 pour 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 des créateurs ou obtenir des insights sur les créateurs. Vous devez indiquer les pays à partir desquels vous souhaitez obtenir des données.
- Visibilité 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. 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.
- Insights sur les marques de créateurs:indiquez une marque pour rechercher les meilleurs créateurs. L'API renvoie des insights sur les chaînes correspondantes.
- Insights pour 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 globales des 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
- est un créateur de Shorts actif ;
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 répartition des centres d'intérêt des utilisateurs, par exemple)
- Vidéos les plus regardées
- Type de canal
Générer des insights sur les tendances
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 sujets.
Vous devez indiquer le pays spécifique pour lequel vous souhaitez obtenir des tendances.
- Tendances de l'audience:vous pouvez fournir une liste d'attributs d'audience, tels que l'âge, le genre et les centres d'intérêt. L'API renvoie une liste d'insights tendances pour ces audiences.
- Tendances des sujets:fournissez une liste des sujets de contenu. L'API renvoie une liste d'insights sur les tendances pour ces sujets.