AudienceInsightsService permet aux utilisateurs d'intégrer les données d'insights sur l'audience Google dans leurs outils propriétaires. Ces données permettent aux agences média et aux planificateurs média de mieux comprendre leur audience cible, y compris ses caractéristiques 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 sujet 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 statistiques sur l'audience pour mettre en lumière certaines associations et perceptions des consommateurs, et obtenir ainsi de nouveaux insights sur leurs audiences.
L'API présente trois principaux cas d'utilisation :
Affiner et découvrir des audiences : comprenez 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 de l'audience.
Informer la planification des campagnes : traduisez les résultats des données 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 afin de maximiser la couverture potentielle de leurs campagnes.
Développer des messages créatifs : adaptez les messages créatifs à votre audience cible après avoir découvert ce qui lui tient le plus à cœur.
Critères d'éligibilité
Pour être éligibles à AudienceInsightsService, les partenaires doivent remplir les
conditions suivantes :
- Avoir déjà accès à Insights Finder ou être éligibles à cet accès.
- Disposer d'un outil de planification ou d'une interface utilisateur qui intégrera l'API.
- Utiliser l'API à des fins de planification média ou pour d'autres cas d'utilisation pertinents.
- Réussir une évaluation de présélection.
- 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 applique 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 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.
audience.
Vous devez fournir un pays cible pour l'audience. La liste des dimensions compatibles pour la récupération des insights sur la composition est énumérée dans la description du dimensions
champ 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 et dans quelle mesure est-elle plus susceptible d'être intéressée par ces affinités par rapport à la population générale ?"
Générer des insights sur le chevauchement de l'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 fournir un pays cible et un attribut principal. Les tranches d'âge, le sexe, les segments d'affinité et les segments sur le marché sont compatibles en tant que dimensions d'audience.
Cette méthode peut vous aider à répondre à des questions telles que "Quelle est la taille de l'audience incrémentale lorsque nous ciblons à la fois les fans de sport et les mélomanes 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 de l'audience.
Générer un rapport Insights Finder
La méthode generateInsightsFinderReport crée un rapport enregistré dans
Insights Finder en fonction des entrées spécifiées dans le
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 sur le ciblage suggéré
La méthode generateSuggestedTargetingInsights renvoie une collection d'
insights sur le ciblage (par exemple, des audiences ciblables) qui sont pertinents pour l'audience demandée
.
L'audience demandée peut se présenter sous la forme d'un format structuré
InsightsAudienceDefinition ou d'une 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 vous aide à répondre à des questions telles que "Donnez-moi des suggestions d'audience ciblable pour les pères trentenaires qui aiment pêcher".
Générer des métriques de suggestion de ciblage
La méthode generateTargetingSuggestionMetrics renvoie un
GenerateTargetingSuggestionMetricsResponse , qui contient la
population YouTube potentielle qui peut être atteinte 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 18 ans et plus intéressés par le camping aux États-Unis peuvent être atteints sur YouTube ?"
Lister les attributs d'insights sur l'audience
La méthode listAudienceInsightsAttributes renvoie un
ListAudienceInsightsAttributesResponse qui contient la liste des
attributs disponibles pour les dimensions demandées.
Par exemple, si "Affinité" est sélectionné comme dimension dans la requête, une liste d'audiences d'affinité compatibles s'affiche, telles que "fans de sport" ou "mélomanes". Les autres dimensions d'intérêt utilisateur compatibles incluent "Sur le marché" et "Événement de la vie". Vous pouvez définir plusieurs dimensions pour une seule requête. 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
KNOWLEDGE_GRAPH dimension, vous devez fournir une requête de chaîne dans le
query_text champ (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 sont compatibles avec des fonctionnalités spécifiques. Par
exemple, vous pouvez filtrer les thèmes compatibles 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 vidage complet de toutes les entités Knowledge Graph disponibles taguées en tant qu'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étection peuvent être utilisés comme entrées
pour d'autres AudienceInsightsService fonctionnalités.
Chaque AudienceInsightsAttributeMetadata
objet renvoyé dans ListAudienceInsightsAttributesResponse fournit une
représentation structurée d'un attribut d'audience, ainsi que des propriétés descriptives
et des métriques d'engagement. Il inclut la définition principale de l'attribut, des informations d'affichage conviviales, le type de dimension et la couverture d'audience estimée. Pour obtenir des définitions plus détaillées de chaque champ disponible, consultez
la AudienceInsightsAttributeMetadata documentation
de référence.
Lister les dates éligibles pour les insights
La méthode listInsightsEligibleDates renvoie un
ListInsightsEligibleDatesResponse, qui contient une liste de mois au
format "AAAA-MM" pour lesquels des données d'insights sur l'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 le
date_month n'est pas défini dans la requête.