Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on April 23rd at 10:00 AM EST! We will discuss the new features added in v24 of the Google Ads API.
InsightsAudience
Stay organized with collections
Save and categorize content based on your preferences.
A set of users, defined by various characteristics, for which insights can be requested in AudienceInsightsService.
Proto definition 
| Fields |
age_ranges[]
|
AgeRangeInfo
Age ranges for the audience. If absent, the audience represents all people over 18 that match the other attributes.
|
country_locations[]
|
LocationInfo
Required. The countries for the audience.
|
gender
|
GenderInfo
Gender for the audience. If absent, the audience does not restrict by gender.
|
income_ranges[]
|
IncomeRangeInfo
Household income percentile ranges for the audience. If absent, the audience does not restrict by household income range.
|
lineups[]
|
AudienceInsightsLineup
Lineups representing the YouTube content viewed by the audience.
|
parental_status
|
ParentalStatusInfo
Parental status for the audience. If absent, the audience does not restrict by parental status.
|
sub_country_locations[]
|
LocationInfo
Sub-country geographic location attributes. If present, each of these must be contained in one of the countries in this audience. If absent, the audience is geographically to the country_locations and no further.
|
topic_audience_combinations[]
|
InsightsAudienceAttributeGroup
A list of audience attribute groups consisting of one or more Knowledge Graph entities, Product & Service Categories and user interests that describe an audience. The groups have a logical AND-of-ORs structure:
Attributes within each InsightsAudienceAttributeGroup are combined with OR.
The groups themselves are combined together with AND.
For example, an audience (Interest A OR Interest B) AND (Entity C) is represented using two groups. The first group contains the two interests and the second group contains the entity.
|
user_list
|
UserListInfo
User list to be targeted by the audience.
|
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 2026-04-17 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-04-17 UTC."],[],[]]