GenerateAudienceCompositionInsightsRequest
Stay organized with collections
Save and categorize content based on your preferences.
| Fields |
customer_id
|
string
Required. The ID of the customer.
|
audience
|
InsightsAudience
Required. The audience of interest for which insights are being requested.
|
baseline_audience
|
InsightsAudience
The baseline audience to which the audience of interest is being compared.
|
data_month
|
string
The one-month range of historical data to use for insights, in the format "yyyy-mm". If unset, insights will be returned for the last thirty days of data.
|
dimensions[]
|
AudienceInsightsDimension
Required. The audience dimensions for which composition insights should be returned. Supported dimensions are KNOWLEDGE_GRAPH, GEO_TARGET_COUNTRY, SUB_COUNTRY_LOCATION, YOUTUBE_CHANNEL, YOUTUBE_LINEUP, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, PARENTAL_STATUS, INCOME_RANGE, AGE_RANGE, and GENDER.
|
customer_insights_group
|
string
The name of the customer being planned for. This is a user-defined value.
|
insights_application_info
|
AdditionalApplicationInfo
Optional. Additional information on the application issuing the request.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-07 UTC.
[null,null,["Last updated 2025-08-07 UTC."],[],[],null,["# GenerateAudienceCompositionInsightsRequest\n\nRequest message for [AudienceInsightsService.GenerateAudienceCompositionInsights](/google-ads/api/reference/rpc/v20/AudienceInsightsService/GenerateAudienceCompositionInsights).\n\n| Fields ||\n|---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `customer_id` | `string` Required. The ID of the customer. |\n| ### `audience` | [InsightsAudience](/google-ads/api/reference/rpc/v20/InsightsAudience) Required. The audience of interest for which insights are being requested. |\n| ### `baseline_audience` | [InsightsAudience](/google-ads/api/reference/rpc/v20/InsightsAudience) The baseline audience to which the audience of interest is being compared. |\n| ### `data_month` | `string` The one-month range of historical data to use for insights, in the format \"yyyy-mm\". If unset, insights will be returned for the last thirty days of data. |\n| ### `dimensions[]` | [AudienceInsightsDimension](/google-ads/api/reference/rpc/v20/AudienceInsightsDimensionEnum.AudienceInsightsDimension) Required. The audience dimensions for which composition insights should be returned. Supported dimensions are KNOWLEDGE_GRAPH, GEO_TARGET_COUNTRY, SUB_COUNTRY_LOCATION, YOUTUBE_CHANNEL, YOUTUBE_LINEUP, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, PARENTAL_STATUS, INCOME_RANGE, AGE_RANGE, and GENDER. |\n| ### `customer_insights_group` | `string` The name of the customer being planned for. This is a user-defined value. |\n| ### `insights_application_info` | [AdditionalApplicationInfo](/google-ads/api/reference/rpc/v20/AdditionalApplicationInfo) Optional. Additional information on the application issuing the request. |"]]
