> [!CAUTION]
> **Caution:** This documentation is for Google Ads API **v24** . The latest active version is [**v26**](https://developers.google.com/google-ads/api/reference/rpc/latest/GenerateAudienceCompositionInsightsRequest).

Request message for `AudienceInsightsService.GenerateAudienceCompositionInsights`.

[Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v24/services/audience_insights_service.proto)

| Fields ||
|---|---|
| ## `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. |
| ## `customer_id` | `string` Required. The ID of the customer. |
| ## `customer_insights_group` | `string` The name of the customer being planned for. This is a user-defined value. |
| ## `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, LIFE_EVENT_USER_INTEREST, PARENTAL_STATUS, INCOME_RANGE, AGE_RANGE, GENDER, and USER_LIST. Note that when an `InsightsAudience.user_list` is requested: - Only the following dimensions are supported: AFFINITY_USER_INTEREST, AGE_RANGE, GENDER, IN_MARKET_USER_INTEREST - The score field is omitted from AudienceCompositionMetrics of the GenerateAudienceCompositionInsightsResponse. Note: The USER_LIST dimension does not support the score metric in AudienceCompositionMetrics. |
| ## `insights_application_info` | `AdditionalApplicationInfo` Optional. Additional information on the application issuing the request. |