Toutes les requêtes adressées à AudienceInsightsService sont limitées en débit. Moins de requêtes sont autorisées par jour pour generateAudienceCompositionInsights et generateSuggestedTargetingInsights que pour les autres méthodes d'insights sur l'audience. Pour en savoir plus, consultez Quotas d'API.
AudienceInsightsService vous permet d'intégrer les données des insights sur l'audience Google dans vos outils de planification. Les données aident les agences média et les média-planners à 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 vous permettent de comprendre 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, vous pouvez utiliser ces insights sur l'audience pour mettre en lumière certaines associations et perceptions des consommateurs, et identifier de nouveaux segments d'audience.
L'API prend en charge trois cas d'utilisation principaux :
- 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 une marque, développer des personas d'audience et affiner les stratégies de segmentation d'audience.
- Élaborer la planification de vos campagnes : transformez les données en audiences cibles YouTube pour planifier vos campagnes, estimer la couverture potentielle des audiences ciblées et mesurer le chevauchement entre les segments d'audience afin de maximiser la couverture de vos campagnes.
- Développez des messages créatifs : adaptez les messages créatifs à votre audience cible en fonction des thèmes et des affinités avec lesquels elle interagit le plus.
Critères d'éligibilité
Pour être éligibles à AudienceInsightsService, les partenaires doivent remplir les conditions suivantes :
- Vous devez disposer d'un accès à Insights Finder ou y être éligible.
- Disposer d'un outil de planification ou d'une interface utilisateur qui intègre l'API.
- Utilisez l'API pour la planification média ou d'autres cas d'utilisation pertinents.
- Effectuez une évaluation préalable.
- Respecter les exigences d'utilisation des données et se soumettre à des audits de données périodiques
- Acceptez les Conditions d'utilisation de l'API Google Ads et les règles d'utilisation des données associées.
Pour plus d'informations, contactez votre représentant Google.
Répertorier les dates éligibles aux insights
Un workflow standard commence par vérifier quels mois calendaires et quelles périodes sont disponibles pour l'analyse. La méthode listInsightsEligibleDates renvoie un ListInsightsEligibleDatesResponse, dont le champ data_months liste les mois (au format YYYY-MM) pour lesquels des données d'insights sur l'audience sont disponibles.
Le champ last_thirty_days de la réponse contient la plage de dates exacte utilisée par generateAudienceCompositionInsights lorsque data_month n'est pas défini dans la requête.
Lister les attributs des insights sur l'audience
Avant d'interroger les métriques de composition ou de chevauchement d'audience, découvrez les ID d'attributs valides à l'aide de listAudienceInsightsAttributes. Cette méthode renvoie un ListAudienceInsightsAttributesResponse contenant les attributs disponibles pour les dimensions demandées.
Par exemple, si AFFINITY_USER_INTEREST est sélectionné comme dimension dans la requête, la méthode renvoie les audiences d'affinité compatibles, telles que "Fans de sport" ou "Amateurs de musique". Les autres dimensions d'intérêt de l'utilisateur compatibles incluent IN_MARKET_USER_INTEREST et LIFE_EVENT_USER_INTEREST. Vous pouvez définir plusieurs dimensions dans une même requête. Pour obtenir la liste complète des dimensions acceptées, consultez la documentation de référence sur les champs dimensions.
Lorsque vous recherchez des entités Knowledge Graph (thèmes) à l'aide de la dimension KNOWLEDGE_GRAPH, vous devez fournir une requête de chaîne dans le champ query_text (par exemple, "football and the World Cup").
Vous pouvez éventuellement inclure knowledge_graph_entity_search_options pour personnaliser votre recherche de sujet :
- Filtrer par fonctionnalités : utilisez
search_filterpour 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 acceptés en tant qu'attributs de créateur en fournissantCREATOR_ATTRIBUTEdans le champentity_capability_filters. Plusieurs fonctionnalités peuvent être fournies et sont combinées avec la logiqueOR. - Récupérer tous les attributs de créateur : définissez
get_all_creator_attributessurtruepour récupérer toutes les entités Knowledge Graph disponibles taguées en tant qu'attributs de créateur. Lorsque vous utilisez cette option, la dimensionKNOWLEDGE_GRAPHdoit être sélectionnée,query_textdoit être vide et vous ne pouvez pas combiner cette option avec unsearch_filter.
Les attributs renvoyés par cette méthode de visibilité peuvent être utilisés comme entrées pour d'autres méthodes AudienceInsightsService.
Chaque objet AudienceInsightsAttributeMetadata 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, son nom à afficher, son type de dimension et sa couverture d'audience estimée. Pour en savoir plus sur les définitions des champs, consultez la documentation de référence sur AudienceInsightsAttributeMetadata.
Générer une définition d'audience
La méthode generateAudienceDefinition traduit une description textuelle libre d'une audience en suggestions d'attributs d'audience structurés que vous pouvez transmettre aux méthodes d'insights en aval.
Générer des insights de ciblage suggérés
La méthode generateSuggestedTargetingInsights renvoie une collection d'insights sur le ciblage (comme les segments d'audience ciblables) pertinents pour l'audience demandée.
Vous pouvez spécifier l'audience demandée sous la forme d'un InsightsAudienceDefinition structuré ou d'une description textuelle dans InsightsAudienceDescription.
Alors que generateAudienceCompositionInsights renvoie des insights pour des segments d'attributs individuels, generateSuggestedTargetingInsights renvoie des suggestions groupées de segments d'audience Google Ads pouvant être ciblés. Cette méthode permet de répondre à des questions telles que "Donne-moi des suggestions d'audience ciblable pour les pères d'une trentaine d'années 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 permet de répondre à des questions telles que "Combien d'hommes de plus de 18 ans intéressés par le camping aux États-Unis peut-on toucher sur YouTube ?".
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, ainsi que des métriques d'index et de part qui comparent la part de l'audience de chaque attribut à une population 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 documentée dans le champ dimensions de GenerateAudienceCompositionInsightsRequest.
Cette méthode permet de répondre à des questions telles que "Quelles sont les principales affinités qui intéressent mon audience cible par rapport à la population globale, et quelle est la probabilité qu'elle s'engage avec ces affinités ?"
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 potentielle sur YouTube et celle d'un attribut principal.
Vous devez indiquer un pays cible et un attribut principal. La tranche d'âge, le genre, les segments d'affinité et les segments sur le marché sont acceptés en tant que dimensions d'audience.
Cette méthode permet de 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 amateurs de musique aux États-Unis ?".
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 GenerateInsightsFinderReportRequest et renvoie un GenerateInsightsFinderReportResponse contenant un lien accessible en externe pour ouvrir ce rapport dans l'interface utilisateur d'Insights Finder.
Issue Tracker Google
Utilisez Google Issue Tracker pour poser des questions à l'assistance, signaler des bugs ou envoyer des demandes de fonctionnalités. Google suit, hiérarchise et publie des mises à jour sur vos demandes directement dans Issue Tracker. Pour en savoir plus, consultez Créer un problème dans l'outil Issue Tracker de Google.
Créez un problème à l'aide de l'un des modèles Issue Tracker suivants :
- Poser une question d'ordre général à l'assistance ou envoyer des commentaires sur la documentation
- Signaler un bug technique
- Envoyer une demande de fonctionnalité d'API
Remplissez tous les champs du modèle avec des informations détaillées afin que Google puisse reproduire et hiérarchiser votre demande. Google peut clôturer les rapports incomplets et vous demander d'envoyer un nouveau problème avec les informations manquantes.