InsightsAudience

A set of users, defined by various characteristics, for which insights can be requested in AudienceInsightsService.

Proto definition GitHub

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:

  1. Attributes within each InsightsAudienceAttributeGroup are combined with OR.

  2. 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.