AudienceInsightsService permet aux utilisateurs d'intégrer les données Google sur les insights d'audience dans leurs outils propriétaires. Ces données permettent aux agences média et aux média-planners de mieux comprendre leur audience cible, y compris ses données démographiques, ses centres d'intérêt et son comportement en ligne.
Les insights sur l'audience permettent aux utilisateurs de comprendre rapidement une audience, une catégorie, un thème ou une marque grâce à un aperçu général. En analysant le comportement des utilisateurs sur des thèmes similaires, les clients peuvent utiliser ces insights sur l'audience pour mettre en lumière les associations et les perceptions des consommateurs, et obtenir ainsi de nouveaux insights sur leurs audiences.
L'API a trois principaux cas d'utilisation :
Affiner et découvrir des audiences : comprendre les centres d'intérêt et les comportements uniques des consommateurs pour identifier de nouvelles audiences pour la marque, développer des personas d'audience et affiner les stratégies de segmentation d'audience.
Planifier les campagnes : traduisez les données de sortie en audiences cibles YouTube pour planifier vos campagnes. Permet aux clients d'identifier la couverture potentielle de leurs audiences cibles pour les aider à planifier leurs campagnes média. Permet aux clients de mesurer le chevauchement entre les segments d'audience pour maximiser la couverture potentielle de leurs campagnes.
Développez des messages créatifs : adaptez vos messages créatifs à votre audience cible après avoir identifié ce qui l'intéresse le plus.
Critères d'éligibilité
Pour être éligibles à AudienceInsightsService, les partenaires doivent remplir les conditions suivantes :
- Vous disposez déjà d'un accès à Insights Finder ou vous y êtes éligible.
- Disposer d'un outil de planification ou d'une interface utilisateur qui intégrera l'API.
- Utilisez l'API à des fins de planification média ou pour d'autres cas d'utilisation pertinents.
- Effectuez une évaluation préalable.
- 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 la composition de l'audience
La méthode generateAudienceCompositionInsights renvoie un GenerateAudienceCompositionInsightsResponse, qui contient une liste d'attributs représentant l'audience d'intérêt demandée, avec des métriques qui comparent la part de chaque attribut dans l'audience à sa part dans une audience de référence.
Vous devez indiquer un pays cible pour l'audience. La liste des dimensions compatibles pour récupérer des insights sur la composition est énumérée dans la description du champ dimensions de GenerateAudienceCompositionInsightsRequest.
Cette méthode peut vous aider à répondre à des questions telles que "Quelles sont les principales affinités de mon audience cible par rapport à la population générale ? Dans quelle mesure est-elle plus susceptible de s'intéresser à ces affinités par rapport à la population générale ?"
Générer des insights sur le chevauchement d'audience
La méthode generateAudienceOverlapInsights renvoie un GenerateAudienceOverlapInsightsResponse qui contient une liste d'attributs d'audience avec des estimations du chevauchement entre leur couverture YouTube potentielle et celle d'un attribut principal donné.
Vous devez indiquer un pays cible et un attribut principal. Les tranches d'âge, le genre, les segments d'affinité et les segments sur le marché sont acceptés comme dimensions d'audience.
Cette méthode peut vous aider à répondre à des questions telles que "Quelle est la taille incrémentielle de l'audience lorsque nous ciblons à la fois les fans de sport et les amateurs de musique aux États-Unis ?".
Générer une définition d'audience
La méthode generateAudienceDefinition renvoie des suggestions d'attributs d'audience en fonction d'une description d'audience.
Générer un rapport sur l'outil de recherche d'insights
La méthode generateInsightsFinderReport crée un rapport enregistré dans Insights Finder en fonction des entrées fournies dans GenerateInsightsFinderReportRequest et renvoie un GenerateInsightsFinderReportResponse contenant un lien accessible en externe pour ouvrir ce rapport dans l'interface utilisateur Insights Finder.
Générer des insights de ciblage suggérés
La méthode generateSuggestedTargetingInsights renvoie une collection d'insights de ciblage (par exemple, des audiences ciblables) qui sont pertinents pour l'audience demandée.
L'audience demandée peut être au format structuré InsightsAudienceDefinition ou sous forme de description textuelle InsightsAudienceDescription.
La méthode generateAudienceCompositionInsights renvoie des insights pour les segments d'attributs individuels pertinents, tandis que generateSuggestedTargetingInsights renvoie des suggestions et des insights sur les segments d'audience Google ciblables.
Cette méthode permet de répondre à des questions telles que "Donne-moi des suggestions d'audiences cibles pour les pères trentenaires qui aiment la pêche".
Générer des métriques de suggestions de ciblage
La méthode generateTargetingSuggestionMetrics renvoie un GenerateTargetingSuggestionMetricsResponse , qui contient la population YouTube potentielle pouvant être touchée pour chaque définition d'audience demandée dans GenerateTargetingSuggestionMetricsRequest.
Cette méthode peut vous aider à répondre à des questions telles que "Combien d'hommes de plus de 18 ans intéressés par le camping aux États-Unis puis-je toucher sur YouTube ?".
Lister les attributs des insights sur l'audience
La méthode listAudienceInsightsAttributes renvoie un ListAudienceInsightsAttributesResponse contenant la liste des attributs disponibles pour les dimensions demandées.
Par exemple, si "Affinité" est sélectionnée comme dimension dans la demande, une liste des audiences d'affinité acceptées est renvoyée (par exemple, "fans de sport" ou "amateurs de musique"). Les dimensions "Sur le marché" et "Événement de la vie" sont également acceptées. Vous pouvez définir plusieurs dimensions pour une même demande. Pour obtenir la liste complète des dimensions compatibles, consultez la documentation de référence.
Lorsque vous recherchez des entités Knowledge Graph (thèmes) à l'aide de la dimension KNOWLEDGE_GRAPH, vous devez fournir une chaîne de requête dans le champ query_text (par exemple, "football and the World Cup").
Vous pouvez également inclure knowledge_graph_entity_search_options pour personnaliser votre recherche de thèmes :
- Filtrer par fonctionnalités : utilisez search_filter pour limiter les entités récupérées à celles qui prennent en charge des fonctionnalités spécifiques. Par exemple, vous pouvez filtrer les thèmes acceptés en tant qu'attributs de créateur en fournissant CREATOR_ATTRIBUTE dans le champ entity_capability_filters. Vous pouvez fournir plusieurs fonctionnalités, qui sont combinées avec la logique
OR. - Récupérer tous les attributs de créateur : définissez get_all_creator_attributes sur
truepour obtenir un dump complet de toutes les entités Knowledge Graph disponibles taguées comme attributs de créateur. Notez que lorsque vous utilisez cette option, la dimensionKNOWLEDGE_GRAPHdoit être sélectionnée, la requêtequery_textdoit être vide et vous ne pouvez pas combiner cette option avec unsearch_filter.
Les attributs renvoyés par cette fonctionnalité de détectabilité peuvent être utilisés comme entrées pour d'autres fonctionnalités AudienceInsightsService.
Lister les dates éligibles aux insights
La méthode listInsightsEligibleDates renvoie un ListInsightsEligibleDatesResponse, qui contient une liste de mois au format "AAAA-MM" pour lesquels des données sur les insights d'audience sont disponibles.
La réponse contient également les dates réelles représentant les "30 derniers jours" qui seront utilisées pour la méthode generateAudienceCompositionInsights lorsque date_month n'est pas défini dans la requête.