- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- AudienceCompositionSection
- AudienceCompositionAttribute
- AudienceCompositionMetrics
- AudienceCompositionAttributeCluster
- Essayer
Renvoie un ensemble d'attributs représentés dans une audience qui vous intéresse, avec des métriques qui comparent la part d'audience pour chaque attribut à sa part dans une audience de référence.
Liste des erreurs générées: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
Requête HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateAudienceCompositionInsights
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
customerId |
Obligatoire. ID du client. |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "audience": { object ( |
Champs | |
---|---|
audience |
Obligatoire. Audience qui vous intéresse pour laquelle des insights sont demandés. |
baselineAudience |
Audience de référence à laquelle l'audience qui vous intéresse est comparée. |
dataMonth |
Plage d'un mois de données historiques à utiliser pour les insights, au format "aaaa-mm". Si cette règle n'est pas configurée, les insights sur les données des 30 derniers jours s'affichent. |
dimensions[] |
Obligatoire. Dimensions de l'audience pour lesquelles des insights sur la composition doivent être renvoyés. |
customerInsightsGroup |
Nom du client pour lequel effectuer la planification. Cette valeur est définie par l'utilisateur. |
Corps de la réponse
Message de réponse pour AudienceInsightsService.GenerateAudienceCompositionInsights
.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"sections": [
{
object ( |
Champs | |
---|---|
sections[] |
Contenu du rapport "Insights", organisé en sections. Chaque section est associée à l'une des valeurs "AudienceInsightsDimension" dans la demande. Chaque dimension peut comporter plusieurs sections. |
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/adwords
Pour en savoir plus, consultez la présentation d'OAuth 2.0.
AudienceCompositionSection
Ensemble d'attributs associés du même type dans un rapport d'insights sur la composition de l'audience.
Représentation JSON |
---|
{ "dimension": enum ( |
Champs | |
---|---|
dimension |
Type des attributs dans cette section. |
topAttributes[] |
Segments les plus pertinents pour cette audience Si la dimension est "GENDER", "AGE_RANGE" ou "PARENTAL_STATUS", cette liste d'attributs est exhaustive. |
clusteredAttributes[] |
Attributs supplémentaires pour cette audience, regroupés en clusters. Renseignée uniquement si la dimension est YOUTUBE_CHANNEL |
AudienceCompositionAttribute
Attribut d'audience avec des métadonnées et des métriques.
Représentation JSON |
---|
{ "attributeMetadata": { object ( |
Champs | |
---|---|
attributeMetadata |
L'attribut et ses métadonnées. |
metrics |
Métriques de part et d'index pour l'attribut. |
AudienceCompositionMetrics
Métriques de part et d'index associées à un attribut dans un rapport d'insights sur la composition de l'audience.
Représentation JSON |
---|
{ "baselineAudienceShare": number, "audienceShare": number, "index": number, "score": number } |
Champs | |
---|---|
baselineAudienceShare |
Fraction (de 0 à 1 inclus) de l'audience de référence correspondant à l'attribut. |
audienceShare |
Fraction (de 0 à 1 inclus) de l'audience spécifique correspondant à l'attribut. |
index |
Il s'agit du ratio entre la part d'audience et la part de référence de l'audience, ou zéro si ce ratio n'est pas défini ou n'est pas significatif. |
score |
Score de pertinence compris entre 0 et 1. |
AudienceCompositionAttributeCluster
Ensemble d'attributs associés, avec des métadonnées et des métriques, dans un rapport d'insights sur la composition de l'audience.
Représentation JSON |
---|
{ "clusterDisplayName": string, "clusterMetrics": { object ( |
Champs | |
---|---|
clusterDisplayName |
Nom de ce cluster d'attributs |
clusterMetrics |
Si la dimension associée à ce cluster est YOUTUBE_CHANNEL, alors clusterMetrics correspond à des métriques associées au cluster dans son ensemble. Pour les autres dimensions, ce champ n'est pas défini. |
attributes[] |
Attributs individuels qui composent ce cluster, avec les métadonnées et les métriques. |